★ FEATURED ARTICLE 简介这份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 网页界面刷新看能不能看到这个文件。能看到说明读写链路是通的看不到就回存储配置里检查该网盘的驱动是否支持写入。我自己的习惯是每次新挂一个网盘都先用这个「建文件再回看」的方法验一遍而不是只看列表里有没有目录。目录能列出来只说明读权限通了写权限往往是另一回事等真正要传东西时才发现写不进去那时候排查成本就高了。从那以后我每次挂完新盘都强制走一遍这个验证省了不少回头返工的麻烦。希望这套流程帮到你少走几个我踩过的坑。本文还有配套的精品资源点击获取
阅读完成 · 觉得有帮助？
