
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
本文介绍如何在群晖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后,执行以下命令完成部署。
1. 下载镜像
根据网络环境选择镜像源,执行对应命令拉取镜像:
| 镜像源 | 拉取命令 |
|---|---|
| DockerHub | docker pull docker.xuanyuan.run/johngong/baidunetdisk:latest |
| GitHub | docker pull ***-ghcr.xuanyuan.run/gshang2017/baidunetdisk:latest |
2. 创建容器
替换以下命令中的 <本地配置文件路径> 和 <本地下载路径> 为实际路径(如 /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
3. 运行容器
bashdocker start baidunetdisk
4. 停止容器
bashdocker stop baidunetdisk
5. 删除容器
bashdocker rm baidunetdisk
6. 删除镜像
bashdocker image rm johngong/baidunetdisk:latest
通过群晖DSM的「Docker」套件图形界面配置,步骤如下:
1. 卷设置(文件映射)
在「卷」选项卡中添加本地文件夹与容器内路径的映射:
| 配置项 | 说明 |
|---|---|
| 本地文件夹1 → 容器路径 | <本地下载路径> → /config/baidunetdiskdownload(百度网盘下载路径,3.3.2及以上版本需手动在客户端设置) |
| 本地文件夹2 → 容器路径 | <本地配置文件路径> → /config(百度网盘配置文件存储路径) |
2. 端口设置(端口映射)
在「端口设置」选项卡中配置本地端口与容器端口的映射:
| 配置项 | 说明 |
|---|---|
| 本地端口1:5800 | Web界面访问端口,通过 群晖IP:本地端口1 访问 |
| 本地端口2:5900 | VNC协议访问端口(若不使用VNC客户端可忽略),通过 群晖IP:本地端口2 访问 |
3. 环境变量设置
在「环境」选项卡中添加以下键值对(根据需求调整,默认值可省略):
| 参数键 | 说明 | 默认值 |
|---|---|---|
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] 。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务