OpenList无法挂载123云盘？升级4.2.3即可解决

📺 本图文教程由视频整理而成，对应的参考视频：OpenList无法挂载123云盘~逆向和开放接口区别~WebDAV方式挂载LitePan。如需查看更详细、更具体的操作演示，可观看原视频。

场景：OpenList 里挂载的 123 云盘还能看到目录名，点进去却空空如也，什么内容都没有。这不是账号或配置坏了，升级到 4.2.3 即可恢复；长期来看，建议改用官方开放接口，或用 WebDAV 方式把 LitePan / CD2 挂进 OpenList 作为备份。

提示：本教程配套的操作文档，可在好用斋官网 → 网盘分享（提取码 570）中下载。

第一步：确认现象与解决思路

登录 OpenList 首页，点击 123 云盘的挂载目录。如果里面的内容是空白的，基本就是本文说的问题。

解决顺序只有一条：先把 OpenList 升级到 4.2.3。4.2.1、4.2.2 都会出现 123 云盘目录为空的现象，升级后即可正常显示。

注意

OpenList 官方文档已明确说明：123 云盘的接口是基于历史产物做的逆向接口，项目组不会主动维护，继续使用该驱动必须开启本地代理，也就是不能再用 302 重定向。升级只是让当前版本重新可用，并不代表这个驱动以后一直有效。

第二步：用 Docker 懒人包生成升级命令

打开好用斋官网，进入 Docker 懒人包 页面。

1. 「NAS 系统」选择自己正在使用的系统，例如飞牛（fnOS）、绿联、iStoreOS 等。
2. 架构按设备选择，一般 x86_64 保持默认即可。
3. 只想升级 OpenList 时，在搜索框输入 open，下方会出现「网盘挂载 OpenList」卡片，点击它。
4. 右侧会生成对应的 Docker Compose 配置。在「输入服务名称」里填入 openlist（各系统服务名可能略有不同，以页面生成结果为准），命令就会只作用于 OpenList 这一个容器。
5. 点击「复制内容」。

如果需要一次性升级懒人包里的所有程序，直接点「全部升级」即可，但那样会牵连其它容器，只想修 123 云盘的话没必要，大家按需选择。

注意

填服务名的意义就是「只升级这一个容器」。不填服务名，命令会作用于整个 compose 项目，其它程序也会跟着升级重建。

第三步：SSH 执行升级

用 SSH 登录 NAS，进入管理员模式：

sudo -i

输入登录密码后回车。输入过程中屏幕不会显示任何字符，这是正常的，输完直接回车即可。提示符从普通用户名变成 root，就说明已经进入管理员模式。

随后把懒人包页面复制的命令粘贴进来并回车。（这里以飞牛系统为例）：

cd /vol1/1000/compose/all
docker compose pull
docker compose up -d
docker image prune -f

执行过程会拉取新镜像并重建容器。如果本地镜像已经是最新版本，命令会保持容器继续运行，不会删除旧镜像，很快就结束。

第四步：确认版本已是 4.2.3

回到 OpenList，依次点击 管理 → 设置 → 站点，查看最上方的「后端版本」。显示 v4.2.3 就说明升级成功。

升级完成后回到首页，点击 123 云盘目录，内容应该已经能正常显示。

第五步：升级后仍提示「请进行验证」

部分设备升级后，首页能打开，但在「管理 → 存储」里 123 云盘的状态仍然显示 请进行验证。这种情况不需要重新配置存储，按下面操作即可：

1. 浏览器打开 123 云盘网页版并登录。
2. 点击右上角头像，选择 退出登录。
3. 重新登录，建议用短信验证码登录。
4. 回到 OpenList，刷新页面。

此时存储列表里可能仍显示「请进行验证」，但直接回首页点击 123 云盘目录，已经可以正常访问了。以实际能否打开目录为准，不必纠结状态文字。

第六步：逆向接口与开放接口的区别

对比项	逆向接口	开放接口（开放平台）
来源	第三方根据网盘行为反向推测	网盘官方提供的标准 API
维护方	个人开发者，成本高、易停更	网盘官方，对外接口一般保持稳定
网盘改版后	直接失效，只能等更新	内部改动不影响对外 API
302 直链	必须开本地代理	支持，播放下载效果更好
秒传	缺少参数，无法实现	支持
典型代表	夸克等没有开放平台的网盘	115、百度、123 云盘

结论很直接：能走开放接口就走开放接口。CD2（CloudDrive2）和 LitePan 都可以免费使用 123 云盘的开放平台接口；个人去 123 开放平台申请还要付费，日常使用没有必要。

第七步（可选）：用 WebDAV 挂载 LitePan / CD2 作备份

如果主力仍然是 OpenList，可以把 LitePan 或 CD2 通过 WebDAV 串起来。这样即使 OpenList 的 123 驱动再次失效，数据仍然能正常访问。

以 LitePan 为例：

1. 打开 LitePan，左侧点击 系统设置 → WebDAV 设置。
2. 确认「启用 WebDAV 服务」已打开，点击地址后方的复制按钮，地址形如 http://192.168.31.215:5211/dav。
3. 回到 OpenList，进入 管理 → 存储 → 添加。
4. 「驱动」下拉选择 WebDAV，「挂载路径」随便填，例如 /litepan。
5. 向下滑动到表单底部，「地址」粘贴刚才复制的 WebDAV 地址。
6. 「用户名」「密码」填写 LitePan 的登录账号和密码，不是 123 云盘的账号。
7. 「根文件夹路径」保持 /，点击「添加」。

添加完成后，存储列表里该条目会显示 工作中。回到首页点击 /litepan，LitePan 里挂载的 123 逆向接口目录和 123 Open 接口目录都能正常浏览。

CD2 的方法完全相同：打开 CD2 首页，点击 WebDAV 服务器，复制服务器 URL（地址 + 端口 + /dav），在 OpenList 里同样选择 WebDAV 驱动，填入地址、CD2 的用户名和密码即可。

注意

OpenList 里的 WebDAV 地址要填 NAS 的局域网 IP，不要填 127.0.0.1 或 localhost。 localhost 指向容器自己，填本机回环地址一定连不上。

总结

1. 123 云盘目录空白，先升级 OpenList 到 4.2.3，这是最快的解决办法。
2. 用懒人包的「输入服务名称」只升级 OpenList，避免牵连其它容器。
3. 升级后仍提示「请进行验证」，退出并重新登录 123 云盘网页版，再刷新 OpenList。
4. 逆向接口随时可能再次失效，长期方案是改用官方开放接口，或用 WebDAV 把 LitePan / CD2 挂进 OpenList 作为备份。

参考视频

OpenList无法挂载123云盘~逆向和开放接口区别~WebDAV方式挂载LitePan

好用斋官网

• 好用斋官网
• Docker 懒人包