简介:这份PDF图文教程面向绿联NAS用户与Docker初学者,聚焦在绿联DX4600(同样适用于DH2600)的Docker环境中部署Alist并挂载网盘这一实际需求,帮助读者解决容器创建、端口配置与网盘接入过程中的常见困惑。资源包共1个PDF文件,大小约2.91MB,内容以图文步骤形式呈现,涵盖镜像搜索下载、容器创建与存储空间设置、端口映射、初始密码查找与登录、密码修改,以及阿里云盘、115网盘等挂载的完整流程,并附有目录引导便于按需查阅。教程强调全程按步骤操作,对小白友好,同时提示群晖、极空间等设备存在差异,可作为同类NAS部署的参考思路。目前已有912人学习,适合希望低成本搭建个人网盘聚合入口、需要一份可对照执行的实操指南的读者使用。
1. 在 NAS 上把 Alist 跑起来:一次讲清 Docker 部署与网盘挂载的完整链路
很多人拿到 NAS 之后的第一反应是「先把网盘都挂上去」,但真到动手时才发现,群晖、极空间、绿联这几家的 Docker 界面长得完全不一样,网上搜到的教程往往只讲其中一台,照着抄就翻车。这篇笔记拆的是一个在绿联 DX4600 上通过 Docker 部署 Alist、再把阿里云盘和 115 网盘挂载进来的完整流程。它解决的核心问题很具体:让一台家用 NAS 变成一个统一的网盘入口,浏览器打开一个地址就能看到所有挂载的云盘目录,不用在多个客户端之间来回切。适合手里有绿联 NAS、想用 Docker 做点实际事情、但又不想被一堆参数绕晕的从业者,新手照着步骤能走通,熟手可以重点看后面的参数边界和排错部分。
2. 部署前的准备:镜像、目录与端口三件事
Alist 本身是一个用 Go 写的文件列表程序,它不存储文件,只负责把各种网盘、本地存储的接口统一成一套 WebDAV 和网页界面。放到 Docker 里跑,意味着它的运行环境被隔离在一个容器内,NAS 只负责提供 CPU、内存、磁盘和网络。理解这一点很关键:后面所有的配置,本质上都是在告诉容器「数据放哪」「对外开哪个门」,而不是在改 NAS 系统本身。
2.1 镜像选择与拉取方式
绿联的 Docker 界面里,镜像管理分「本地镜像」和「镜像仓库」两块。常见做法是直接在本地镜像页点添加,在官方库搜索框里输入镜像名。这个项目用的是xhofe/alist,搜索xhofe回车,列表里第一个就是它。选中后确定,剩下的就是等下载完成,界面出现 All done 说明镜像已经落到本地。
这里有个容易被忽略的点:搜索时输入的是作者名而不是完整镜像名,是因为绿联的搜索框对完整路径的匹配不一定准,输作者名反而能把该作者下的镜像都列出来,方便你确认选的是不是官方那个。下载速度取决于网络和镜像源,如果卡在拉取阶段很久不动,先点右上角刷新看看是不是已经下完了但界面没刷新,再考虑换时间段重试。
镜像拉下来之后不要急着创建容器,先在本地镜像列表里确认能看到xhofe/alist这一条。看不到就刷新,还是没有就说明下载其实失败了,回去重新拉一次。这一步的确认动作能省掉后面「容器创建了但起不来」的一大段排查。
2.2 存储目录的规划与映射
容器里的 Alist 需要把配置、数据库、日志写到磁盘上,如果这些数据只存在容器内部,容器一删就全没了。所以必须把 NAS 上的一个真实目录映射进容器。原文的做法是提前在存储空间根目录建好Docker/alist/data三级目录,然后在容器的存储空间设置里选中这个 data 文件夹,并把右侧的「只读」改成「读写」。
这个目录结构不是随便定的。Docker这一层是给所有容器用的总目录,alist是这一个容器的专属目录,data才是 Alist 真正写数据的地方。分层的好处是以后再加别的容器,各自在自己的目录里折腾,不会互相污染。映射时选到data这一级,是因为 Alist 默认就把数据目录指向容器内的/opt/alist/data,映射到这一层刚好对上。
只读改读写这一步千万别漏。只读模式下容器能读到目录内容但写不进去,表现就是 Alist 能启动、页面能打开,但一登录就报错或者配置保存不了,日志里一堆 permission denied。这种问题不看日志很难想到是挂载权限的锅。
2.3 端口与重启策略的设置
Alist 默认监听容器内的 5244 端口,映射到 NAS 上也要给一个本地端口。原文建议本地端口也填 5244,理由是「小白别乱改」。这个建议背后的逻辑是:端口只要不和 NAS 上其他容器冲突就行,填成和容器内一致最不容易记混,访问时NAS的IP:5244直接就能进。如果你 NAS 上已经有别的服务占了 5244,那就换一个,比如 5245,访问时相应改掉即可。
重启策略选「容器退出时总是重启容器」,这是让 Alist 在 NAS 重启或容器意外退出后能自己爬起来。不选也能用,但每次 NAS 断电恢复后你得手动去点一次启动,时间长了容易忘。选了这个策略,容器退出后 Docker 会自动拉起,省心不少。
配置改完点下一步、完成,回到容器管理列表,找到刚建的 alist 容器点启动。启动后可以点快捷方式在桌面建个入口,也可以直接在局域网浏览器里输NAS的IP:5244。能打开登录页,说明容器跑起来了,部署这半边就算成了。
3. 首次登录与账号安全:初始密码在哪、怎么改
容器起来只是第一步,Alist 的初始密码不是固定的,每次部署都会随机生成,得从容器日志里捞出来。这一步是新手最容易卡住的地方,因为登录页上没有任何提示密码在哪。
3.1 从容器日志里取初始密码
在容器管理里找到 alist,点详情,切到日志页,用鼠标在日志里往下滑,找包含password的那一行,它后面跟的那串就是初始密码。用户名默认是admin。把这两样填进登录页就能进去。
日志里可能有很多行,密码那行不一定在最上面,往下翻一翻。如果日志刷得太快不好找,可以在日志页里用浏览器的查找功能搜password。取到密码后建议先复制到记事本,因为登录进去改密码之前,这个页面一关就得重新翻日志。
3.2 修改管理员与访客密码
登录进去后点左侧「用户」,右侧会列出当前账号。admin是管理员,下面还有几个guest访客账号。点对应行的「编辑」就能改密码,改完会要求重新登录。
访客账号的密码也建议一起改掉。默认的 guest 密码是公开的,如果你的 Alist 暴露在局域网里,别人用默认密码就能以访客身份浏览你挂载的内容。改密码这个动作花不了一分钟,但能挡掉大部分「顺手看一眼」的情况。改完记得用新密码重新登录确认一次,避免改的时候手滑打错导致自己进不去。
提示:初始密码只存在日志里,容器重建后日志会重置,密码也会重新生成。所以改完密码后,把新密码记在你自己的密码管理工具里,别指望回头还能从日志里找回来。
4. 挂载阿里云盘与 115 网盘:令牌和 Cookie 怎么拿
Alist 的挂载逻辑是:每一种网盘对应一个驱动,驱动需要一组凭证才能访问你的网盘。阿里云盘用刷新令牌,115 网盘用 Cookie。凭证拿对了,挂载就是填表;拿错了,保存后列表里能看到目录但点进去报错。
4.1 阿里云盘的刷新令牌获取与填写
在 Alist 左侧点「存储」,上方点「添加」,驱动选阿里云盘。挂载路径自己填一个,比如/aliyun,这个路径就是以后在 Alist 里看到这个网盘的入口名。除了「刷新令牌」这一栏,其他字段按官方文档的默认值照抄即可。
刷新令牌的获取方式,原文指向 Alist 官网的网盘教程页。常见做法是打开那个教程页,按页面上的引导走一遍授权流程,最后页面上会给出一个 token 字符串,复制它,粘贴到「刷新令牌」框里,点保存。保存后回到存储列表,如果状态显示正常、点进去能看到文件,就说明挂载成功。
这里的关键是 token 要完整复制,前后不能带空格。粘贴时如果框里已经有内容,先清空再粘,避免拼出两段 token。保存后如果报错,先检查 token 是不是过期了,重新走一遍授权流程拿新的。
4.2 115 网盘的 Cookie 抓取与填写
115 网盘的凭证是 Cookie。操作是在电脑浏览器里打开 115 网盘网页版并登录,按 F12 打开开发者工具,再按 F5 刷新页面,在开发者工具里找到请求头中的 Cookie 值,整段复制下来。
驱动同样选 115 网盘,挂载路径自己填,比如/115,把复制的 Cookie 粘进对应框,点添加。保存后同样回列表确认状态和目录内容。
Cookie 的坑在于它有有效期,网盘那边一失效,Alist 里就会报鉴权失败。表现是之前能看的目录突然打不开,或者列表刷新不出来。遇到这种情况不用怀疑 Alist 本身,重新去浏览器抓一次 Cookie 更新进去就行。另外 Cookie 是一整段很长的字符串,复制时容易漏掉开头或结尾,粘完可以对比一下长度,差太多就是没复制全。
4.3 其他网盘的通用挂载思路
其他云盘的挂载方式和 115 类似,区别只在驱动类型和凭证字段。有的用账号密码,有的用 token,有的用 Cookie,具体看 Alist 存储添加页里对应驱动的字段说明。挂载路径的命名建议统一风格,比如都用网盘简称做前缀,以后挂多了在侧边栏里一眼能分清哪个是哪个。
挂载完成后,Alist 首页左侧会列出所有已挂载的存储,点进去就是对应网盘的目录树。到这一步,NAS 作为统一网盘入口的目标就实现了。
5. 避坑与排查:五个真实会遇到的翻车点
部署和挂载的流程本身不复杂,但实际操作里翻车的地方集中在几个固定位置。下面这几条是按「现象 → 原因 → 解决」整理的,遇到问题可以先对照着看。
现象:容器创建后启动失败,或者启动后马上退出。原因多半是存储目录映射错了层级,或者映射的目录在 NAS 上根本不存在。解决是回容器设置里检查存储空间那一栏,确认选中的是提前建好的data目录,且右侧是读写而不是只读。目录不存在就先在文件管理里建好再重新映射。
现象:Alist 页面能打开,但登录时报密码错误。原因是从日志里复制密码时多带了空格或换行,或者日志已经刷新、取到的是旧密码。解决是回日志页重新找password那一行,只复制等号后面的字符串,粘贴时确认前后没有空白字符。
现象:阿里云盘挂载保存成功,但点进去提示鉴权失败。原因通常是刷新令牌过期或复制不完整。解决是重新走一遍官网教程的授权流程拿新 token,粘贴前清空输入框。如果换了新 token 还是失败,检查驱动类型有没有选错。
现象:115 网盘之前能用,过几天突然打不开。原因是 Cookie 失效,网盘侧登录状态过期了。解决是重新在浏览器登录 115 网页版,F12 加 F5 重新抓一次 Cookie,更新到存储配置里保存。
现象:NAS 重启后 Alist 没起来,要手动点启动。原因是创建容器时重启策略没选「容器退出时总是重启容器」。解决是编辑容器配置,把重启策略改过来,之后就不用每次手动拉了。已经建好的容器改策略一般不需要重建,改完保存即可。
注意:改任何容器配置之前,先确认当前 Alist 里的挂载配置有没有需要备份的。虽然数据目录映射在 NAS 上不会丢,但养成改前确认的习惯能少很多后悔药。
6. 进阶:用 WebDAV 把 Alist 接进本地文件管理器
Alist 挂载完网盘之后,网页界面只是它的一种用法。它同时对外提供 WebDAV 服务,这意味着你可以把整个 Alist 当成一个网络驱动器挂到 Windows 资源管理器、macOS 访达或者手机的文件管理器里,用本地文件操作的方式直接读写网盘内容。这个用法比每次开浏览器点来点去顺手得多,尤其是需要批量传文件的时候。
WebDAV 的地址是http://NAS的IP:5244/dav,用户名和密码就是你 Alist 的管理员账号。在 Windows 上,资源管理器里右键「此电脑」选「映射网络驱动器」,填这个地址,勾选使用其他凭据连接,输账号密码即可。macOS 上在访达里选「前往」→「连接服务器」,输同样的地址。
这里有个参数值得注意:Alist 的 WebDAV 默认走的是和网页同一个端口,如果你之前把本地端口改成了 5245,那 WebDAV 地址也要跟着改成 5245。另外部分网盘的驱动对 WebDAV 写入支持有限,上传大文件时可能失败,遇到这种情况先用网页界面上传确认是网盘侧的限制还是 WebDAV 配置问题。
验证挂载是否真正可用的方法很简单:在本地文件管理器里进到挂载的网盘目录,新建一个文本文件,写点内容保存,然后回 Alist 网页界面刷新看能不能看到这个文件。能看到,说明读写链路是通的;看不到,就回存储配置里检查该网盘的驱动是否支持写入。
我自己的习惯是每次新挂一个网盘,都先用这个「建文件再回看」的方法验一遍,而不是只看列表里有没有目录。目录能列出来只说明读权限通了,写权限往往是另一回事,等真正要传东西时才发现写不进去,那时候排查成本就高了。从那以后我每次挂完新盘都强制走一遍这个验证,省了不少回头返工的麻烦。希望这套流程帮到你,少走几个我踩过的坑。
本文还有配套的精品资源,点击获取