简介《Docker 绿联 DX4600 安装 Alist 及挂载网盘图文教程》是一份面向绿联 NAS 用户的 Docker 实操指南适用于绿联 DX4600、DH2600 等型号通过部署 Alist 将阿里云盘、115 网盘等常用网盘挂载到 NAS解决多网盘分散登录、无法集中管理的问题。教程以图文形式呈现步骤详实全程干货特别适合初次接触 Docker 的小白用户群晖或极空间用户操作界面略有差异需适当变通。资源为单个 PDF 文件压缩包大小仅 2.91MB。教程从 Docker 主界面的镜像管理开始讲起依次涵盖本地镜像添加、xhofe/alist 镜像搜索与拉取、容器创建、高级模式配置、存储空间映射、端口设置、重启策略选取再到 Alist 初始密码日志查找、用户密码修改以及阿里云盘刷新令牌、115 网盘 Cookie 的获取与填写等全部关键环节。每一步均配有截图与文字说明并穿插了避免踩坑的提示例如建议提前创建 data 目录、本地端口可自定义但小白建议保留 5244、重启策略推荐选择容器退出时总是重启等让读者能按图索骥顺利完成部署。目前该资源已有 908 人学习下载是绿联用户快速上手 Docker 网盘挂载的高性价比参考。按教程操作不仅能把 Alist 稳定搭起来还能将阿里云盘、115 等常用网盘接入 NAS 统一管理大大提升日常文件访问效率。1. Docker 跑 Alist 挂网盘让 DX4600 从私人硬盘变成网盘中转站绿联 DX4600 和 Alist 的组合解决的是一个很实际的别扭你的数据散在阿里云盘、夸克、115 甚至百度网盘里而 NAS 上只有本地硬盘想看网盘里的一部电影得开 App、投屏、等缓冲。Alist 这类工具把分散的网盘聚合成一个 Web 入口Docker 化部署意味着升级、回滚、备份都有章法不污染 DX4600 本身的系统环境。这篇文章就是顺着「Docker 绿联 DX4600 安装 Alist 及挂载网盘」这个主题把从创建容器到挂载网盘、再到日常维护的完整路径讲清楚新手照步骤能跑通已经跑过的人也能对照着排排查。本文所有操作都在 DX4600 的本地局域网内完成适合有一台 DX4600、想统一管理网盘资源的人也适合刚买 NAS 还没想好 Docker 用来干嘛的人。2. 准备阶段确认架构、拉取镜像、敲出第一行 docker run2.1 为什么用 Docker 跑 Alist而不是等 UGOS 应用商店上架绿联 DX4600 的 UGOS Pro 系统自带应用商店但里面没有 Alist这也是很多 NAS 用户绕不开 Docker 的原因。Alist 本身是一个 Go 写的单二进制程序直接装在系统里也不是不行但升级时容易把系统的依赖搞乱卸载也不干净。放进 Docker 之后程序文件、数据目录、端口映射全部由容器隔离管理你只需要关心两个东西容器镜像和挂载出来的数据目录。我一般会在 DX4600 上单独建一个/volume1/docker/alist目录把 Alist 的数据文件全部放这里容器随便删、随便重建只要数据目录还在挂载配置和网盘 token 都还在。这也是后面所有操作的核心思路容器是草稿纸数据才是正式文档。2.2 先用 uname -m 确认架构避免镜像拉错导致容器起不来DX4600 用的 Intel N100 处理器x86_64 架构理论上应该拉 amd64 的镜像。但 Docker 会自动根据平台拉取所以大多数时候你不需要手动指定。不过如果你从某些第三方镜像站手动拉镜像或者镜像本身是多架构但标注不规范就可能拉成 arm64 版本容器启动时直接报exec format error这一下就能卡住你好久。所以准备阶段第一件事是确认系统架构和 Docker 引擎状态。DX4600 需要在系统设置里把 SSH 开关打开然后用终端连上去执行uname -m docker version --format {{.Server.Version}} docker psuname -m输出x86_64表示架构没问题。docker version里的 Server 端版本是 NAS 上 Docker 引擎的版本确认它能响应说明服务正常如果卡在这里先去 UGOS 的 Docker 应用里看服务状态。docker ps能列出容器说明当前权限正常。2.3 两种创建容器的方式图形界面点选 vs SSH 命令直敲DX4600 的 Docker 应用提供图形界面适合不习惯打命令的人。创建容器时在镜像设置里填入 Alist 的镜像名然后在端口映射、存储空间、环境变量三个页面对应填写。这里的本质和命令行完全一样只是 UI 替你拼装参数。不过在 NAS 上我更喜欢直接 SSH 敲 docker run因为参数是显式写出来的哪一步配置错了看命令就知道。下面这条命令是目前在 DX4600 上最常用的一套参数docker run -d \ --name alist \ -p 5244:5244 \ -v /volume1/docker/alist/data:/opt/alist/data \ -e TZAsia/Shanghai \ --restart unless-stopped \ xhofe/alist:latest逐行解释一下-d表示后台运行SSH 窗口关了容器还在--name alist给容器命名后面所有 docker logs、docker stop 都通过这个名字操作-p 5244:5244把容器的 5244 端口映射到 NAS 的 5244 端口冒号左边是宿主机端口右边是容器内端口-v是做数据目录映射这是整个命令里最不能省的一项Alist 的配置数据库、日志都会写进这个目录-e TZAsia/Shanghai设置时区不设的话容器日志会比北京时间差 8 小时--restart unless-stopped告诉 Docker只要不是手动 stop系统重启后自动把这个容器拉起来。2.4 建完容器先做一次健康检查别急着进后台配网盘容器创建后不是万事大吉先确认它真的活着再继续。执行docker ps --filter namealist docker logs alist --tail 20 curl -sI http://127.0.0.1:5244docker ps看状态列是否为 Updocker logs看启动日志里有没有 panic 或数据库初始化报错curl -sI发一个 HEAD 请求正常的话会返回 HTTP/1.1 200。如果容器反复重启多半是数据目录权限不对检查/volume1/docker/alist目录是否当前用户可写。走到这里Alist 容器已经在 DX4600 上跑起来了浏览器访问http://NAS的IP:5244就能打开登录页。下一步处理初始密码和首次配置。3. 第一次打开 Alist从初始密码到能看见网盘列表3.1 浏览器打开 5244 端口第一次看到的不是配置向导和很多带安装向导的程序不同Alist 启动后直接进入登录页左边是用户名密码框右边是 Alist 的版本号和界面上的一些快捷入口。你第一次访问时是没有密码的因为 Alist 会在容器启动时随机生成一个 admin 密码打印在日志里。这个设计对刚上手的人不太友好很多人卡在这一步。其实密码就在容器日志里一行命令的事。3.2 从容器日志里翻出初始 admin 密码在 SSH 终端里执行docker logs alist 21 | grep -i password输出里会出现类似admin password: xxxxxxxx的一行冒号后面那串就是初始密码。注意日志可能比较长但只找包含 password 的那一行即可。如果日志里没有说明容器启动时间太久日志被滚动覆盖了用docker logs alist --since 2h只看最近两小时的输出。拿到密码后在登录页用 admin 登录进到主界面后第一件事是改密码。路径在界面左侧的「管理」—「用户」里找到 admin 这一行点编辑把密码换成你自己的。这一步不建议跳过因为 Alist 的密码是明文存在自己的数据库里的虽然它不会主动暴露给局域网外但默认密码挂在公网上等于裸奔。3.3 登录后先在设置里过一遍站点标题、前端方案、语言admin 登录后左侧菜单里能找到「设置」。这里有几个和日常使用直接相关的项值得先说清楚。站点标题是你访问 Alist 时浏览器标签页上显示的文字改成自己好认的名字即可。前端方案控制网页界面长什么样默认的就够用不用刻意换。还有一个容易被忽略的是「全局」页里的某些代理相关参数这部分先不动等挂载网盘之后再回来看。这里的核心原则是第一次登录后只改密码其他默认配置先别碰。因为 Alist 的默认配置已经能跑通基本功能改太多反而给自己增加排查难度。3.4 确认版本号方便以后处理升级和兼容性在登录页左下角或设置页里能看到当前 Alist 的版本号。Alist 迭代很快网上教程很多是按旧版本写的界面上按钮位置和字段名称会有细微差异。你看到的版本号是多少搜索问题时就把版本号带上能过滤掉一大堆过时内容。我自己习惯把第一次登录时的版本号记在手机备忘录里因为后面升级容器版本时万一新版有 bug 需要回退至少知道当时哪个版本是稳的。这也是 Alist 这类快速迭代项目的一个维护技巧。4. 挂载网盘全流程选驱动、拿凭证、调存储参数4.1 先分清两类用法把网盘当只读资源库还是把网盘当 NAS 的扩展盘挂载网盘之前先想清楚你的用途。如果你只是想把阿里云盘里的电影、夸克网盘里的学习资料统一在一个网页里访问那 Alist 默认的代理模式就行网页里点开文件直接播放。但如果你想通过 WebDAV 把网盘挂到电脑上当一个盘符用或者让 Emby、Jellyfin 直接扫描网盘目录那存储配置里的代理策略和 WebDAV 策略就得按另一套思路设置。这两种用法的配置差异主要在第四章 4.5 节里会详细讲。先把流程走通再回来调参数否则一上来就想两边兼顾往往会掉进一个「网页能看但挂载失败」的尴尬状态。4.2 存储驱动到底存的是什么一张表看懂常见网盘驱动Alist 后台左侧菜单「存储」是核心入口点「添加」后会让你选驱动类型下拉列表里有几十种网盘。常见驱动和认证方式如下表驱动类型认证方式适合人群主要坑点阿里云盘 OpenOAuth 授权需 App ID 和 Secret阿里云盘重度用户授权 token 会过期需要刷新夸克网盘Cookie 认证夸克网盘资源多的人Cookie 过期需要重新复制粘贴115 网盘Cookie 或 Open API115 老用户部分接口会被风控建议用 Cookie百度网盘OAuth 授权百度网盘资料多的人下载速度和 API 限制较明显OneDriveOAuth 授权国际网盘用户需要能正常访问微软服务才能授权表格里要特别留意「阿里云盘 Open」和旧版「阿里云盘」驱动不是同一个东西新版 Alist 推荐用「阿里云盘 Open」驱动。老驱动也能用但官方已经不积极维护token 刷新逻辑不如新驱动稳。4.3 亲手挂第一个网盘以阿里云盘 Open 为例的完整操作添加存储时驱动类型选「阿里云盘 Open」页面会要求填 App ID、App Secret并提供一个「获取 Token」的按钮。这里的流程是先在阿里云盘开放平台创建一个应用拿到 App ID 和 App Secret填进 Alist 页面然后点「获取 Token」浏览器会跳转到授权页面勾选同意后跳转回来Alist 自动把 refresh_token 填入对应字段。打开阿里云盘开放平台用你的阿里云盘账号登录创建一个「自用型应用」把应用类型选为「个人」然后记下 App ID 和 App Secret。回到 Alist 存储配置页把这两个值填进去点击「获取 Token」按页面提示完成授权。完成后刷新令牌区域会出现一串长字符串这就是 Alist 以后替你刷新凭证的凭据。接着设置「挂载路径」这里填/aliyun保存后访问http://NAS的IP:5244/aliyun就能看到阿里云盘里的文件。挂载路径建议用英文和拼音不要带空格和中文否则在 WebDAV 客户端里可能出现编码问题。保存后验证一下curl -sI http://127.0.0.1:5244/aliyun | head -5返回 200 说明挂载成功返回 404 说明挂载路径没生效检查存储列表里对应条目是否显示正常状态。正常的话存储列表里这一条会显示绿色或正常状态如果显示错误点击右侧「编辑」进去看错误信息大多是 token 失效或 App Secret 填错。4.4 夸克和 115 的 Cookie 方式拿到凭证、填进去、定期刷新夸克网盘的驱动认证方式不是 OAuth而是 Cookie。操作路径是用浏览器打开夸克网盘网页版登录后按 F12 打开开发者工具在「网络」标签里随便点一个请求在请求头里复制完整的 Cookie 字符串粘贴到 Alist 驱动配置的 Cookie 字段里。115 网盘的驱动配置分两种模式一种也支持 Cookie另一种走 Open API。对于大多数个人用户Cookie 方式更直接不需要去开放平台注册应用。115 的 Cookie 获取方式和夸克类似也是网页登录后从开发者工具里复制。这类 Cookie 认证的驱动有个通病网盘账号在网页端退出登录、修改密码、或长时间不用导致会话过期Alist 这边的凭证就失效了。现象是存储列表里这一条变红点编辑能看到「权限不足」「登录过期」之类的报错。解决办法是重新登录网页版复制新 Cookie 粘贴进来然后保存。整个过程不涉及脚本和抓包就是正常的登录和复制粘贴操作。4.5 存储配置里的四个关键参数代理、WebDAV 策略、缓存过期、下载直链存储配置页里有几个参数决定网盘体验值得逐个说清楚。第一个是「代理」它控制文件访问时经过谁的转发。默认是「本地代理」即文件流经过 Alist 容器转发到你的浏览器好处是网页播放、图片预览都稳定坏处是大文件下载时 Alist 容器会占用大量内存和带宽。如果你想用 Emby 这类工具直接拉网盘的视频建议把「代理」设为「302 重定向」让请求直接指回网盘源站Alist 只负责告知文件在哪不碰数据本身。第二个是「WebDAV 策略」Alist 支持把网盘内容以 WebDAV 协议暴露给局域网设备。这里有类似选择默认的「本地代理」适合文件读写量小的场景换成「302 重定向」后 WebDAV 客户端的读写请求会直接向网盘源站发起大文件复制速度明显更快。第三个是「缓存过期时间」意思是 Alist 会缓存网盘的文件列表结构多久再刷新。默认值足够日常浏览使用如果频繁在网盘里增删文件可以把缓存时间调小比如改成 30 分钟代价是每次打开目录都会多一次网盘请求。第四个是「下载直链」开启后 Alist 会给每个文件生成一个临时的直链地址搭配 IDM、Aria2 这类下载工具能直接拉满网盘带宽。注意直链有有效期过期后需要重新从页面获取。这四项参数在每次添加存储时都会出现建议第一次挂载时先保持默认确认浏览文件正常后再按需调整。调完记得点存储列表顶部的「刷新」按钮让配置生效。5. Alist 在 DX4600 上的五个踩坑现场现象、原因、解法5.1 网盘存储突然全部变红文件列表打不开现象前一天还能正常用的网盘第二天打开 Alist 全部目录报错存储列表里每一条都显示认证失败。原因大多是网盘的 refresh_token 或 Cookie 过期这和网盘账号本身的状态有关。阿里云盘 Open 驱动的 token 一般有效周期较长但如果你手动在网盘 App 里退出过登录或修改过账号密码token 可能立即失效。夸克、115 这种 Cookie 认证的更脆弱Cookie 一过期 Alist 拿到的就是「权限不足」的响应。解决不要随便删除存储条目删除后重新配置的成本很高。正确做法是进入存储列表点「编辑」重新走一遍认证流程。阿里云盘 Open 就点「获取 Token」重新授权夸克和 115 就去网页版复制新 Cookie 粘贴进来保存后回列表点「刷新」状态正常即恢复。提示定期检查 Alist 后台存储列表的状态养成每周看一次的习惯比出问题后再找原因省事得多。5.2 docker pull 镜像时卡住不动最后报超时现象在 UGOS 的 Docker 应用里拉取 Alist 镜像进度条一直不动或卡在某一个百分比最后报网络超时。原因Docker 默认从 Docker Hub 拉取镜像国内网络环境下拉取大镜像经常不稳定这和 NAS 本身没关系是线路问题。解决在 UGOS 的 Docker 设置里找到「镜像加速器」或「Registry 镜像源」配置项填入可用的镜像加速地址。国内主流云服务商都有公开的加速地址配置完成后重新拉取。注意加速器地址不是永久有效失效后容器拉取会再变慢到时重新找可用的地址替换即可。还有一个更省事的办法在一台网络状况好的电脑上下载镜像然后导出再导入到 NAS通过docker save和docker load两个命令完成迁移适合急着部署时应急。5.3 从网盘复制大文件到 NAS速度上不去或中途断掉现象通过 Alist 页面或 WebDAV 把一个几 GB 的视频从网盘复制到 NAS 本地速度只有几百 KB/s甚至复制到一半直接失败。原因存储配置里的代理和 WebDAV 策略还停在默认的「本地代理」模式所有数据都经过 Alist 容器中转大文件长时间占用容器进程稍微超时就被判定失败。解决进入对应存储的配置页把「代理」改为「302 重定向」保存后重试。如果之前是通过 WebDAV 挂载复制还要把「WebDAV 策略」同步改为「302 重定向」。改完配置后重开一次挂载会话速度通常会有明显改善。5.4 创建第二个实例时提示端口被占用bind 失败现象照着网上的教程想再起一个 Alist 容器用来做测试运行时提示port is already allocated。原因第一次创建容器时已经占用了宿主机的 5244 端口第二次还想用同一个端口必然冲突。也可能是之前创建的旧容器没删干净只是处于停止状态。解决先执行docker ps -a看所有容器旧容器如果确定不要了用docker rm 容器名删除释放端口。如果想保留两个实例共存改端口映射即可比如-p 15244:5244这样第二个实例的访问地址是http://NAS的IP:15244。注意映射端口时冒号左边是宿主机端口不能和已有的宿主机端口重复。5.5 容器日志时间和北京时间差 8 小时排障时对不上时间现象docker logs alist里显示的时间和 NAS 系统时间差 8 个小时排查问题时分不清哪条日志对应哪个时刻。原因容器默认时区是 UTC也就是零时区北京时间比 UTC 快 8 小时日志时间自然偏移。解决创建容器时加上-e TZAsia/Shanghai环境变量已创建的容器改环境变量后需要重建容器才能生效。具体步骤是docker stop alistdocker rename alist alist-bak再用加好环境变量的 docker run 命令重新创建用同一个数据目录挂载就行。前面的配置数据都在不用重新配。这个操作顺带演示了 Alist 容器无损重建的方式后面的升级流程也是同一套逻辑。6. 进阶升级不丢配置再把 Alist 变成 NAS 本地目录6.1 升级 Alist 的无痛流程备份、换镜像、重建容器Alist 版本更新快新版本往往带来新驱动和 bug 修复但直接在原容器上更新镜像不是好习惯。我的习惯是先把数据目录完整复制一份然后从镜像仓库拉取新版本再用新的镜像名跑一个和原来一模一样参数的新容器数据目录指向同一路径启动后确认功能正常再删掉旧容器。具体命令流程如下docker stop alist docker rename alist alist-old cp -r /volume1/docker/alist/data /volume1/docker/alist/data.bak docker pull xhofe/alist:latest docker run -d --name alist -p 5244:5244 \ -v /volume1/docker/alist/data:/opt/alist/data \ -e TZAsia/Shanghai --restart unless-stopped xhofe/alist:latest docker logs alist --tail 20docker stop先停旧容器docker rename让旧容器保留但不占名字复制数据目录是给你一个后悔药这一步不能省。新容器启动后先去后台存储列表确认所有网盘状态正常再回头删掉alist-old。如果新版有问题把旧容器 rename 回来并docker start即可回滚。6.2 用 rclone 把 Alist 挂载成本地目录让 UGOS 文件管理器直接看到网盘Alist 的 WebDAV 接口可以让你不通过网页直接把网盘挂成目录。在 DX4600 上SSH 进去安装 rclone然后配置一个 WebDAV remote 指向 Alist 的/dav路径再执行rclone mount挂载到/volume1/alist-mountUGOS 的文件管理器里就能直接浏览网盘内容拖拽文件就像操作本地目录一样。rclone 配置文件的 remote 部分类似这样[alist] type webdav url http://127.0.0.1:5244/dav vendor other user admin pass 用rclone obscure生成的加密密码挂载命令rclone mount alist:/ /volume1/alist-mount \ --allow-other --dir-cache-time 10m --daemonalist:/表示访问 Alist WebDAV 根目录/volume1/alist-mount是宿主机挂载点--allow-other允许其他用户访问这个挂载点--daemon让挂载进程后台运行。注意 rclone 需要由 DX4600 的系统包管理器或社区源安装装好后再执行上述配置。这个方案适合想把网盘当本地盘用的场景但和网页版比起来WebDAV 挂载对大目录的浏览速度略慢文件数量和网络延迟都会影响体验。6.3 局域网内其他设备怎么访问WebDAV 是比网页更实用的入口如果你的电脑、手机、电视盒子也想访问这些网盘内容Alist 的 WebDAV 接口是最通用的方式。地址是http://NAS的IP:5244/dav账号密码就是 Alist 的管理员账号。在 Windows 上可以用「映射网络驱动器」连接手机上大部分文件管理器也内置 WebDAV 协议支持。我自己现在是把 Alist 挂在两台设备上一台电脑映射网络驱动器一台电视盒子通过 WebDAV 播放网盘里的大片。日常使用下来的最大教训是每次升级 Alist 前一定先看一眼正在用的 WebDAV 会话跟家里人打个招呼否则升级期间文件管理器里的一片红会让他们以为 NAS 坏了。另一个习惯是定期导出 Alist 存储配置备份具体做法就是备份整个data目录那张熟悉的docker stop cp -r命令组合已经成为我维护 Alist 的肌肉记忆。希望这篇教程能帮你少走一段弯路。本文还有配套的精品资源点击获取