如何在群晖NAS上安装百度网盘套件

synology-baiduNetdisk-package是专为群晖NAS设备打造的开源百度网盘客户端套件，基于百度云Linux版客户端开发，让你轻松在DSM系统中管理百度网盘文件。

准备工作：确认系统兼容性

在开始前，请务必检查你的群晖系统版本：

• 最低要求：DSM 6.2.x及以上版本（Linux内核需4.0+）
• 不支持：DSM 6.0以下版本（内核3.x无法运行最新客户端）
• 注意：DS3615xs等部分机型的DSM 6.2.3可能仍为3.10内核，需特殊处理

一键安装百度网盘套件步骤

下载SPK安装包

前往项目页面下载最新SPK安装文件，可通过git clone命令获取项目源码：

git clone https://gitcode.com/gh_mirrors/sy/synology-baiduNetdisk-package

配置套件中心信任设置

• 打开群晖DSM的「套件中心」
• 进入「设置」→「信任层级」
• 选择「任何发行者」以允许安装未签名套件

手动安装套件

• 点击「手动安装」→选择下载的SPK文件
• 按照向导完成安装（过程中可能出现安全提示，点击「继续」即可）

常见问题解决方案

客户端卡在加载界面怎么办

症状：安装后进度条停滞，无法进入登录界面
解决步骤：

1. 进入文件管理器，找到BDdownload文件夹
2. 创建名为.reset的文件夹（注意开头的点号）
3. 重启Docker容器：johnshine/baidunetdisk-crossover-vnc:latest
4. 重新打开客户端并完成登录

如何设置VNC连接密码

操作指南：

1. 在本地电脑创建passwd.txt，写入自定义密码
2. 上传文件至群晖的BDdownload/.vnc/目录
3. 重启对应Docker容器使设置生效

客户端更新失败或兼容性错误

重要提示：群晖环境不建议升级百度云客户端！

• 若内核版本≥4.0：可尝试docker pull johnshine/baidunetdisk-crossover-vnc:latest
• 若内核版本<4.0：必须使用旧版镜像

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

VNC界面全屏灰色无内容

排查方法：

1. 通过SSH连接群晖，执行uname -r检查内核版本
2. 若显示3.10.x：需按上述方案安装3.1版镜像
3. 若显示4.0.x：删除容器后重启套件

高级配置与优化

Docker镜像加速技巧

可通过网盘下载预打包镜像，下载后通过SSH导入：

docker load < baidunetdisk-crossover-vnc\:latest.tar

DSM7系统特别说明

目前项目对DSM7的支持仍在开发中，若遇到安装问题，可尝试：

• 检查scripts/start-stop-status脚本权限
• 确保conf/privilege配置文件正确加载

项目资源与技术支持

项目源码包含完整安装包构建脚本pkgCreate.sh，可在build目录生成SPK安装包。安装前请确保已安装Docker套件，并预先下载johnshine/baidunetdisk-crossover-vnc:latest映像以缩短安装时间。

安装完成后，即可在应用菜单中找到百度云客户端的启动图标。卸载此套件会删除BDdownload共享文件夹，请注意保存重要数据至其它目录。

通过本教程，你已掌握在群晖NAS上部署百度网盘套件的全部要点。如有其他问题，欢迎在项目页面提交反馈。