快速部署

LitePan 采用本地化数据存储，不依赖第三方云端数据库。推荐使用 Docker 部署，方便迁移、备份和后续升级。

Deploy LitePan

几分钟启动一个自己的网盘聚合服务

只需要映射数据、日志、STRM 和插件目录，后续迁移时保留这些目录即可。

推荐方式Docker Compose

默认端口5211

核心数据data / log / strm / plugins

Docker Compose 部署

推荐

创建一个新目录，并在其中新建 docker-compose.yml 文件。

version: '3.8'

services:
  litepan:
    image: ponphil/litepan:latest
    container_name: litepan
    restart: unless-stopped
    network_mode: host
    environment:
      TZ: Asia/Shanghai
    volumes:
      - ./data:/app/data
      - ./log:/app/log
      - ./strm:/app/strm
      - ./plugins:/app/plugins

使用 network_mode: host 后，LitePan 主端口 5211 和后台填写的 Emby 反代端口都会直接监听宿主机端口，适合飞牛、群晖、威联通、Linux 服务器等部署场景。

如果不能使用 host 网络模式，可以改回端口映射：

ports:
  - "5211:5211"
  # 如果在后台启用了 Emby 反代，并填写监听端口 8098，需要额外映射：
  # - "8098:8098"

在包含 docker-compose.yml 的目录下执行：

docker compose up -d

Docker 命令部署

直接运行

如果不想使用 Compose，也可以直接通过 docker run 启动。

Linux / macOS：

docker run -d \
  --name litepan \
  --restart unless-stopped \
  --network host \
  -e TZ=Asia/Shanghai \
  -v $(pwd)/data:/app/data \
  -v $(pwd)/log:/app/log \
  -v $(pwd)/strm:/app/strm \
  -v $(pwd)/plugins:/app/plugins \
  ponphil/litepan:latest

使用 --network host 后不需要写 -p 5211:5211，后台填写的 Emby 反代端口也会直接在宿主机上监听。如果不能使用 host 网络模式，可以去掉 --network host，并添加 -p 5211:5211；如果启用了 Emby 反代，还需要额外增加对应端口映射，例如 -p 8098:8098。

Windows PowerShell：

如果启用了 Emby 反代，并在后台填写监听端口 8098，启动命令还需要额外增加 -p 8098:8098。

docker run -d `
  --name litepan `
  --restart unless-stopped `
  -p 5211:5211 `
  -e TZ=Asia/Shanghai `
  -v "${PWD}\data:/app/data" `
  -v "${PWD}\log:/app/log" `
  -v "${PWD}\strm:/app/strm" `
  -v "${PWD}\plugins:/app/plugins" `
  ponphil/litepan:latest

目录说明

./dataSQLite 数据库、核心配置和程序运行数据。

./log系统运行日志，排查问题时优先查看。

./strmSTRM 媒体聚合文件输出目录。

./plugins扩展插件目录。

访问后台

启动完成

启动成功后，通过浏览器访问 http://你的服务器IP:5211 即可进入 LitePan 管理后台。

如果使用飞牛、群晖、威联通或宝塔面板中的 Docker 图形界面，可以参考上面的端口和挂载目录逐项填写。