Alist 群晖 Container Manager 部署文档

2026-09-26 01:43:53

Alist 群晖 Container Manager 部署文档

适用：群晖 DSM7，Container Manager

1. 前置准备

在群晖【文件工作站】，提前创建目录：

/volume1/docker/alist/opt

作用：持久化 Alist 数据库、配置文件，容器删除数据不丢失。

2. docker-compose.yml

services:
  alist:
    image: xhofe/alist:latest
    container_name: alist
    restart: unless-stopped
    ports:
      - "5244:5244"
    volumes:
      - /volume1/docker/alist/opt:/opt/alist/data
      - /volume3/FTP:/ftp:ro
      - /volume1/Download:/download:rw
      - /volume1/music:/music:ro
      - /volume3/photo:/photo:ro
    environment:
      - TZ=Asia/Shanghai
      - PUID=0
      - PGID=0
      - UMASK=022
    networks:
      - alist_net
networks:
  alist_net:

3. 部署步骤

打开群晖【Container Manager】→【项目】→【创建】
项目名称填写 alist
【创建方式】选择「编写 docker-compose.yml」
将上面完整yaml粘贴进编辑器，确认缩进为空格（禁止Tab）
点击下一步，完成创建，容器自动拉取镜像并启动

4. 初始化登录

访问地址：http://群晖内网IP:5244
获取初始管理员密码：
- 进入容器 →【日志】，搜索关键词 admin
- 找到日志内 password: xxxxxx，复制密码
- 默认账号：admin
  
  首次登录后，在后台【设置】修改管理员密码

5. 后台添加存储简要说明

进入Alist后台【存储】→【添加】

本地存储：驱动选择「本地」，挂载路径填写容器内路径，例：/ftp、/download
各类网盘：选择对应驱动，按官方文档填入令牌/授权信息

6. 常用排错

容器启动失败：检查volumes内所有宿主机文件夹是否在File Station预先创建
YAML语法报错：所有缩进使用2空格，不要Tab
网盘挂载失败：核对令牌，注意部分驱动不能携带前缀（如移动云盘不要带Basic）
权限异常：环境变量PUID/PGID保持0，或修改为群晖对应UID

7. 备份说明

持久化目录：/volume1/docker/alist/opt 定期备份此文件夹，重装容器直接复用该目录，配置与网盘挂载信息全部保留。

. 后台添加存储简要说明

进入 Alist 后台【存储】→【添加】

本地存储：驱动选择「本地」，挂载路径填写容器内路径，例：/ftp、/download
各类网盘：选择对应驱动，按下方配置填入令牌 / 授权信息

1. 网盘驱动精简配置（百度网盘 / 139 移动云盘 / 迅雷云盘）

入口：存储 → 添加，填写挂载路径与驱动参数，保存测试

1.1 百度网盘

驱动：百度网盘
挂载路径：/百度网盘（自定义）
获取令牌：打开官方授权工具登录百度账号，授权后拿到 refresh_token、client_id、client_secret
参数填写：
- Refresh Token：授权得到的 refresh_token
- Client ID：授权得到的 client_id
- Client Secret：授权得到的 client_secret

注意：授权弹窗出现语言切换提示时，点【取消】，不要点击切换语言，防止 token 丢失

1.2 中国移动云盘（139 云盘）

驱动：中国移动云盘
挂载路径：/移动云盘（自定义）
获取 Authorization：浏览器登录yun.139.com，F12 开发者工具抓取 Cookie 内authorization的值
参数填写：
- Authorization：只粘贴 Basic 后面的字符串，不要带 Basic 前缀
- 类型：新个人云
- 根文件夹 ID：留空

报错提示should not include Basic prefix，就是带入了 Basic 前缀，删除前缀重新粘贴

1.3 迅雷云盘

驱动：迅雷
挂载路径：/迅雷云盘（自定义）
参数填写：
- 用户名：迅雷账号手机号
- 密码：迅雷账号密码
- CaptchaToken：留空
- 设备 ID：留空

保存后触发验证：复制报错内完整 JSON，打开 https://i.xunlei.com/xlcaptcha/android.html，F12 控制台执行reviewCb(粘贴JSON)完成滑块 / 短信验证，验证完成后再次点保存

← 返回文章列表