群晖 NAS 部署 AList 完整教程:Docker 安装、目录映射、账号权限与夸克网盘挂载

本文最后更新于 19 天前,如有失效请评论区留言。

群晖里的文件用 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 创建目录

  1. 登录 DSM,点击左上角“主菜单”,打开 File Station。
  2. 在左侧选择 docker 共享文件夹。如果没有,在 控制面板 → 共享文件夹 → 新增 中创建;选择实际存储卷,名称填写 docker。
  3. 进入 docker,点击上方 新增 → 新增文件夹,名称填写 alist。
  4. 双击进入 alist,再新建一个名为 data 的文件夹。
  5. 右键 alist,打开 属性 → 常规,确认“位置”。如果目录在第二个存储卷,真实路径可能是 /volume2/docker/alist。
  6. 用同样方法确认准备展示的共享文件夹路径,例如 /volume1/cloud sync/本机存储。

项目目录最终是这样:

/volume1/docker/alist/
├── docker-compose.yml    ← 创建项目时由界面保存
└── data/                 ← 首次启动后自动生成配置和数据库

data 里一开始是空的,属于正常情况,不需要自己创建数据库或 config.json。

已有 AList 的读者先备份原配置目录。 新安装则使用新的空目录,不要把其他容器的数据目录拿来复用。

用 Container Manager 创建 AList 项目

打开项目创建窗口

  1. 从 DSM 主菜单打开 Container Manager。
  2. 点击左侧 项目,再点击上方 新增或“创建”。
  3. “项目名称”填写 alist。
  4. “路径”点击选择按钮,定位到刚刚创建的 docker/alist。界面可能显示 /docker/alist,实际完整路径以 File Station 属性里的位置为准。
  5. “来源”选择 创建 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 指向的版本会变化,安装完成后记下实际版本;长期使用时,可以从项目发布页选择已确认可用的版本标签固定下来。不同分支的镜像、文档和授权方式要分别核对。

完成创建并检查容器

  1. 点击 下一步。
  2. 如果出现“通过 Web Station 设置网页门户”,本教程直接通过 IP 和端口访问,可以不启用该选项。
  3. 检查摘要中的路径和配置,勾选 创建后立即启动项目,点击 完成。
  4. 等待镜像下载和项目启动。第一次下载可能较慢,展开构建日志看是否有报错。
  5. 点击左侧 容器,找到 alist,确认状态为“运行中”。

如果镜像下载超时,先检查 NAS 的网络和镜像源连接。只创建这个项目就能完成安装,无需重启整个 Docker 服务。项目部署操作与参数可对照 AList Docker 文档。

旧版 Docker 套件怎样安装

已经按上面方法创建成功的读者,直接跳到下一节。

  1. 打开 DSM 的 Docker 套件,点击左侧 注册表。
  2. 搜索 xhofe/alist,选择对应仓库并下载 latest 标签。
  3. 下载完成后,点击左侧 映像,选择该映像,点击 启动。
  4. 容器名称填写 alist,进入 高级设置,启用自动重新启动。
  5. 在 存储空间/卷 中点击“添加文件夹”:选择 docker/alist/data,装载路径填写 /opt/alist/data,允许读写。
  6. 再添加准备展示的共享文件夹,装载路径填写 /本机存储,允许读写(与 :rw 对应)。只挂网盘就不添加这一项。
  7. 在 端口设置 中,本地端口填写 5244,容器端口填写 5244,协议选择 TCP。
  8. 在 环境 中按前面的配置添加 TZ、PUID、PGID、UMASK。
  9. 网络保留默认桥接网络,启动命令保留镜像默认值。检查摘要后点击“应用”或“完成”。

不同 DSM 版本可能把设置分成多个页面,核心就是两条卷映射和一条端口映射。普通文件浏览用途不需要勾选“使用高权限执行容器”。

第一次登录:找密码、进后台、修改密码

从日志获取初始密码

  1. 在 Container Manager 左侧点击 容器。
  2. 选中 alist,打开 详细信息/详情。
  3. 切换到 日志页签,查看首次启动时输出的管理员账号和初始随机密码。默认管理员用户名通常是 admin。
  4. 电脑浏览器输入 http://192.168.1.10:5244,把 IP 换成自己的 NAS 地址。
  5. 在登录页面填写用户名、密码。首页若提示 Guest user is disabled, login please,进入登录即可,这是游客访问被关闭的提示。
  6. 登录后滚动到首页最底部,在“由 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 或网盘目录的访问密码。最下方的“主页”返回文件列表。

