影音与下载

OpenList:网盘接入、目录与 WebDAV

  • 0 次阅读
  • 0 条评论
文章摘要

OpenList 将多个存储来源组织成统一目录,并提供网页访问和所支持的协议接口。它连接的是已有存储,账号权限、分享权限与实际文件保存位置仍由各个环节共同决定。

项目介绍

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,不要把删除卷或清空数据目录当作更新步骤。

官方资料