需要提醒的是,百度网盘官方并未推出过“VNC版”客户端,此类非官方版本可能存在安全风险,如信息泄露、***程序植入等,且使用非官方软件可能违反相关服务协议。建议您通过百度网盘官方渠道下载和使用正版客户端,以保障账号和数据安全。
收藏数: 230
下载次数: 1071276
类型:

johngong/baidunetdisk本文介绍如何在群晖NAS上通过Docker部署百度网盘,方便本地管理和下载文件。项目源码及更多细节可查看GitHub仓库:[***]。
特别感谢:本项目基于 jlesage/docker-baseimage-gui 基础镜像开发,感谢原作者的开源贡献。
当前支持以下架构的百度网盘客户端版本:
| 名称 | 版本 | 说明 |
|---|---|---|
| baidunetdisk | 4.17.7 | amd64架构 |
| baidunetdisk | 4.17.7 | arm64架构 |
使用过程中若遇到以下问题,可按对应方法解决:
重启群晖后网盘无法登录(适用于版本 3.0.1.2):
需删除配置文件夹中的 baidunetdiskdata.db 文件(下载进度会保留);若设置界面闪退,需删除账户文件夹中的 userConf.db 文件,之后重启Docker容器即可。
升级至 3.5.0 版本后下载位置配置:
升级后需手动在网盘客户端右上角「设置」中重新指定下载路径。
通过SSH登录群晖NAS后,执行以下命令完成部署。
根据网络环境选择镜像源,执行对应命令拉取镜像:
| 镜像源 | 拉取命令 |
|---|---|
| DockerHub | docker pull johngong/baidunetdisk:latest |
| GitHub | docker pull ghcr.io/gshang2017/baidunetdisk:latest |
替换以下命令中的 <本地配置文件路径> 和 <本地下载路径> 为实际路径(如 /volume1/docker/baidunetdisk/config 和 /volume1/downloads),执行创建容器:
bashdocker create \ --name=baidunetdisk \ -p 5800:5800 \ -p 5900:5900 \ -v <本地配置文件路径>:/config \ -v <本地下载路径>:/config/baidunetdiskdownload \ --restart unless-stopped \ johngong/baidunetdisk:latest
bashdocker start baidunetdisk
bashdocker stop baidunetdisk
bashdocker rm baidunetdisk
bashdocker image rm johngong/baidunetdisk:latest
通过群晖DSM的「Docker」套件图形界面配置,步骤如下:
在「卷」选项卡中添加本地文件夹与容器内路径的映射:
| 配置项 | 说明 |
|---|---|
| 本地文件夹1 → 容器路径 | <本地下载路径> → /config/baidunetdiskdownload(百度网盘下载路径,3.3.2及以上版本需手动在客户端设置) |
| 本地文件夹2 → 容器路径 | <本地配置文件路径> → /config(百度网盘配置文件存储路径) |
在「端口设置」选项卡中配置本地端口与容器端口的映射:
| 配置项 | 说明 |
|---|---|
| 本地端口1:5800 | Web界面访问端口,通过 群晖IP:本地端口1 访问 |
| 本地端口2:5900 | VNC协议访问端口(若不使用VNC客户端可忽略),通过 群晖IP:本地端口2 访问 |
在「环境」选项卡中添加以下键值对(根据需求调整,默认值可省略):
| 参数键 | 说明 | 默认值 |
|---|---|---|
VNC_PASSWORD | VNC访问密码(若启用VNC) | - |
USER_ID | 用户ID(uid) | 1000 |
GROUP_ID | 用户组ID(gid) | 1000 |
NOVNC_LANGUAGE | Web界面语言(zh_Hans为中文,en为英文) | zh_Hans |
ENABLE_DISABLE_GPU | 是否关闭硬件加速(true关闭,false开启) | false |
以下是创建容器时常用参数的详细说明,适用于命令行和图形界面部署:
| 参数 | 说明 |
|---|---|
--name=baidunetdisk | 容器名称,可自定义 |
-p 5800:5800 | Web界面端口映射,本地端口:容器端口 |
-p 5900:5900 | VNC端口映射(可选) |
-v <本地路径>:/config | 配置文件路径映射 |
-v <本地路径>:/config/baidunetdiskdownload | 下载路径映射 |
--restart unless-stopped | 容器重启策略(异常停止后自动重启) |
更多高级参数配置(如网络模式、资源限制等),可参考基础镜像文档:jlesage/baseimage-gui。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 版本下载页面。




manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务