修改管理员用户名和密码

  1. 进入 AList 后台,点击左侧 个人资料。
  2. 在“更改用户名”中按需修改;如果改了用户名,后面登录也要使用新名称。
  3. 在“更改密码”中输入新密码,再在“确认密码”中重复输入。
  4. 点击下方 保存,按提示重新登录,确认新账号密码可用。

AList 登录密码、DSM 登录密码和网盘账号密码分别属于不同系统,建议分别保存。后面设置的“目录密码”也与登录密码不同。

添加 NAS 本地目录

这一步把容器已经能读取的 /本机存储,变成 AList 首页中的一个入口。

  1. 在 AList 后台左侧点击 存储。
  2. 点击列表上方 添加。
  3. 在“驱动”下拉框中选择 本机存储/Local。
  4. “挂载路径”填写 /volume1,开头保留斜杠。
  5. 找到“根文件夹路径”,填写 /本机存储。不同版本也可能显示为“根文件夹 ID”,这里都应填写容器内部路径。
  6. 序号可填写 1,备注可填写“群晖共享目录”,其余先保留默认。
  7. 点击页面下方 添加/保存。
  8. 返回“存储”列表,确认这一项没有错误,再点击左侧 主页。
  9. 首页出现“volume1”,打开后应看到测试文件。下载一份小文件,确认内容正常。

这里填 /本机存储,不要填 /volume1/cloud sync/本机存储。 AList 运行在容器里,需要使用容器看到的路径。本地驱动字段可参考本机存储文档。

以后要添加第二个 NAS 目录,先在 Compose 里新增对应映射,例如 /volume1/video:/mnt/video:ro,重新构建这个 AList 项目,再到“存储”新增一条挂载路径为 /影视、根路径为 /mnt/video 的本机存储。

如果希望通过 AList 上传或删除 NAS 文件,需要同时满足:卷映射允许写入、容器运行账号有目录权限、AList 用户或角色有对应操作权限。先用测试目录验证,再考虑开放正式目录。

挂载夸克网盘:先用 Cookie 方式

夸克普通驱动使用网页登录后的 Cookie 识别账号。这里不需要把夸克的手机号、登录密码填进 AList。

在浏览器获取 Cookie

  1. 在电脑上用 Chrome 打开夸克网盘网页版。
  2. 完成登录,确认已经能看到自己的网盘文件。
  3. 按键盘 F12;如果按键没有打开开发者工具,点击浏览器右上角“三个点 → 更多工具 → 开发者工具”。
  4. 在开发者工具顶部切换到 Network/网络。如果顶部没有显示,点击 » 展开隐藏栏目。
  5. 保持开发者工具打开,按 F5 刷新网盘页面,再点击左侧“全部文件”或进入一个文件夹,让网页发出文件列表请求。
  6. 在网络面板上方选择 Fetch/XHR,从请求列表中找获取文件目录的请求。请求名称可能带有 sort、list 等字样,具体以网页实际请求为准。
  7. 点击请求,在右侧选择 Headers/标头。
  8. 向下找到 Request Headers/请求标头,再找到 Cookie。不要选成响应标头中的 Set-Cookie。
  9. 复制 Cookie 后面的完整值,通常是一长串由分号分隔的 名称=值。不要只复制其中某一个字段,也不要把整段请求标头一起复制。

可以右键 Cookie 这一行,选择“复制值/Copy value”;没有这个选项时,展开并选中完整内容复制。填入 AList 时,只粘贴值,不加 Cookie: 前缀,不额外加引号。

如果请求没有 Cookie,换一个真正访问文件列表的请求,确认当前账号仍在登录状态。不要从未登录页面、登录二维码图片或无关静态资源里取值。

Cookie 是登录凭据。 保存在自己的 AList 里即可,不要放进公开教程、截图、评论或在线 Cookie 检测工具。退出登录、修改账号安全设置或服务端会话变化后,它可能失效。

在 AList 新增夸克存储

回到 AList 后台,点击 左侧“存储” → 上方“添加”,按照下面填写:

字段 怎么填
驱动 选择“夸克/Quark”,先不要选 QuarkTV
挂载路径 /夸克网盘
序号 例如 2,数值越小通常越靠前
Cookie 粘贴刚刚获取的完整 Cookie 值
根文件夹 ID 0,表示从夸克根目录开始
Web 代理 初次按普通下载链路使用时开启
下载代理 URL 没有自建代理就留空
WebDAV 策略 如需使用 WebDAV,普通链路先选“本机代理/本地代理”
使用转码地址 如果版本提供此项,先关闭,基础访问正常后再按需开启

