群晖里的文件用 File Station 管,夸克里的文件打开夸克,阿里云盘里的文件再换一个网页——东西放得越分散,找起来就越麻烦。
AList 可以把这些存储接到同一个网页里。打开一个地址,就能浏览 NAS 目录和已经挂载的网盘;需要接入播放器、文件管理器时,还可以使用 WebDAV。
这篇文章从群晖创建文件夹开始,把容器安装、目录映射、管理员密码、用户身份、目录密码和网盘挂载逐步讲清楚。夸克网盘是重点,会分别介绍 Cookie 和 TV 扫码两种方式。
先说明一个容易误会的地方:挂载网盘不会自动把网盘文件备份到 NAS。 文件通常仍在原来的网盘里,只有访问、下载或执行复制任务时才发生相应的数据传输。
开始之前,先统一环境和路径
本文以 DSM 7.2 及以上、已支持 Container Manager 的群晖机型为主。旧版 Docker 套件的安装方式放在后面,两种方式选一种即可。
需要准备:
- 一个能够管理群晖和容器的 DSM 账号。
- 已在“套件中心”安装的 Container Manager;旧系统可能显示为 Docker。
- 一台与群晖处于同一局域网的电脑,夸克 Cookie 操作以 Chrome 为例。
- 能够正常登录的夸克账号;挂其他网盘时准备对应账号。
本文统一使用下面这组示例:
| 项目 | 本文示例 | 你需要怎么处理 |
|---|---|---|
| 群晖局域网 IP | 192.168.1.10 |
换成自己 NAS 的地址 |
| AList 网页端口 | 5244 |
未被占用就保留 |
| AList 项目目录 | /volume1/docker/alist |
按自己的存储卷修改 |
| AList 配置目录 | /volume1/docker/alist/data |
用于保存数据库和设置 |
| 准备展示的 NAS 文件夹 | /volume1/cloud sync/本机存储 |
换成实际想展示的目录 |
| 容器内的文件目录 | /本机存储 |
可以直接沿用 |
本文按实际配置示例使用 cloud sync 共享文件夹下的“本机存储”子文件夹。群晖没有默认的 share 目录,不需要另外寻找或创建它。其他读者应在 File Station 中确认自己已有的共享文件夹及完整位置,再替换映射左侧路径。
本文根据 2026 年 10 月 29 日可访问的 AList 文档及项目源码整理,针对 AList v3。不同版本的按钮名称、角色管理和驱动选项可能不同,文中会说明需要注意的地方。这是一份配置教程,具体网盘能否连接仍要以你的版本、账号和实际测试结果为准。
三种路径分别填在哪里
先把这件事搞清楚,后面的配置就容易很多。
| 路径类型 | 示例 | 填在哪里 |
|---|---|---|
| 群晖上的真实路径 | /volume1/cloud sync/本机存储 |
Docker 卷映射的左侧 |
| 容器内部路径 | /本机存储 |
卷映射右侧;AList 本地存储的根文件夹路径 |
| AList 网页挂载路径 | /volume1 |
AList“存储”里的“挂载路径” |
它们之间的关系是:群晖的 /volume1/cloud sync/本机存储 映射进容器后叫 /本机存储;再把 /本机存储 接入 AList,网页上显示的入口叫 /volume1。
另外,/opt/alist/data 是 AList 自身的配置目录,用来保存数据库、账号和挂载设置。不要把它当作对外展示的文件夹,也不要把整个 docker 目录挂到前台。
先在 File Station 创建目录
- 登录 DSM,点击左上角“主菜单”,打开 File Station。
- 在左侧选择
docker共享文件夹。如果没有,在 控制面板 → 共享文件夹 → 新增 中创建;选择实际存储卷,名称填写docker。 - 进入
docker,点击上方 新增 → 新增文件夹,名称填写alist。 - 双击进入
alist,再新建一个名为data的文件夹。 - 右键
alist,打开 属性 → 常规,确认“位置”。如果目录在第二个存储卷,真实路径可能是/volume2/docker/alist。 - 用同样方法确认准备展示的共享文件夹路径,例如
/volume1/cloud sync/本机存储。
项目目录最终是这样:
/volume1/docker/alist/
├── docker-compose.yml ← 创建项目时由界面保存
└── data/ ← 首次启动后自动生成配置和数据库
data 里一开始是空的,属于正常情况,不需要自己创建数据库或 config.json。
已有 AList 的读者先备份原配置目录。 新安装则使用新的空目录,不要把其他容器的数据目录拿来复用。
用 Container Manager 创建 AList 项目
打开项目创建窗口
- 从 DSM 主菜单打开 Container Manager。
- 点击左侧 项目,再点击上方 新增或“创建”。
- “项目名称”填写
alist。 - “路径”点击选择按钮,定位到刚刚创建的
docker/alist。界面可能显示/docker/alist,实际完整路径以 File Station 属性里的位置为准。 - “来源”选择 创建 docker-compose.yml,在下方编辑框粘贴配置。
填写 Compose 配置
services:
alist:
image: xhofe/alist:latest
container_name: alist
restart: unless-stopped
ports:
- "5244:5244"
environment:
TZ: Asia/Shanghai
PUID: "0"
PGID: "0"
UMASK: "022"
volumes:
- "/volume1/docker/alist/data:/opt/alist/data:rw"
- "/volume1/cloud sync/本机存储:/本机存储:rw"
粘贴后,逐项检查下面几处。
第一处:配置目录。 把 /volume1/docker/alist/data 换成自己创建的 data 路径,右侧 /opt/alist/data 保留。这条映射必须允许写入,否则无法正常保存配置。
第二处:文件目录。 把 /volume1/cloud sync/本机存储 换成准备展示的真实文件夹。右侧 /本机存储 可以保留。结尾的 :rw 表示允许容器读写,与本文实际配置一致。路径含有空格,因此整条映射用英文双引号包住。是否允许某个网页用户上传、删除,还需通过 AList 的角色权限控制;只需浏览的读者也可以改成 :ro。暂时只挂网盘的读者,删除这一整行即可。
第三处:端口。 5244:5244 左边是群晖端口,右边是容器端口。如果左侧端口已经被占用,可以改成 5245:5244,以后浏览器就访问 http://群晖IP:5245。
第四处:运行身份。 PUID 和 PGID 是容器进程使用的 UID、GID,与 AList 网页里的管理员、普通用户不是同一回事。这里沿用官方 Docker 示例的 0/0,同时只映射需要的文件夹,并通过 AList 角色限制修改权限。有 Linux 权限管理经验的读者可以换成专用账号对应的 UID/GID,并单独配置 DSM 权限。
本文使用官方文档列出的 xhofe/alist:latest。latest 指向的版本会变化,安装完成后记下实际版本;长期使用时,可以从项目发布页选择已确认可用的版本标签固定下来。不同分支的镜像、文档和授权方式要分别核对。
完成创建并检查容器
- 点击 下一步。
- 如果出现“通过 Web Station 设置网页门户”,本教程直接通过 IP 和端口访问,可以不启用该选项。
- 检查摘要中的路径和配置,勾选 创建后立即启动项目,点击 完成。
- 等待镜像下载和项目启动。第一次下载可能较慢,展开构建日志看是否有报错。
- 点击左侧 容器,找到
alist,确认状态为“运行中”。
如果镜像下载超时,先检查 NAS 的网络和镜像源连接。只创建这个项目就能完成安装,无需重启整个 Docker 服务。项目部署操作与参数可对照 AList Docker 文档。
旧版 Docker 套件怎样安装
已经按上面方法创建成功的读者,直接跳到下一节。
- 打开 DSM 的 Docker 套件,点击左侧 注册表。
- 搜索
xhofe/alist,选择对应仓库并下载latest标签。 - 下载完成后,点击左侧 映像,选择该映像,点击 启动。
- 容器名称填写
alist,进入 高级设置,启用自动重新启动。 - 在 存储空间/卷 中点击“添加文件夹”:选择
docker/alist/data,装载路径填写/opt/alist/data,允许读写。 - 再添加准备展示的共享文件夹,装载路径填写
/本机存储,允许读写(与:rw对应)。只挂网盘就不添加这一项。 - 在 端口设置 中,本地端口填写
5244,容器端口填写5244,协议选择 TCP。 - 在 环境 中按前面的配置添加
TZ、PUID、PGID、UMASK。 - 网络保留默认桥接网络,启动命令保留镜像默认值。检查摘要后点击“应用”或“完成”。
不同 DSM 版本可能把设置分成多个页面,核心就是两条卷映射和一条端口映射。普通文件浏览用途不需要勾选“使用高权限执行容器”。
第一次登录:找密码、进后台、修改密码
从日志获取初始密码
- 在 Container Manager 左侧点击 容器。
- 选中
alist,打开 详细信息/详情。 - 切换到 日志页签,查看首次启动时输出的管理员账号和初始随机密码。默认管理员用户名通常是
admin。 - 电脑浏览器输入
http://192.168.1.10:5244,把 IP 换成自己的 NAS 地址。 - 在登录页面填写用户名、密码。首页若提示
Guest user is disabled, login please,进入登录即可,这是游客访问被关闭的提示。 - 登录后滚动到首页最底部,在“由 AList 驱动”右侧点击 管理进入后台。该按钮位于页面底部中间,不在右上角的列表视图按钮里。也可以直接打开
http://群晖IP:5244/@manage。
初次进入时没有文件列表,甚至提示先添加存储,通常是因为还没挂载任何目录,不代表安装失败。
日志里没有密码怎么办
如果配置目录之前用过,AList 会继续使用原数据库里的账号和密码。较新的 v3 版本不会把已保存密码反向显示出来,忘记密码需要重置。
优先使用容器详情里的 终端机功能。如果界面允许“新增/创建终端”,启动命令填 sh 或 /bin/sh,进入后执行:
./alist admin random
这会生成新密码,复制后重新登录。若当前 DSM 没有可用的容器终端,可通过已经启用的 SSH 连接 NAS,执行:
sudo docker exec -it alist ./alist admin random
alist 必须与实际容器名称一致。这里的命令在群晖终端执行,不是在 AList 网页填写。如果需要启用 SSH,入口是 控制面板 → 终端机和 SNMP → 终端机 → 启动 SSH 功能;只在局域网操作,临时开启的 SSH 用完可关闭。
后台左侧各栏目在哪里
进入后左上方显示“AList 管理”。左侧从上到下可以找到“个人资料”“设置”“任务”“角色”“用户”“对话”“存储”“元信息”“索引”“备份 & 恢复”等栏目。“个人资料”修改自己的登录密码;“角色”和“用户”管理身份及访问范围;“存储”添加 NAS 本机目录、夸克等网盘以及更新 Cookie;“元信息”设置 NAS 或网盘目录的访问密码。最下方的“主页”返回文件列表。
修改管理员用户名和密码
- 进入 AList 后台,点击左侧 个人资料。
- 在“更改用户名”中按需修改;如果改了用户名,后面登录也要使用新名称。
- 在“更改密码”中输入新密码,再在“确认密码”中重复输入。
- 点击下方 保存,按提示重新登录,确认新账号密码可用。
AList 登录密码、DSM 登录密码和网盘账号密码分别属于不同系统,建议分别保存。后面设置的“目录密码”也与登录密码不同。
添加 NAS 本地目录
这一步把容器已经能读取的 /本机存储,变成 AList 首页中的一个入口。
- 在 AList 后台左侧点击 存储。
- 点击列表上方 添加。
- 在“驱动”下拉框中选择 本机存储/Local。
- “挂载路径”填写
/volume1,开头保留斜杠。 - 找到“根文件夹路径”,填写
/本机存储。不同版本也可能显示为“根文件夹 ID”,这里都应填写容器内部路径。 - 序号可填写
1,备注可填写“群晖共享目录”,其余先保留默认。 - 点击页面下方 添加/保存。
- 返回“存储”列表,确认这一项没有错误,再点击左侧 主页。
- 首页出现“volume1”,打开后应看到测试文件。下载一份小文件,确认内容正常。
这里填 /本机存储,不要填 /volume1/cloud sync/本机存储。 AList 运行在容器里,需要使用容器看到的路径。本地驱动字段可参考本机存储文档。
以后要添加第二个 NAS 目录,先在 Compose 里新增对应映射,例如 /volume1/video:/mnt/video:ro,重新构建这个 AList 项目,再到“存储”新增一条挂载路径为 /影视、根路径为 /mnt/video 的本机存储。
如果希望通过 AList 上传或删除 NAS 文件,需要同时满足:卷映射允许写入、容器运行账号有目录权限、AList 用户或角色有对应操作权限。先用测试目录验证,再考虑开放正式目录。
挂载夸克网盘:先用 Cookie 方式
夸克普通驱动使用网页登录后的 Cookie 识别账号。这里不需要把夸克的手机号、登录密码填进 AList。
在浏览器获取 Cookie
- 在电脑上用 Chrome 打开夸克网盘网页版。
- 完成登录,确认已经能看到自己的网盘文件。
- 按键盘 F12;如果按键没有打开开发者工具,点击浏览器右上角“三个点 → 更多工具 → 开发者工具”。
- 在开发者工具顶部切换到 Network/网络。如果顶部没有显示,点击
»展开隐藏栏目。 - 保持开发者工具打开,按 F5 刷新网盘页面,再点击左侧“全部文件”或进入一个文件夹,让网页发出文件列表请求。
- 在网络面板上方选择 Fetch/XHR,从请求列表中找获取文件目录的请求。请求名称可能带有
sort、list等字样,具体以网页实际请求为准。 - 点击请求,在右侧选择 Headers/标头。
- 向下找到 Request Headers/请求标头,再找到
Cookie。不要选成响应标头中的Set-Cookie。 - 复制
Cookie后面的完整值,通常是一长串由分号分隔的名称=值。不要只复制其中某一个字段,也不要把整段请求标头一起复制。
可以右键 Cookie 这一行,选择“复制值/Copy value”;没有这个选项时,展开并选中完整内容复制。填入 AList 时,只粘贴值,不加 Cookie: 前缀,不额外加引号。
如果请求没有 Cookie,换一个真正访问文件列表的请求,确认当前账号仍在登录状态。不要从未登录页面、登录二维码图片或无关静态资源里取值。
Cookie 是登录凭据。 保存在自己的 AList 里即可,不要放进公开教程、截图、评论或在线 Cookie 检测工具。退出登录、修改账号安全设置或服务端会话变化后,它可能失效。
在 AList 新增夸克存储
回到 AList 后台,点击 左侧“存储” → 上方“添加”,按照下面填写:
| 字段 | 怎么填 |
|---|---|
| 驱动 | 选择“夸克/Quark”,先不要选 QuarkTV |
| 挂载路径 | /夸克网盘 |
| 序号 | 例如 2,数值越小通常越靠前 |
| Cookie | 粘贴刚刚获取的完整 Cookie 值 |
| 根文件夹 ID | 0,表示从夸克根目录开始 |
| Web 代理 | 初次按普通下载链路使用时开启 |
| 下载代理 URL | 没有自建代理就留空 |
| WebDAV 策略 | 如需使用 WebDAV,普通链路先选“本机代理/本地代理” |
| 使用转码地址 | 如果版本提供此项,先关闭,基础访问正常后再按需开启 |
其余字段先保留默认,滚动到页面下方,点击 添加/保存。
然后按这个顺序验收:
- 返回存储列表,确认“夸克网盘”没有认证或初始化错误。
- 点击左侧 主页,进入“夸克网盘”。
- 对照夸克官网,确认文件夹名称和内容正确。
- 下载一份小文件,检查能否完整打开。
- 再测试视频预览。能列目录、能下载、能播放,是三个不同的检查点。
AList 的挂载路径 /夸克网盘 是网页入口名,根文件夹 ID 0 是夸克接口里的目录标识,两者不能互换。夸克各版本选项见夸克驱动文档。
只展示夸克里的某个文件夹
如果只想挂载“影视”目录:
- 在夸克网页版打开“影视”文件夹。
- 查看浏览器地址栏,找到对应的目录 ID。网页地址可能包含
list/all/目录ID或多层目录信息,要取当前文件夹对应的那段 ID。 - 回到 AList 存储列表,找到夸克那一行,点击 编辑。
- 把“根文件夹 ID”由
0改成该文件夹的 ID,挂载路径仍可以保留/夸克网盘。 - 保存后回到主页刷新,检查入口内是否直接显示“影视”文件夹里的内容。
不要把整个网页 URL 填进去,也不要把“影视”这两个字当作 ID。拿不准时,先用 0 验证账号连接,再调整范围。
能看到目录,却下载不了或播放很慢
普通夸克下载链路对请求头、账号状态和代理方式有要求。本地代理表示文件经过 NAS 中转,大致是:
夸克网盘 → 群晖上的 AList → 你的浏览器或播放器
这里的“本地”指部署 AList 的设备,也就是群晖。人在外面访问时,NAS 所在网络的上行带宽也会影响速度;AList 不能解除网盘自身的账号权益和限速。
如果版本里有 “使用转码地址”,可以在基础挂载正常后开启,再测试夸克视频。该选项使用转码流,画质和原文件可能不同,也不代表所有普通文件都能直连下载。
Web 代理与 WebDAV 策略要分别设置。 网页能下载而播放器失败时,还要检查 WebDAV 所选策略、账号权限和客户端访问地址。出现问题先测试小文件,避免一上来用大视频把多个问题混在一起。
夸克 TV:使用扫码授权的另一种方式
如果“驱动”列表里提供 夸克 TV/QuarkTV,也可以尝试扫码方式。它与普通 Quark 驱动分开配置,不需要复制 Cookie,但支持的操作范围有差异。
- 在 存储 → 添加中,驱动选择“夸克 TV/QuarkTV”。
- 挂载路径填写
/夸克TV,根文件夹 ID 保留0。 - 刷新令牌、Device ID、Query token 等授权字段先留空,按驱动页面要求保存。
- 回到 存储列表,查看该条目出现的二维码;如果没有显示,找列表右上方的布局切换按钮,切换列表/表格布局后再看。
- 使用手机夸克 APP 扫码,在手机上确认授权。
- 授权完成后,按驱动文档说明将这条存储禁用一次,再重新启用。
- 等待状态刷新,回到首页打开“夸克TV”,测试列目录和下载。
授权成功后相关令牌由程序自动填写。二维码过期则重新获取;不要把其他教程里的令牌、设备 ID 拼到自己的授权信息里。
TV 驱动主要用于列目录和下载,不能按普通网盘管理驱动期待上传、删除等操作。扫码授权、接口可用性和账号权益会变化,实际使用时要再次核对驱动说明。
其他网盘怎么添加:以阿里云盘 Open 为例
其他网盘也从 存储 → 添加 → 选择驱动进入,但授权信息不能通用。夸克用的 Cookie,不能直接用来挂阿里云盘;不同服务的根目录 ID 也不相同。
阿里云盘可以按下面操作:
- 打开 AList 的阿里云盘 Open 文档,在“刷新令牌”部分点击“获取刷新 Token”。从文档进入当前授权工具,避免使用旧教程中已经失效的地址。
- 按页面提示登录或扫码,确认授权对象与权限,获得
refresh_token。 - 回到 AList 存储 → 添加,驱动选择 阿里云盘 Open。
- 挂载路径填写
/阿里云盘,在“刷新令牌”中粘贴刚获得的refresh_token。 - 根文件夹 ID 先填写
root。如果要限定某个目录,在阿里云盘网页版进入该文件夹,取地址中folder/后对应的文件夹 ID。 - 普通用户保留客户端 ID、客户端密钥的驱动默认设置;使用自建开发者应用时才填写配套参数。
- 根据自己文件所在位置选择“云盘类型”,保存后回到首页验证。若目录内容与预期不同,核对资源库/备份盘选项。
百度、OneDrive、天翼等网盘同样需要按各自驱动说明获取凭据。不要把夸克的根目录 ID 0 套到所有服务上。比如 115 Open 文档当前已提示接口关闭,就应先核对替代驱动,不能因为旧教程有选项便认定仍然可用。
身份与权限:管理员、普通用户、游客分别怎么用
文件接进来之后,再决定谁能访问。建议先保持游客关闭,用管理员确认存储正常,再给需要访问的人单独创建账号。
管理员与游客有什么区别
管理员负责添加存储、修改系统设置、管理账号,权限很高。日常给家人使用,单独建普通账号更方便控制范围。
guest 是未登录访问者使用的游客身份。给 guest 设置密码,不能变成“访客先输密码才能访问”的登录方案;需要账号认证时,创建普通用户。
检查游客状态:
- 后台左侧点击 用户。
- 找到
guest那一行,点击 编辑。 - 确认 停用处于勾选状态,保存。
- 新开浏览器无痕窗口访问 AList,检查是否要求登录。
如果以后确实需要匿名展示,先为游客限制好允许访问的目录和权限,再取消“停用”,并在未登录窗口实际验证展示范围。
新版先创建角色,再创建用户
新版后台有 角色栏目,用户通过角色获得对应目录和操作权限。下面以“家人只能浏览 /volume1/共享”为例。先确认这个目录已经存在,必要时在群晖 File Station 中创建。
- 点击后台左侧 角色。部分版本将其放在“权限”分组下。
- 点击上方 添加,角色名称填写“家人只读”,描述按需填写。
- 在“基本路径”或目录选择树中展开
/volume1,只选择其下的/volume1/共享。不要把根路径/或整个/volume1一起勾选。 - 在“权限”下拉框中勾选 检查路径限制,让访问范围限制在角色覆盖的目录内。
- 只用网页浏览时,不添加上传、删除、重命名、移动等修改权限。需要播放器或文件管理器接入时,再勾选 WebDAV 读取。
- 保留“无密码访问”“可以看到隐藏”等权限为关闭状态,除非明确需要。
- 点击 保存。
- 再点击左侧 用户 → 添加,用户名填写例如
family,设置单独的登录密码。 - 在“角色”中只选择刚创建的“家人只读”,检查没有额外选择覆盖
/的其他角色;“停用”不要勾选,保存。
新版某些界面的用户“基本路径”可能固定显示 /,或不再提供可编辑输入框。此时通过角色配置目录范围即可,不能把修改登录落点当成完成授权限制。多个角色的权限可能叠加,所以额外授予一个大范围角色,会扩大用户能访问的内容。
保存后新开无痕窗口,用 family 登录:确认能进入共享目录;再尝试访问 /volume1 的其他目录和其他网盘,确认访问受到限制;同时检查不能上传、删除。权限配置依据可对照用户文档和角色表单源码。
旧版没有“角色”栏目怎么办
旧版常把基本路径和权限直接放在 用户 → 添加/编辑里:用户名、密码分别填写;“基本路径”选择要开放的 AList 目录;“权限”只开需要的操作;保持用户未停用,再保存。
这里选择的是 /volume1/共享 这样的 AList 路径,不是 /volume1/cloud sync/本机存储。设置后同样使用普通账号验证范围。新旧权限模型有区别,升级后也应重新检查,不能直接沿用“填了基本路径就一定隔离”的判断。
给单独的文件夹加密码
“用户登录密码”用于登录账号;“目录密码”用于网页访问某个目录,两者可以同时使用。下面以 NAS 本机目录为例;夸克目录同样在“元信息”添加规则,只需把路径换成 /夸克网盘/私人资料。
例如想给 NAS 的 /volume1/私人资料 添加目录密码:
- 在后台左侧点击 元信息。
- 点击上方 添加。
- “路径”点击选择按钮,定位到
/volume1/私人资料;也可以输入完整 AList 路径。 - 在 密码框中填写目录访问密码。
- 如果子目录也要验证密码,勾选紧跟在“密码”字段旁边的“应用到子文件夹”。
- 写入保持关闭;它用于开放创建目录、上传等能力,与密码设置无关。
- 隐藏、顶部说明、说明等字段暂时留空,点击 添加/保存。
- 使用无痕窗口,以没有“无密码访问”权限的普通账号进入该目录,检查是否出现密码提示,再测试子目录。
管理员或具有“无密码访问”权限的用户可能直接进入,所以用管理员测试不能准确反映普通用户的体验。
还有一个必须分清的限制:元信息目录密码不用于 WebDAV 鉴权。 WebDAV 需要通过账号、角色路径和 WebDAV 权限控制访问。目录加密码也不会给网盘原文件进行内容加密。具体规则见元信息文档。
接入播放器或文件管理器:WebDAV 怎么填
网页访问正常后,可以再连接支持 WebDAV 的客户端。
- 在 AList 后台为对应普通账号或其角色开启 WebDAV 读取。
- 打开客户端,新增一个 WebDAV 连接。
- 如果软件提供“完整 URL”输入框,填写
http://192.168.1.10:5244/dav/。 - 如果分开填写:服务器填
192.168.1.10,端口填5244,协议选 HTTP,路径填/dav/。有的软件路径框不要求开头斜杠,按客户端提示调整。 - 用户名、密码使用 AList 普通账号的登录凭据。
- 保存连接,检查能否浏览被授权的目录并读取一份小文件。
局域网之外,需要换成实际可访问的 HTTPS 地址。这里只完成局域网部署,外网访问还涉及域名、证书和现有网络方案,单独配置更容易排查;已有 FRP 的读者也要先评估带宽和访问权限,再新增独立入口。
只读使用不用开启 WebDAV 管理。需要上传、重命名、删除时,除了 WebDAV 管理,还要开放对应的基础操作权限,并确认驱动支持;本地目录还受容器映射读写模式限制(本文为 :rw,若改成 :ro 则不能写入)。地址和权限说明见 WebDAV 文档。
出问题时,按这个顺序排查
打不开 AList 网页
先看容器是否“运行中”,再核对浏览器 IP 和 Compose 左侧端口。5245:5244 对应的访问端口是 5245。容器反复重启则先看日志,重点检查配置目录不存在、无法写入等提示。若 DSM 开启防火墙,检查是否允许可信局域网访问对应 TCP 端口,无需关闭整个防火墙。
本地目录为空,或提示没有权限
先确认群晖源目录确实有文件,再检查它有没有映射到容器,AList 根路径是否填写 /本机存储。出现 permission denied 时,检查运行账号和 DSM 的目录权限;只给实际需要的账号及文件夹授权,不把所有共享文件夹设成 everyone 读写。
夸克突然提示未登录、401 或认证失败
先在夸克官网确认账号状态。如果 Cookie 失效,按前面的步骤重新获取,再进入 存储 → 夸克网盘 → 编辑替换并保存。若提示风控、请求过于频繁,先降低请求频率,在官方客户端完成必要验证。不同错误原因不同,不能保证更新 Cookie 就能解决所有问题。
网盘能列目录,却不能下载
分别检查 Web 代理、WebDAV 策略、授权状态和网盘账号限制。普通 Quark 与 QuarkTV 的选项和能力也不同。先下载小文件,再测试大文件和视频;网页测试与播放器测试分别进行。
设置目录密码后仍然直接进入
检查元信息路径是否正确,是否只配置父目录却没有应用到子文件夹,再检查当前账号是否有“无密码访问”权限。浏览器也可能保留已验证状态,用无痕窗口重新测试。若使用 WebDAV,改查账号和角色授权,目录密码本来就不在该链路生效。
用户仍能访问其他文件夹
新版检查该用户所有角色的路径范围,尤其有没有额外的 / 授权,以及“检查路径限制”是否按需开启。不要只看用户基本路径或首页是否隐藏入口;直接输入其他目录地址测试,才能确认限制是否生效。
更新和备份:先记住 data 在哪里
安装完成后,最值得保存的是 /volume1/docker/alist/data 和项目的 Compose 文件。前者含有账号、数据库和网盘凭据,应保存在受控位置;它们的备份也不能替代 NAS 文件和云盘原文件的备份。
准备更新时:
- 记下当前 AList 版本、镜像标签及挂载配置。
- 在 Container Manager 中只停止
alist项目,使默认 SQLite 数据库停止写入。 - 在 File Station 中把整个
alist项目目录复制到另一个受保护的备份目录,保留原配置。 - 按目标版本说明更新镜像或标签,重新构建该项目;如果有重新拉取镜像选项,确认启用。
- 启动后检查登录、NAS 目录、夸克下载和普通账号权限。
如果更新后需要回退,旧镜像与旧版配置备份应配套恢复;新数据库可能发生结构变化,单纯降级镜像未必可用。
这套操作会让 AList 在备份和重建期间短暂不可用,只需操作对应项目。无需为此重启群晖、整个容器服务或已有 FRP 服务。
写在最后
AList 配置最容易出错的地方,是几个看起来相似的概念:NAS 的真实路径、容器里的路径、网页挂载路径;管理员身份、普通账号、游客;登录密码、目录密码和网盘凭据。
把这些分清,再按“先启动容器 → 挂本地目录 → 接夸克 → 配权限 → 测试 WebDAV”的顺序往下走,就能逐步确认每一步有没有成功。
对我来说,把 NAS 和网盘整理到一个入口,价值在于少切换几个应用,也更清楚自己的文件放在哪里。先把常用的几个目录配好、把访问范围确认好,后面再增加其他网盘,会省心很多。
— 完 —
参考资料
- 群晖 Docker 部署 Alist 教程(什么值得买,2023):参考其部署与初始化流程,本文结合当前文档重新核对参数。
- AList Docker 安装
- 存储通用项与本机存储
- 夸克网盘/TV与阿里云盘 Open
- 用户、元信息与 WebDAV
- AList 前端:用户编辑、角色配置与后台导航:核对新版后台入口及表单。


