简介:这份图文教程面向绿联 DX4600 及 DH2600 用户,聚焦在 Docker 环境中部署 Alist 并挂载各类网盘的实际需求,适合刚接触 NAS 与容器、希望快速上手的小白用户,也适合需要一份可对照操作参考的进阶玩家。资源包内仅含 1 个 PDF 文件,压缩包大小约 2.91MB,以图文并茂的形式呈现,便于在电脑或移动端随时翻阅。教程从镜像搜索、容器创建、存储空间与端口设置,到初始密码获取、登录改密,再到阿里云盘、115 网盘等挂载流程均有覆盖,并附有 Alist 官网教程链接与 Cookie、令牌获取的排错思路。目前已有 909 人学习,说明内容经过一定规模验证。整体目录按操作顺序编排,步骤编号清晰,强调严格照做即可完成配置,能帮助读者少走弯路,快速搭建属于自己的网盘聚合入口。
1. 绿联 DX4600 上跑 Alist:为什么我建议你先别急着点“完成”
绿联 DX4600 这台机器到手之后,大部分人第一件事就是装 Docker 容器。Alist 算是被问得最多的一个——它能把你手头散落的网盘统一挂到一个网页界面里,局域网内任何设备打开浏览器就能访问,不用再挨个登录客户端。但我在帮人排查时发现,翻车的地方往往不是 Alist 本身,而是 Docker 容器创建时那几个参数:存储空间映射没选对,容器重启后配置全丢;端口填了却被其他容器占用;重启策略没设,NAS 一断电 Alist 就再也起不来。这篇记录的是我在绿联 DX4600 上从零装完 Alist 并挂载网盘的完整过程,适用于绿联云 DH2600 的 Docker 环境,群晖或者极空间的操作逻辑会有所不同。如果你手头正好有这台机器,照着走一遍,半小时内能跑通。
2. 装 Alist 之前的准备:镜像、目录和端口先定下来
2.1 确认 Docker 环境可用
绿联 DX4600 出厂系统里已经内置了 Docker 模块,不需要额外安装。进入系统主界面后,点击左侧的 Docker 图标就能进入管理页面。如果你之前没动过 Docker 相关设置,默认的镜像存储位置在系统盘上,但我不建议把 Alist 的数据放在系统盘——系统盘空间通常不大,而且万一系统出问题,数据迁移会很麻烦。
我一般会先确认两件事:Docker 服务是否正常运行,以及镜像存储路径是否指向了容量足够的硬盘。在 Docker 主页面能看到容器列表和镜像列表,如果都是空的,说明还没创建过任何容器,这是正常状态。
2.2 提前建好数据目录
这一步很多人会跳过,但它是后面存储空间映射的基础。打开绿联的文件管理器,在你打算存放 Docker 数据的硬盘根目录下,依次创建Docker>alist>data三层文件夹。我自己的习惯是放在 M.2 硬盘 2 里,因为那块盘容量大且读写速度快。
创建完成后,记住这个路径。后面在 Docker 容器配置里选择存储空间时,需要依次双击进入Docker>alist>data,选中data文件夹后点击右下角的选择按钮。这个目录会用来存放 Alist 的数据库和配置文件,一旦映射错了,容器重启后所有配置都会重置。
提示:目录名建议保持全小写,避免某些系统环境下路径识别出问题。
2.3 端口规划与冲突检查
Alist 默认使用 5244 端口。在绿联 DX4600 上,你需要把这个端口映射到 NAS 的本地端口。如果之前没装过其他占用 5244 的容器,直接填 5244 就行。但如果你已经跑了一些服务,建议先在 Docker 容器列表里扫一眼,看看有没有容器占用了这个端口。
常见做法是:本地端口填 5244,容器端口也填 5244,保持一一对应。小白强烈建议跟着默认走,不要随意改动。端口冲突的典型表现是容器启动后立刻退出,日志里会提示bind: address already in use。遇到这种情况,把本地端口改成 5245 或 5246 再试一次即可。
3. 拉取镜像并创建 Alist 容器:参数逐个说清
3.1 搜索并下载 xhofe/alist 镜像
在 Docker 主页面点击左侧“镜像管理”,然后点上方“本地镜像”,选择下面的“添加”按钮。在弹出的页面中,官方库的“URL/镜像名称”搜索框内输入xhofe,回车。列表中会出现xhofe/alist,选中第一个后点确定。
接下来就是等待镜像下载。下载时间取决于你的网络状况和镜像大小,通常几分钟内能完成。下载完成后会出现“All done”的提示,点“完成”关闭窗口。回到“本地镜像”页面,如果没看到刚下载的镜像,点一下右上角的“刷新”按钮。
# 如果你习惯用命令行操作,等效命令如下 # 注意:绿联 DX4600 的 Docker 界面操作和命令行操作结果一致 docker pull xhofe/alist:latest这条命令的作用是从默认镜像仓库拉取最新版的 Alist 镜像。latest标签表示最新稳定版。如果你需要固定版本,可以把latest换成具体的版本号,比如v3.30.0。不过对于大多数家用场景,用latest就够了,后续升级也方便。
3.2 创建容器时的关键参数
镜像下载完成后,在“本地镜像”列表里找到xhofe/alist,点击下方的“创建容器”。首先改一下容器名称,方便后期管理和辨识,比如改成alist。然后打开“高级模式”,点“下一步”。
这里有一个容易被忽略的点:重启策略。由于 Alist 成功后会挂载很多网盘,建议选择“容器退出时总是重启容器”。这样即使 NAS 意外断电或者 Docker 服务重启,Alist 也能自动恢复运行。当然,你也可以不选重启,但每次手动启动会比较麻烦。
别急着点下一步,先点上方“存储空间”标签。在“自动”这里选择你自己存放 Docker 的硬盘,也就是之前创建Docker/alist/data的那块盘。然后依次双击选择Docker>alist>data,点到data文件夹后,点右下方选择。接着把右边的“只读”点一下改成“读写”。这一步很关键——Alist 需要写入配置文件,只读模式会导致容器启动失败。
# 等效的 docker run 命令,方便你理解参数含义 docker run -d \ --name alist \ --restart always \ -v /mnt/m2/docker/alist/data:/opt/alist/data \ -p 5244:5244 \ xhofe/alist:latest逐项说明:--name alist指定容器名称;--restart always对应界面上的“容器退出时总是重启容器”;-v把宿主机目录映射到容器内的/opt/alist/data,这是 Alist 存放数据的默认路径;-p 5244:5244把容器端口映射到 NAS 本地端口。注意宿主机路径要根据你实际的硬盘挂载点来写,绿联系统里通常是/mnt/开头的路径。
3.3 端口设置与完成创建
点上方“端口设置”,本地端口填写5244。这里可以自己随意填,只要不和其他容器冲突即可,但小白强烈建议跟着默认走,不要乱改任何东西。Alist 这个容器只需要修改“存储空间”和“端口设置”这两个地方,其他都不用管。但其他容器就不一样了,每个容器都有自己专门的填法。
确认无误后点“下一步”,再点“完成”。回到“容器管理”页面,找到刚才创建的alist容器,点对应下面的“启动”。如果一切正常,容器状态会变成“运行中”。你还可以点右边的“快捷方式”在桌面创建快捷方式,方便快速访问。
4. 初始化 Alist:找密码、改密码、确认能登录
4.1 从日志里捞出初始密码
容器启动后,在局域网内打开浏览器,输入 NAS 的 IP 地址加上端口号 5244,中间用英文状态下的冒号:连接。比如 NAS 的 IP 是192.168.1.100,就输入http://192.168.1.100:5244。成功进入 Alist 页面后,会看到登录界面,默认用户名是admin,但密码不是固定的,需要从容器日志里找。
回到 Docker 的容器管理页面,找到alist容器,点“详情”。在上方点“日志”,里面用鼠标滑动,找到包含password的那一行,复制它后面的初始密码。回到 Alist 登录页面,填入用户名admin和刚复制的密码,登录。
# 如果你习惯命令行,也可以用这条命令查看日志 docker logs alist 2>&1 | grep -i "password"这条命令的作用是过滤容器日志中包含password的行。2>&1把标准错误也重定向到标准输出,确保不会漏掉信息。grep -i表示忽略大小写匹配。执行后会直接输出初始密码,复制即可。
4.2 修改默认密码和访客权限
登录成功后,点击左侧“用户”,可以在右侧页面内改一下登录密码。包括下面有几个guest用户,点击“编辑”可以修改访客的密码和权限。修改完密码会要求你重新登录,这是正常流程。
我一般会把admin的密码改成一个自己好记但别人猜不到的,然后把guest用户的权限收紧,比如只允许查看特定目录,不允许下载或上传。这样即使你把 Alist 暴露在局域网里,也不用担心别人乱动你的文件。
注意:修改密码后如果忘记了,只能删掉容器重新创建,或者进容器内部重置。所以改完密码后建议在密码管理器里存一份。
4.3 验证 Alist 基础功能
改完密码重新登录后,点左侧“存储”,如果列表是空的,说明还没挂载任何网盘。这时候你可以先不急着挂网盘,而是确认一下 Alist 的基本功能是否正常:页面能否正常加载、左侧菜单能否点击、右上角是否显示当前用户。
如果页面加载缓慢或者样式错乱,通常是浏览器缓存问题,强制刷新一下(Ctrl+F5)即可。如果页面完全打不开,检查容器是否在运行、端口是否被占用、防火墙是否拦截了 5244 端口。绿联系统默认没有开启防火墙,但如果你手动开过,需要放行对应端口。
5. 挂载网盘:阿里云盘和 115 网盘的具体填法
5.1 阿里云盘的挂载参数
点左侧“存储”,选择上方“添加”按钮。在挂载方式里选择阿里云盘。除了刷新令牌,其他都照抄即可,注意看清每一个字段,别抄漏了。挂载路径自己填入,比如/aliyun,这是你在 Alist 里访问该网盘的路径。
刷新令牌的获取方式:Alist 官网有对应的网盘教程,按照指引获取 token 值后复制填入“刷新令牌”内,点击“保存”。阿里云盘到此就完成了挂载。如果保存后提示错误,通常是 token 过期或者复制时多了空格,重新获取一次即可。
{ "挂载路径": "/aliyun", "根文件夹ID": "root", "刷新令牌": "你获取到的token值", "移除方式": "回收站" }上面是阿里云盘挂载的配置示例。挂载路径是 Alist 里的虚拟路径,根文件夹ID填root表示挂载整个网盘,刷新令牌是必填项,移除方式决定删除文件时是进回收站还是直接删除。我一般选回收站,给自己留个后悔药。
5.2 115 网盘的 Cookie 获取与填写
115 网盘的挂载方式和其他网盘基本一致,区别在于它用的是 Cookie 而不是 token。打开 115 网盘网页版并登录,按键盘上的F12键打开开发者工具,继续按F5刷新下页面。在开发者工具里找到网络请求,复制 cookie 值。
将复制的 cookie 值填入 Alist 的对应框内,点击“添加”,115 网盘添加完成。挂载路径同样自己填入,比如/115。其他云盘的挂载方式和 115 类似,都是获取对应的凭证后填入即可。
# 获取 115 网盘 Cookie 的快捷方式 # 在浏览器开发者工具的 Console 里输入以下命令 document.cookie这条命令会输出当前页面的所有 Cookie。复制输出的内容,粘贴到 Alist 的 Cookie 字段里。注意不要复制到多余的空格或换行,否则会提示格式错误。
5.3 挂载后的验证与目录结构
挂载完成后,回到 Alist 首页,你应该能看到左侧或主区域出现了刚才添加的网盘目录。点进去看看能否正常列出文件、能否下载。如果目录是空的或者提示错误,先检查凭证是否过期,再检查挂载路径是否重复。
我一般会把不同网盘挂载到不同的路径下,比如/aliyun、/115、/quark,这样在 Alist 里浏览时一目了然。如果挂载路径重复,Alist 会提示冲突,改一个名字就行。
6. 避坑与排查:这五个地方最容易翻车
6.1 容器启动后立刻退出
现象:点“启动”后,容器状态闪一下又变回“已停止”。原因:最常见的是存储空间映射成了“只读”,Alist 无法写入配置文件。其次是端口被其他容器占用。解决:检查存储空间映射是否改成了“读写”,检查本地端口是否和已有容器冲突。如果还不行,看容器日志,日志里会明确写出失败原因。
6.2 重启 NAS 后 Alist 配置丢失
现象:NAS 断电重启后,Alist 里的网盘挂载全没了,需要重新配置。原因:创建容器时没有正确映射data目录,或者映射到了系统盘的临时目录。解决:删掉容器重新创建,确保存储空间映射到之前建好的Docker/alist/data目录,并且是“读写”模式。重启策略选“容器退出时总是重启容器”。
6.3 浏览器打不开 Alist 页面
现象:容器显示运行中,但浏览器输入 IP:5244 后无法访问。原因:可能是 NAS 的 IP 变了,或者端口填错了,或者浏览器代理设置干扰了局域网访问。解决:先在 NAS 上确认当前 IP 地址,再确认容器端口映射是否正确。如果 IP 和端口都没问题,换一个浏览器或者用手机连同一局域网试试。常见做法是用ping命令确认 NAS 是否可达。
6.4 阿里云盘 token 频繁失效
现象:挂载好的阿里云盘过几天就提示 token 过期,需要重新获取。原因:阿里云盘的 token 有有效期,且在某些情况下会被强制刷新。解决:重新获取 token 并更新到 Alist 里。如果频繁失效,可以考虑使用 Alist 的自动刷新功能,或者换用其他挂载方式。我一般会在 token 快过期时提前更新,避免影响使用。
6.5 115 网盘 Cookie 复制不完整
现象:填写 Cookie 后保存失败,提示格式错误或认证失败。原因:复制 Cookie 时漏掉了部分内容,或者复制到了多余的字符。解决:重新在浏览器开发者工具里复制完整的 Cookie 值,粘贴时注意不要带首尾空格。如果还是不行,换一个浏览器重新登录后再复制。
7. 装完之后怎么确认真的跑通了
验证 Alist 是否真正跑通,不是看容器状态是不是“运行中”,而是要走完一条完整的链路:从局域网访问、登录、挂载网盘、浏览文件、下载文件。我一般会按下面这个清单过一遍,确认没有遗漏。
| 验证项 | 操作 | 预期结果 |
|---|---|---|
| 容器状态 | Docker 容器管理页面查看 | 显示“运行中”,重启策略为 always |
| 页面访问 | 浏览器输入 NAS IP:5244 | 正常加载登录页 |
| 登录 | 用 admin 和新密码登录 | 成功进入主界面 |
| 网盘挂载 | 左侧存储列表查看 | 显示已挂载的网盘,状态正常 |
| 文件浏览 | 点进网盘目录 | 能列出文件,能进入子目录 |
| 文件下载 | 选一个文件点下载 | 能正常下载到本地 |
| 重启恢复 | 重启 NAS 后再次访问 | 容器自动启动,配置和挂载均保留 |
最后一项“重启恢复”是最容易被忽略但最重要的。很多人装完当天能用,第二天 NAS 自动重启后就发现 Alist 起不来了。所以装完之后,我建议你主动重启一次 NAS,等系统完全启动后,再打开 Alist 页面确认一切正常。如果重启后配置丢失,说明存储空间映射有问题,回到第 3 章重新检查。
从那以后我每次装完 Docker 容器,都会强制走一遍“重启 NAS 再验证”的流程。这个习惯帮我提前发现了无数次映射错误和重启策略遗漏。希望帮到你。
本文还有配套的精品资源,点击获取