其余字段先保留默认,滚动到页面下方,点击 添加/保存。

然后按这个顺序验收:

  1. 返回存储列表,确认“夸克网盘”没有认证或初始化错误。
  2. 点击左侧 主页,进入“夸克网盘”。
  3. 对照夸克官网,确认文件夹名称和内容正确。
  4. 下载一份小文件,检查能否完整打开。
  5. 再测试视频预览。能列目录、能下载、能播放,是三个不同的检查点。

AList 的挂载路径 /夸克网盘 是网页入口名,根文件夹 ID 0 是夸克接口里的目录标识,两者不能互换。夸克各版本选项见夸克驱动文档。

只展示夸克里的某个文件夹

如果只想挂载“影视”目录:

  1. 在夸克网页版打开“影视”文件夹。
  2. 查看浏览器地址栏,找到对应的目录 ID。网页地址可能包含 list/all/目录ID 或多层目录信息,要取当前文件夹对应的那段 ID。
  3. 回到 AList 存储列表,找到夸克那一行,点击 编辑。
  4. 把“根文件夹 ID”由 0 改成该文件夹的 ID,挂载路径仍可以保留 /夸克网盘。
  5. 保存后回到主页刷新,检查入口内是否直接显示“影视”文件夹里的内容。

不要把整个网页 URL 填进去,也不要把“影视”这两个字当作 ID。拿不准时,先用 0 验证账号连接,再调整范围。

能看到目录,却下载不了或播放很慢

普通夸克下载链路对请求头、账号状态和代理方式有要求。本地代理表示文件经过 NAS 中转,大致是:

夸克网盘 → 群晖上的 AList → 你的浏览器或播放器

这里的“本地”指部署 AList 的设备,也就是群晖。人在外面访问时,NAS 所在网络的上行带宽也会影响速度;AList 不能解除网盘自身的账号权益和限速。

如果版本里有 “使用转码地址”,可以在基础挂载正常后开启,再测试夸克视频。该选项使用转码流,画质和原文件可能不同,也不代表所有普通文件都能直连下载。

Web 代理与 WebDAV 策略要分别设置。 网页能下载而播放器失败时,还要检查 WebDAV 所选策略、账号权限和客户端访问地址。出现问题先测试小文件,避免一上来用大视频把多个问题混在一起。

夸克 TV:使用扫码授权的另一种方式

如果“驱动”列表里提供 夸克 TV/QuarkTV,也可以尝试扫码方式。它与普通 Quark 驱动分开配置,不需要复制 Cookie,但支持的操作范围有差异。

  1. 在 存储 → 添加中,驱动选择“夸克 TV/QuarkTV”。
  2. 挂载路径填写 /夸克TV,根文件夹 ID 保留 0。
  3. 刷新令牌、Device ID、Query token 等授权字段先留空,按驱动页面要求保存。
  4. 回到 存储列表,查看该条目出现的二维码;如果没有显示,找列表右上方的布局切换按钮,切换列表/表格布局后再看。
  5. 使用手机夸克 APP 扫码,在手机上确认授权。
  6. 授权完成后,按驱动文档说明将这条存储禁用一次,再重新启用。
  7. 等待状态刷新,回到首页打开“夸克TV”,测试列目录和下载。

授权成功后相关令牌由程序自动填写。二维码过期则重新获取;不要把其他教程里的令牌、设备 ID 拼到自己的授权信息里。

TV 驱动主要用于列目录和下载,不能按普通网盘管理驱动期待上传、删除等操作。扫码授权、接口可用性和账号权益会变化,实际使用时要再次核对驱动说明。

其他网盘怎么添加:以阿里云盘 Open 为例

其他网盘也从 存储 → 添加 → 选择驱动进入,但授权信息不能通用。夸克用的 Cookie,不能直接用来挂阿里云盘;不同服务的根目录 ID 也不相同。

阿里云盘可以按下面操作:

  1. 打开 AList 的阿里云盘 Open 文档,在“刷新令牌”部分点击“获取刷新 Token”。从文档进入当前授权工具,避免使用旧教程中已经失效的地址。
  2. 按页面提示登录或扫码,确认授权对象与权限,获得 refresh_token。
  3. 回到 AList 存储 → 添加,驱动选择 阿里云盘 Open。
  4. 挂载路径填写 /阿里云盘,在“刷新令牌”中粘贴刚获得的 refresh_token。
  5. 根文件夹 ID 先填写 root。如果要限定某个目录,在阿里云盘网页版进入该文件夹,取地址中 folder/ 后对应的文件夹 ID。
  6. 普通用户保留客户端 ID、客户端密钥的驱动默认设置;使用自建开发者应用时才填写配套参数。
  7. 根据自己文件所在位置选择“云盘类型”,保存后回到首页验证。若目录内容与预期不同,核对资源库/备份盘选项。

