企业官网建设流程全解析

群晖NAS安装百度网盘客户端：保姆级教程，4步装好

【免费下载链接】synology-baiduNetdisk-package项目地址: https://gitcode.com/gh_mirrors/sy/synology-baiduNetdisk-package

还在为群晖NAS上没有百度网盘客户端而发愁吗？synology-baiduNetdisk-package 这个开源项目，把百度网盘 Linux 版客户端用容器打包成了群晖套件，装好 Docker 就能在 DSM 里直接跑。想象一下：主菜单点开"百度云网盘客户端"，浏览器里就能登录网盘、管理文件，下载任务在 NAS 上 7×24 小时自动跑，不用一直开着家里的电脑。

一表看懂：它比虚拟机省事在哪

📋 开工前：5分钟自检清单

安装前把这四条过一遍，能避开绝大多数装不上、起不来的问题。

• DSM 版本与内核：控制面板 → 系统信息 看版本号，官方要求 6.2.x 以上且内核 4.0+；SSH 里跑uname -r，主版本号必须 ≥ 4.0
• Docker 套件：套件中心搜索 Docker 确认已安装，套件安装时会校验这个依赖，缺了会直接报错
• 存储空间：套件会自动创建 BDdownload 共享文件夹存放网盘数据，提前在存储管理器里留够空间
• DSM 7 用户多看一眼 README：官方对 DSM7 的适配说明有过反复，装之前确认下当前版本的适配进度

🚀 安装：4步装好群晖百度网盘套件

第一步：拿到 SPK 安装包

这一步就是搞到要安装的文件，从 Releases 下现成的包最省事。

1. 打开项目仓库的 Releases 页面，下载最新的.spk安装包
2. （可选）想自己打包的话，clone 仓库后一条命令搞定：

git clone https://gitcode.com/gh_mirrors/sy/synology-baiduNetdisk-package cd synology-baiduNetdisk-package && ./pkgCreate.sh

跑完后 SPK 文件会出现在仓库的build目录里。

第二步：放行第三方发行者

这个 SPK 没有签名，不放行的话套件中心会直接拦截安装。

1. 打开套件中心，点右上角"设置"
2. 在"常规"选项卡选择"信任任何发行者"，保存
3. 装完套件后如想收紧策略，可以再改回来

第三步：套件中心手动安装

把下载好的 SPK 喂给套件中心，Docker 依赖会自动校验。

1. 套件中心 → "手动安装"，选择下载好的.spk文件
2. 按提示走完安装流程；如果卡在拉镜像，可先到 Docker 界面手动拉一次johnshine/baidunetdisk-crossover-vnc:latest，再回来点重试

第四步：启动并使用

安装完成后套件会在主菜单生成入口，剩下就是打开和登录。

1. 群晖主菜单出现"百度云网盘客户端"图标，点开即可
2. 浏览器打开http://NAS地址:6900（端口在 package/config 里定义），noVNC 页面加载出来就算通了
3. 在画面里登录百度网盘账号，下载一个几 MB 的小文件试手

装完验证：看这三处，出画面就成功

• 主菜单有图标：安装成功时"百度云网盘客户端"会出现在应用列表里
• 6900 端口有响应：浏览器打开http://NAS地址:6900，能看到 noVNC 网页画面
• 容器在跑：Docker 界面里johnshine/baidunetdisk-crossover-vnc:latest对应的容器状态为运行中

SSH 里也可以用一行命令确认端口活着（套件的状态脚本就是这么检查的）：

curl -s http://127.0.0.1:6900 -o /dev/null && echo OK

第一次使用建议登录网盘后先下载一个小文件到BDdownload文件夹，跑通整条链路再上大任务。

🛠️ 高频问题速查：卡在加载界面、灰屏怎么破

Q：卡在加载界面，进度条不动也不出登录框？

在BDdownload共享文件夹下新建一个名为.reset的文件夹，到 Docker 里重启对应容器，重新登录即可。这是客户端登录态残留导致的，重置后需要重登。

Q：打开 6900 端口是一整块灰屏？

说明客户端没起来，多半是内核太旧。跑uname -r确认低于 4.0 的话，换低版本镜像：

docker pull johnshine/baidunetdisk-crossover-vnc:3.1 docker tag johnshine/baidunetdisk-crossover-vnc:3.1 johnshine/baidunetdisk-crossover-vnc:latest

然后在 Docker 里删掉旧容器，重启群晖套件。

Q：怎么给 VNC 连接加密码？

本地新建passwd.txt写入密码，在BDdownload下建.vnc文件夹并把它传进去，重启容器生效。

Q：镜像拉取太慢？

下载打包好的镜像文件传到 NAS，SSH 里执行docker load < baidunetdisk-crossover-vnc:latest.tar直接导入。

🔧 进阶与避坑

• 带宽限速：在客户端里把下载速度压到总带宽的七成左右，避免高峰期把 NAS 其他服务挤没
• 安全：VNC 密码务必设置；不需要外网访问就别把 6900 端口暴露出去
• 别急着升客户端：README 明确说最新版客户端在群晖上兼容性有问题，等官方确认再升
• 卸载前备份：卸载套件会连带删除 BDdownload 共享文件夹，重要数据先挪走
• 想改端口或二次打包：套件结构很简单，入口标题和端口在 package/config，生命周期逻辑在 scripts/，改完跑./pkgCreate.sh重新打包即可

要点回顾：内核 4.0+ 和 Docker 是前提；先放行"信任任何发行者"再装 SPK；成功标志是 6900 端口出画面；卡住就先建.reset重启容器；VNC 密码别忘设。流程跑熟之后十分钟就能装完，动手试一下吧，遇到问题先看项目 README 和 Issues，社区更新很勤。

【免费下载链接】synology-baiduNetdisk-package项目地址: https://gitcode.com/gh_mirrors/sy/synology-baiduNetdisk-package