简介面向绿联 DX4600 及 DH2600 NAS 用户的 Docker 实操指南以 Alist 安装与网盘挂载为主线解决在 NAS 上统一访问阿里云盘、115 网盘等资源的配置问题。教程全程按步骤展开从镜像仓库搜索 xhofe/alist、下载镜像、创建容器到高级模式下的存储空间路径选择、本地端口 5244 设置、重启策略建议再到通过容器日志提取初始密码并完成后台登录均有配图说明。阿里云盘挂载部分重点讲解刷新令牌获取115 网盘挂载部分则演示 F12 抓取 Cookie 的详细操作其他网盘可参照同样方式添加。压缩包仅含 1 个 PDF 文件大小 2.91MB内容以图文对照方式组织便于边看边操作。该资源已有 908 人学习下载适合希望快速掌握 NAS Docker 网盘挂载方法的用户教程同时注明群晖与极空间在操作上的差异可避免跨设备照搬时出错。1. 绿联 DX4600 与 Docker 里的 Alist给网盘开一个统一入口如果你手头正好有一台绿联 NAS把 Alist 跑进 Docker 这一步基本等于给所有网盘开了个统一入口。这份教程最初是给 DH2600 用户写的但操作路径对绿联 DX4600 以及绿联云其他机型同样有参考价值容器创建的流程走的是同一套界面逻辑群晖、极空间用户则会发现路径和权限设置完全两样。读完你能得到一个可自启的 Alist 容器挂上阿里云盘和 115 网盘所有网盘文件用一个地址就能看全追剧、整理资源、跨盘拷贝都会顺手很多。适合刚拿到 NAS、第一次打开 Docker 页面的新手也适合照群晖教程在绿联上翻过车的用户。全文最容易被忽略的是存储映射和 cookie 抓取这两处后面展开讲。2. 把 xhofe/alist 装进绿联镜像选型、存储映射和端口参数一次讲清这一步看起来只是「下载镜像 → 建容器」实际上绿联 Docker 的容器创建页签里绝大多数默认值都不是给 Alist 准备的。原教程的顺序是先搜镜像再改配置我按自己的习惯倒过来讲先让你明白四个页签里哪些要改、为什么改再跟着点就不会觉得每一步都在猜。2.1 镜像选型为什么搜 xhofe 而不是 alistAlist 官方维护的 Docker 镜像就在 Docker Hub 上名字是 xhofe/alist。绿联 Docker 页面的「添加」弹窗里官方库 URL/镜像名称一栏直接输入 xhofe 或者 xhofe/alist回车后选中第一条确定剩下的下载交给后台。如果你习惯 SSH 操作UI 上的「添加」等价于在终端里执行docker pull xhofe/alist:latestxhofe/alist:latest是官方推送的最新稳定镜像:latest在 NAS 场景下够用不必锁版本号。下载完成后页面上会出现 All done如果本地镜像列表里没有先点右上角刷新这是绿联 Docker 页面典型的缓存问题等半分钟再刷新一次基本都会出现。需要注意一个搜索习惯不要在镜像名前面脑补 docker.io/ 前缀绿联的搜索框会自动补全官方仓库地址。另外镜像下载慢是常事第一次拉这个镜像大概几百 MB如果卡在进度条不动常见做法是先去 Docker 的 registry mirror 加速设置里配好镜像加速地址再回来重新拉别反复删除重建镜像层的断点续传比你想的可靠。2.2 创建容器名称、重启策略、存储映射、端口镜像下载完以后点「创建容器」。这里先把名称改成 alist 或你习惯的名字然后打开高级模式。高级模式会展开全部页签下面四个地方是按 Alist 需要改的。提示容器名称只影响你在绿联界面里的辨识不影响 Alist 功能但建议别用默认的随机字符串后面查日志、建快捷方式都会省事。第一处是重启策略。Alist 挂载多个网盘后进程偶发退出是正常现象选择「容器退出时总是重启容器」相当于给了它一个守护容器挂了会被自动拉起。如果你选了「不自动重启」一次手动关机后再开机Alist 不会自己回来到时候你人在外面就打不开网盘页面。群晖那边更多人习惯选「除非停止」绿联上这个选项也有但我建议按原教程选「总是重启」。第二处是存储空间。点「自动」选择你的 Docker 存放盘比如 M.2 硬盘 2然后依次展开 Docker alist data 并双击选中。我强烈建议你在这一步之前先用文件管理器在存储空间根目录把Docker/alist/data这三层目录建好再回来映射。因为绿联的路径选择器在目标目录不存在时不会帮你创建选错会直接映射成一个空目录或失败。选中后务必把右侧「只读」改成「读写」Alist 要把配置、数据库和日志写进去只读会导致容器能启动但保存不了任何变更。这一处映射的完整含义是把宿主机上的/xxx/Docker/alist/data目录挂载到容器内部的/opt/alist/data。Alist 的配置文件 config.json、数据文件 data.db 都在这个目录里以后你备份、迁移、重置密码都靠它。第三处是端口。本地端口写 5244容器端口保持 5244。本地端口可以改成别的数字比如 5245只要不和其他容器冲突就可以但新手学这套教程时不必改后面访问地址直接http://NAS 的 IP:5244最省心。需要说明的是绿联界面里的本地端口对应-p参数的宿主机侧容器端口对应容器侧Alist 默认监听 5244容器侧不要动想改容器侧也不是不行但那就得进容器改配置划不来。如果你平时走 SSH上面这几步等价于这条命令docker run -d \ --namealist \ --restartalways \ -v /volume1/docker/alist/data:/opt/alist/data \ -p 5244:5244 \ xhofe/alist:latest参数说明-d后台运行--restartalways对应「容器退出时总是重启容器」-v前面是宿主机目录、冒号后面是容器内挂载点-p冒号左侧是宿主机端口、右侧是容器端口。命令里的/volume1/docker/alist/data是群晖路径写法绿联 UI 操作会自动带出真实路径无需手填SSH 时按你存储空间的实际情况写。到这里容器创建完成回到容器管理把它启动。启动后建议顺手点右边的「快捷方式」在桌面生成入口也可以直接浏览器访问http://NAS 的 IP:5244。第一次打开会看到一个纯白的登录页账号默认是 admin密码不在这里它打印在容器日志里。2.3 第一次登录日志里的初始密码去哪找Alist 首次启动会随机生成一个 admin 密码并且只输出到容器日志里一次。原教程让你在容器管理 → 详情 → 日志里往上翻找到 password 那一行复制后面的值去登录。这一步对新手来说最容易翻车原因是日志窗口默认停在最后而密码行可能已经滚过去了要往上拖。如果你不方便在界面上翻SSH 执行下面这条更直接docker logs alist 21 | grep -i passworddocker logs按时间顺序输出日志grep 过滤出密码行-i忽略大小写避免有的版本输出 Password、有的输出 password。执行完拿到的一串随机字符就是初始密码。登录进去以后第一件事改密码左侧「用户」→ admin → 编辑 → 输入新密码保存。改完会被要求重新登录这是正常现象。另一个安全细节是 guest 账号原教程里也提到了guest 默认有权限虽然不是超级管理但建议把它的密码改掉或者直接停用。很多人在这一步跳过后面 Alist 暴露到公网才发现 guest 能看目录那就不叫踩坑叫裸奔了。3. 挂载阿里云盘与 115 网盘刷新令牌和 Cookie 的抓取与填写边界Alist 容器跑起来只是第一步真正让它有用的动作在「存储」页签里。点左侧「存储」→「添加」会看到一大串驱动列表阿里云盘、115 网盘、夸克、天翼云盘都在里面。这一章的坑不在于选哪个驱动而在于「刷新令牌」和「Cookie」这两个字段很多人把它和账号密码搞混。3.1 添加存储先搞清楚这几个字段再说每个驱动的表单长得不一样但有四个通用字段是共通的挂载路径、驱动名、刷新令牌或 Cookie、读取策略。字段含义常见错误挂载路径Alist 虚拟目录形如 /aliyun、/115有人填成 /mnt/data以为像 Linux 挂载磁盘驱动对应具体网盘的 API 实现选错驱动会直接 fail刷新令牌 / Cookie用于授权访问网盘把 access_token 当 refresh_token 填缓存策略目录列表的缓存方式默认即可不必改挂载路径是 Alist 内部的虚拟路径不是宿主机路径也不是网盘路径。它决定你在 Alist 页面里看到哪个目录名比如填/aliyun访问http://NAS:5244/aliyun就是阿里云盘的内容。这个字段在 Alist 文档里也叫 mount path建议全用英文和斜杠开头。缓存策略默认值就够用改动它只会影响目录列表的刷新时机对小白来说没有任何收益。3.2 阿里云盘拿到刷新令牌而不是 access_token原教程在阿里云盘这一步写得很简略「将方框内的 token 值复制后填入刷新令牌内」。这里补全获取流程。Alist 官网alist.nn.ci每个驱动都有一页对应的文档阿里云盘 Open 驱动那一页会提供扫码授权入口。你在那页扫码并确认授权后会得到一个字符串那才是 refresh_token。注意授权返回的长字符串中refresh_token 和 access_token 是分开的。access_token 短过期后失效refresh_token 长用来自动续期。填错成 access_token 的典型症状是「添加后状态短暂有效过几小时就变 fail」。把 refresh_token 填进「刷新令牌」框其余字段按默认保存即可。状态栏第一次同步可能出现 pending等几秒刷新再看变成 work 或正常就说明挂载成功。想手动触发重新校验编辑该存储再保存一次就行不用删除重建。阿里云盘这里有个体验差异值得说同一个阿里云盘账号你之前在网页端用过的文件都能看到但如果你的文件在「备份盘」或「资源库」这种分流目录里需要在驱动配置里指定挂载的是哪个库默认挂载的是备份盘。原教程没提这点因为大多数人的文件就在备份盘遇到「挂上了但目录是空的」时回来检查这一项。3.3 115 网盘F12 取 Cookie 的三个边界115 网盘在 Alist 里的驱动基于网页版 Cookie所以获取步骤是电脑浏览器登录 115 网页版 → 按 F12 打开开发者工具 → 再按 F5 刷新页面 → 在 Network 面板里点任意一条请求 → 在 Request Headers 里找到 Cookie 一整段复制。这里有三条边界要守住。第一复制的是值不是整行。很多人复制时把Cookie:这个字段名也带进去了粘贴到 Alist 里就会验证失败。第二Cookie 和会话强绑定不要在复制完以后退出登录也别换浏览器一旦退出这个 Cookie 很可能立即失效。第三Cookie 的时效没有明文约定实际经验是一段时间后会失效等到 Alist 里 115 的状态变成 fail重新抓一次填进去即可。抓 cookie 也可以直接看页面存储但浏览器里直接抓 Cookie 是通用做法夸克、天翼云盘等走 Cookie 的驱动都是同一套边界值不带前缀、不短斤缺两、失效了重新抓。走 API 令牌的驱动则另外一套逻辑别混用。保存 115 后同样确认状态。如果 fail先检查是不是带上了前缀再检查是不是复制前退出过登录最后考虑是否在网页版登录后又动过设备验证。4. 避坑排查绿联 Docker 装 Alist 的五个典型翻车现场把流程完整跑过一遍的人大概率会在下面五个位置上翻车。我把现象、原因、解决分开写你可以直接对照自己的情况。4.1 镜像与容器的三个翻车点第一个翻车点镜像下载完成本地镜像列表里却看不到。现象是「All done」已经出现回镜像管理刷新两三次还是没有 xhofe/alist。原因多半是页面缓存没有及时刷新或者 Docker 服务在下载完成瞬间还没有把元数据写进列表。解决点右上角刷新按钮等 10 到 30 秒再刷新一次再不行先在 SSH 里执行docker images | grep alist确认镜像实际存在然后切到「容器管理」再切回来强制列表重新加载。不要在看不到镜像时重复下载同一个 tag 重复拉不会额外占多少流量但会白白浪费时间。第二个翻车点存储空间那里选不到想要的目录或者选完以后容器启动失败。现象双击展开 Docker alist data 时 data 目录不存在选择器停在上一级。原因绿联 UI 不像命令行会自动 mkdir目标目录必须提前建好。解决先去文件管理器把 Docker/alist/data 逐层创建再回来映射。如果你已经用别的路径创建了容器也不想重建可以在容器详情里修改挂载并重启容器但改挂载前记得先停容器不然绿联会提示你容器占用中。第三个翻车点端口冲突导致容器一直在重启。现象创建容器时本地端口填了 5244但容器状态反复显示异常或者页面根本打不开。原因NAS 上另一个容器或系统服务已经占用了 5244。解决把本地端口改成 5245 之类的空闲端口容器端口保持 5244 不动也可以 SSH 执行netstat -tlnp | grep 5244看是谁占的。改完端口以后快捷方式和浏览器书签的地址都要同步改白屏时先检查这一步。4.2 登录与挂载的两个翻车点第四个翻车点日志里找不到初始密码。现象容器已经 running但日志窗口拉到顶也没看到 password。原因要么容器数据目录不是空的Alist 复用了旧配置没有重新生成随机密码要么日志输出量大密码行被冲刷了。解决第一次启动一定会有密码行往上翻一般能找到如果目录里已有 config.json说明你之前跑过容器密码是你自己设的那一个不是初始密码。想直接重置就用容器终端执行./alist admin set 新密码这是 Alist 提供的标准重置命令执行完用新密码登录。第五个翻车点存储添加后状态是 fail。现象阿里云盘或 115 填完保存右边状态栏显示 fail 而不是 work。原因阿里云盘多数是 refresh_token 填成了 access_token115 多数是复制时带了Cookie:前缀或者复制前退出过登录。解决去官方文档重新走一遍授权流程重新复制保存后再等几秒刷新状态。如果两个都重试过还是 fail检查系统时间NAS 时钟如果偏离太多HTTPS 握手会失败这个问题排查时很容易忽略但绿联上确实遇到过。5. 日常维护三件事验证挂载、找回密码、固定入口Alist 跑起来、网盘挂完后面其实是日常使用问题它到底通不通、密码忘了怎么办、每次访问怎么最顺手。我一般会固定做三件事来收尾。验证挂载最直观的办法是打开浏览器http://NAS 的 IP:5244在页面里应该能看到 /aliyun、/115 两个目录点进去每个目录里能列出文件。想自动化一点SSH 执行curl -s http://127.0.0.1:5244/d/aliyun | head -20返回的内容是 Alist 的 JSON 目录列表能看到文件名就说明容器、存储、网络三层都通了。注意 curl 要在 NAS 上执行用 127.0.0.1 是验证本机服务从外部验证就换成局域网 IP。密码这块是最容易忘记的。初始密码改过一次又忘了不用重装容器。绿联容器详情里一般有终端入口进去后执行 Alist 自带的重置命令没有终端入口就先 SSH 到 NAS再执行docker exec -it alist ./alist admin set 你的新密码执行完立即生效重新登录即可。数据目录里的 data.db 会被更新所以这招不会动到你已挂载的网盘配置。唯一的依赖是容器还在如果容器都删了只要你备份了 data 目录重新映射回来配置依然在。固定入口方面绿联容器管理页右侧的「快捷方式」按钮可以在桌面生成图标点击直达 Alist 页面如果是在局域网外访问需要给 NAS 配置端口转发或者在路由上做远程访问这部分各家路由器差异大按自己的设备来。网上有些人喜欢把 Alist 反代到子域名这属于进阶玩法前提是你的公网和域名都齐了再做。从那以后我每次在绿联上部署完 Alist都会强制走一遍「curl 验证挂载 → 确认密码 → 生成快捷方式」这三步再顺手确认一次重启策略是「总是重启」。这半小时的收尾工作替我省掉了后面不知道多少次的半夜排查。希望帮到你。本文还有配套的精品资源点击获取