百度、OneDrive、天翼等网盘同样需要按各自驱动说明获取凭据。不要把夸克的根目录 ID 0 套到所有服务上。比如 115 Open 文档当前已提示接口关闭,就应先核对替代驱动,不能因为旧教程有选项便认定仍然可用。

身份与权限:管理员、普通用户、游客分别怎么用

文件接进来之后,再决定谁能访问。建议先保持游客关闭,用管理员确认存储正常,再给需要访问的人单独创建账号。

管理员与游客有什么区别

管理员负责添加存储、修改系统设置、管理账号,权限很高。日常给家人使用,单独建普通账号更方便控制范围。

guest 是未登录访问者使用的游客身份。给 guest 设置密码,不能变成“访客先输密码才能访问”的登录方案;需要账号认证时,创建普通用户。

检查游客状态:

  1. 后台左侧点击 用户。
  2. 找到 guest 那一行,点击 编辑。
  3. 确认 停用处于勾选状态,保存。
  4. 新开浏览器无痕窗口访问 AList,检查是否要求登录。

如果以后确实需要匿名展示,先为游客限制好允许访问的目录和权限,再取消“停用”,并在未登录窗口实际验证展示范围。

新版先创建角色,再创建用户

新版后台有 角色栏目,用户通过角色获得对应目录和操作权限。下面以“家人只能浏览 /volume1/共享”为例。先确认这个目录已经存在,必要时在群晖 File Station 中创建。

  1. 点击后台左侧 角色。部分版本将其放在“权限”分组下。
  2. 点击上方 添加,角色名称填写“家人只读”,描述按需填写。
  3. 在“基本路径”或目录选择树中展开 /volume1,只选择其下的 /volume1/共享。不要把根路径 / 或整个 /volume1 一起勾选。
  4. 在“权限”下拉框中勾选 检查路径限制,让访问范围限制在角色覆盖的目录内。
  5. 只用网页浏览时,不添加上传、删除、重命名、移动等修改权限。需要播放器或文件管理器接入时,再勾选 WebDAV 读取。
  6. 保留“无密码访问”“可以看到隐藏”等权限为关闭状态,除非明确需要。
  7. 点击 保存。
  8. 再点击左侧 用户 → 添加,用户名填写例如 family,设置单独的登录密码。
  9. 在“角色”中只选择刚创建的“家人只读”,检查没有额外选择覆盖 / 的其他角色;“停用”不要勾选,保存。

新版某些界面的用户“基本路径”可能固定显示 /,或不再提供可编辑输入框。此时通过角色配置目录范围即可,不能把修改登录落点当成完成授权限制。多个角色的权限可能叠加,所以额外授予一个大范围角色,会扩大用户能访问的内容。

保存后新开无痕窗口,用 family 登录:确认能进入共享目录;再尝试访问 /volume1 的其他目录和其他网盘,确认访问受到限制;同时检查不能上传、删除。权限配置依据可对照用户文档和角色表单源码。

旧版没有“角色”栏目怎么办

旧版常把基本路径和权限直接放在 用户 → 添加/编辑里:用户名、密码分别填写;“基本路径”选择要开放的 AList 目录;“权限”只开需要的操作;保持用户未停用,再保存。

这里选择的是 /volume1/共享 这样的 AList 路径,不是 /volume1/cloud sync/本机存储。设置后同样使用普通账号验证范围。新旧权限模型有区别,升级后也应重新检查,不能直接沿用“填了基本路径就一定隔离”的判断。

给单独的文件夹加密码

“用户登录密码”用于登录账号;“目录密码”用于网页访问某个目录,两者可以同时使用。下面以 NAS 本机目录为例;夸克目录同样在“元信息”添加规则,只需把路径换成 /夸克网盘/私人资料。

