本文介绍如何在群晖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。
来自真实用户的反馈,见证轩辕镜像的优质服务
免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
在 Linux 系统配置镜像加速服务
在 Docker Desktop 配置镜像加速
Docker Compose 项目配置加速
Kubernetes 集群配置 Containerd
在宝塔面板一键配置镜像加速
Synology 群晖 NAS 配置加速
飞牛 fnOS 系统配置镜像加速
极空间 NAS 系统配置加速服务
爱快 iKuai 路由系统配置加速
绿联 NAS 系统配置镜像加速
QNAP 威联通 NAS 配置加速
Podman 容器引擎配置加速
HPC 科学计算容器配置加速
ghcr、Quay、nvcr 等镜像仓库
无需登录使用专属域名加速
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429