项目介绍
OpenList 用于接入多个存储来源,并通过网页和 WebDAV 统一访问。下面介绍部署配置、群晖目录准备与首次使用检查。接入网盘后,先测试目录列表、下载和权限,再向其他客户端开放访问。
version: '3.8'
services:
openlist:
image: openlistteam/openlist:latest
container_name: openlist
volumes:
- '/volume1/docker/openlist:/opt/openlist/data'
ports:
- '5244:5244'
environment:
- PUID=0
- PGID=0
- UMASK=022
- TZ=Asia/Shanghai
restart: unless-stopped补充:部署与使用
配置与操作示例
Compose 部署
下例沿用项目官方容器数据路径,将数据落在群晖项目目录;默认只映射网页与 WebDAV 使用的 5244 端口:
群晖目录准备
在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/openlist/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。
sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/openlist /volume1/docker/openlist/data
cd /volume1/docker/openlist
chown 1001:1001 /volume1/docker/openlist/data
HALO_PREPARE
cd /volume1/docker/openlist
当前官方镜像使用 1001:1001,准备命令已设置数据目录的所有者,无需填写 PUID/PGID。
services:
openlist:
image: openlistteam/openlist:latest
ports:
- "5244:5244"
volumes:
- /volume1/docker/openlist/data:/opt/openlist/data
environment:
TZ: Asia/Shanghai
UMASK: "022"
restart: unless-stopped
下方准备命令会创建数据目录并设置为官方镜像使用的 1001:1001。不要假定其他镜像使用的 PUID、PGID 变量在这里也会生效。若启用使用其他端口的可选功能,再单独按文档增加映射。
访问 http://NAS_IP:5244。管理员初始化或重置可按官方命令执行:
docker compose exec openlist ./openlist admin random
命令输出包含新的登录凭据,只在自己的终端查看。添加一个测试挂载后,用普通用户检查列表、下载与 WebDAV;客户端一般连接 /dav,但其访问权限和存储端权限仍需分别设置。
启动与状态检查
在保存 compose.yaml 和所需 .env 的项目目录执行:
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100
config 用于检查配置,不会启动服务。示例使用上游浮动发行通道;长期运行可改为项目实际发布的固定标签或已记录的镜像摘要,不猜写版本号。日志中出现的初始密码和访问凭据仅在自己的终端查看。
常见问题
- 网页可见但播放器失败:检查实际下载地址、协议、鉴权与客户端格式支持。
- 挂载不是独立备份,删除或失去上游授权仍可能导致文件不可用。
更新与备份
备份应用数据与挂载配置,存储凭据另行保护;重要文件保留独立副本。
更新前记录当前镜像或仓库提交,停止会写入的任务并备份持久化数据;阅读版本迁移说明后再拉取并重建。数据库已经迁移时,回退还需要匹配的数据副本。需要暂时停服务可用 docker compose stop,不要把删除卷或清空数据目录当作更新步骤。