LitePan 文档

Appearance

快速部署 ​

当前文档对应 Go 版 LitePan（公测中）。推荐使用 Docker 部署，方便迁移、备份和后续升级。

Deploy LitePan

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

映射 data、strm、mounts 目录即可起步；需要本地挂载时再补上 fuse 设备与权限。

推荐方式Docker Compose
默认端口5211
核心数据data / strm / mounts

Docker Compose 部署 ​

通用脚本: ​

推荐

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

yaml
services:
  litepan:
    image: ponphil/litepan:beta
    container_name: litepan
    restart: unless-stopped
    network_mode: host
    environment:
      - TZ=Asia/Shanghai
      # 可选镜像站
      # - TMDB_API_BASE_URL=https://api.tmdb.org/3
    volumes:
      - ./data:/app/data
      - ./strm:/app/strm
      - ./mounts:/app/mounts:shared

      # 可选：将 FUSE 读缓存单独映射到更快的磁盘
      # - ./fuse_read_cache:/app/data/fuse_read_cache
    devices:
      - /dev/fuse:/dev/fuse
    pid: "host"
    privileged: true
    # 若本机访问 TMDB 困难，可取消注释并填写可用 IP
    # extra_hosts:
    #   - "api.themoviedb.org:这里填写对应的ip"
    #   - "image.tmdb.org:这里填写对应的ip"

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

bash
docker compose up -d

飞牛NAS: ​

通过 Docker Compose 构建：

yaml
services:
  litepan:
    image: ponphil/litepan:beta
    container_name: litepan
    restart: always
    network_mode: host
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - /vol1/1000/data:/app/data
      - /vol1/1000/Strm:/app/strm
      - /vol1/1000/mounts:/app/mounts:shared
      # 可选：将 FUSE 读缓存单独映射到更快的磁盘
      # - ./fuse_read_cache:/app/data/fuse_read_cache
    devices:
      - /dev/fuse:/dev/fuse
    pid: "host"
    privileged: true
    # 若本机访问 TMDB 困难，可取消注释并填写可用 IP
    # extra_hosts:
    #   - "api.themoviedb.org:这里填写对应的ip"
    #   - "image.tmdb.org:这里填写对应的ip"

使用 host 网络时不要再写 ports:。

如果只能用桥接网络，请保留 5211:5211；启用反代后，再按后台端口追加映射（如 18096:18096）。

Docker 命令部署 ​

直接运行

如果不想使用 Compose，也可以直接通过 docker run 启动。下面先给最小命令，再说明可选参数如何追加。

最小命令（Linux / macOS，host 网络） ​

bash
docker run -d \
  --name litepan \
  --restart unless-stopped \
  --network host \
  --pid host \
  --privileged \
  --device /dev/fuse \
  -e TZ=Asia/Shanghai \
  -v "$(pwd)/data:/app/data" \
  -v "$(pwd)/strm:/app/strm" \
  -v "$(pwd)/mounts:/app/mounts:shared" \
  ponphil/litepan:beta

使用 --network host 后不需要写 -p 5211:5211，后台填写的反代端口也会直接在宿主机上监听。

桥接网络 ​

不能用 host 时，去掉 --network host，并加上端口映射：

bash
docker run -d \
  --name litepan \
  --restart unless-stopped \
  --pid host \
  --privileged \
  --device /dev/fuse \
  -p 5211:5211 \
  -e TZ=Asia/Shanghai \
  -v "$(pwd)/data:/app/data" \
  -v "$(pwd)/strm:/app/strm" \
  -v "$(pwd)/mounts:/app/mounts:shared" \
  ponphil/litepan:beta

启用 Emby / 飞牛反代时，按后台端口再追加，例如 -p 18096:18096。

可选：FUSE 读缓存单独挂载 ​

把读缓存放到更快的磁盘时，追加一行 volume（宿主机目录可自定）：

bash
  -v "$(pwd)/fuse_read_cache:/app/data/fuse_read_cache" \

容器内路径必须是 /app/data/fuse_read_cache。

可选：TMDB hosts ​

本机访问 TMDB 困难时，用 --add-host（对应 Compose 的 extra_hosts），把 IP 换成你可用的地址：

bash
  --add-host=api.themoviedb.org:这里填写对应的ip \
  --add-host=image.tmdb.org:这里填写对应的ip \

docker run 里写在镜像名前面即可，host / 桥接网络都支持。

完整示例（含缓存 + TMDB） ​

bash
docker run -d \
  --name litepan \
  --restart unless-stopped \
  --network host \
  --pid host \
  --privileged \
  --device /dev/fuse \
  --add-host=api.themoviedb.org:这里填写对应的ip \
  --add-host=image.tmdb.org:这里填写对应的ip \
  -e TZ=Asia/Shanghai \
  -v "$(pwd)/data:/app/data" \
  -v "$(pwd)/strm:/app/strm" \
  -v "$(pwd)/mounts:/app/mounts:shared" \
  -v "$(pwd)/fuse_read_cache:/app/data/fuse_read_cache" \
  ponphil/litepan:beta

不需要 TMDB 或单独缓存时，删掉对应 --add-host / -v ...fuse_read_cache 行即可。

目录说明 ​

./dataSQLite 数据库、核心配置、日志和程序运行数据。
./strmSTRM 文件与相关元数据输出目录；
./mounts本地挂载点目录；使用 :shared，宿主机需具备 /dev/fuse 权限。
fuse_read_cache可选。建议把 FUSE 读缓存放到更快磁盘。

访问后台 ​

启动完成

启动成功后，浏览器访问 http://你的服务器IP:5211 进入 LitePan。

默认管理员账号 / 密码均为 admin。首次登录后请尽快修改密码。

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