例如想给 NAS 的 /volume1/私人资料 添加目录密码:

  1. 在后台左侧点击 元信息。
  2. 点击上方 添加。
  3. “路径”点击选择按钮,定位到 /volume1/私人资料;也可以输入完整 AList 路径。
  4. 在 密码框中填写目录访问密码。
  5. 如果子目录也要验证密码,勾选紧跟在“密码”字段旁边的“应用到子文件夹”。
  6. 写入保持关闭;它用于开放创建目录、上传等能力,与密码设置无关。
  7. 隐藏、顶部说明、说明等字段暂时留空,点击 添加/保存。
  8. 使用无痕窗口,以没有“无密码访问”权限的普通账号进入该目录,检查是否出现密码提示,再测试子目录。

管理员或具有“无密码访问”权限的用户可能直接进入,所以用管理员测试不能准确反映普通用户的体验。

还有一个必须分清的限制:元信息目录密码不用于 WebDAV 鉴权。 WebDAV 需要通过账号、角色路径和 WebDAV 权限控制访问。目录加密码也不会给网盘原文件进行内容加密。具体规则见元信息文档。

接入播放器或文件管理器:WebDAV 怎么填

网页访问正常后,可以再连接支持 WebDAV 的客户端。

  1. 在 AList 后台为对应普通账号或其角色开启 WebDAV 读取。
  2. 打开客户端,新增一个 WebDAV 连接。
  3. 如果软件提供“完整 URL”输入框,填写 http://192.168.1.10:5244/dav/。
  4. 如果分开填写:服务器填 192.168.1.10,端口填 5244,协议选 HTTP,路径填 /dav/。有的软件路径框不要求开头斜杠,按客户端提示调整。
  5. 用户名、密码使用 AList 普通账号的登录凭据。
  6. 保存连接,检查能否浏览被授权的目录并读取一份小文件。

局域网之外,需要换成实际可访问的 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 文件和云盘原文件的备份。

准备更新时:

  1. 记下当前 AList 版本、镜像标签及挂载配置。
  2. 在 Container Manager 中只停止 alist 项目,使默认 SQLite 数据库停止写入。
  3. 在 File Station 中把整个 alist 项目目录复制到另一个受保护的备份目录,保留原配置。
  4. 按目标版本说明更新镜像或标签,重新构建该项目;如果有重新拉取镜像选项,确认启用。
  5. 启动后检查登录、NAS 目录、夸克下载和普通账号权限。

如果更新后需要回退,旧镜像与旧版配置备份应配套恢复;新数据库可能发生结构变化,单纯降级镜像未必可用。

这套操作会让 AList 在备份和重建期间短暂不可用,只需操作对应项目。无需为此重启群晖、整个容器服务或已有 FRP 服务。

写在最后

AList 配置最容易出错的地方,是几个看起来相似的概念:NAS 的真实路径、容器里的路径、网页挂载路径;管理员身份、普通账号、游客;登录密码、目录密码和网盘凭据。

把这些分清,再按“先启动容器 → 挂本地目录 → 接夸克 → 配权限 → 测试 WebDAV”的顺序往下走,就能逐步确认每一步有没有成功。

对我来说,把 NAS 和网盘整理到一个入口,价值在于少切换几个应用,也更清楚自己的文件放在哪里。先把常用的几个目录配好、把访问范围确认好,后面再增加其他网盘,会省心很多。

— 完 —

参考资料

暂无评论

发送评论 编辑评论


				
|´・ω・)ノ
ヾ(≧∇≦*)ゝ
(☆ω☆)
(╯‵□′)╯︵┴─┴
 ̄﹃ ̄
(/ω\)
∠( ᐛ 」∠)_
(๑•̀ㅁ•́ฅ)
→_→
୧(๑•̀⌄•́๑)૭
٩(ˊᗜˋ*)و
(ノ°ο°)ノ
(´இ皿இ`)
⌇●﹏●⌇
(ฅ´ω`ฅ)
(╯°A°)╯︵○○○
φ( ̄∇ ̄o)
ヾ(´・ ・`。)ノ"
( ง ᵒ̌皿ᵒ̌)ง⁼³₌₃
(ó﹏ò。)
Σ(っ °Д °;)っ
( ,,´・ω・)ノ"(´っω・`。)
╮(╯▽╰)╭
o(*////▽////*)q
>﹏<
( ๑´•ω•) "(ㆆᴗㆆ)
😂
😀
😅
😊
🙂
🙃
😌
😍
😘
😜
😝
😏
😒
🙄
😳
😡
😔
😫
😱
😭
💩
👻
🙌
🖕
👍
👫
👬
👭
🌚
🌝
🙈
💊
😶
🙏
🍦
🍉
😣
Source: github.com/k4yt3x/flowerhd
颜文字
Emoji
小恐龙
花!
上一篇
下一篇