BaiduPCS-Rust快速开始完整指南:Docker一键部署,10分钟实现百度网盘满速下载
BaiduPCS-Rust快速开始完整指南:Docker一键部署,10分钟实现百度网盘满速下载
BaiduPCS-Rust 是一个使用 Rust + Vue 3 构建的百度网盘第三方客户端,提供多线程满速下载、多账号管理、自动备份与本地侧加密上传能力。本文带你通过 Docker 一键部署 BaiduPCS-Rust,从扫码登录到配置下载线程数,10 分钟跑通 Web 管理界面,让会员带宽真正跑满。
BaiduPCS-Rust 是什么?能做什么
BaiduPCS-Rust 把"网盘客户端"做成了一个跑在浏览器里的 Web 应用:后端是 Rust 编写的高性能下载/上传引擎,前端是 Vue 3 现代界面,一个端口(18888)就能访问完整功能。
| 核心能力 | 说明 |
|---|---|
| ⬇️ 多线程下载 | 8 个并发分片可配置、断点续传、文件夹/批量下载、CDN 链接智能刷新 |
| 👥 多账号管理 | 多账号独立会话与任务队列,按会员权重分配线程配额 |
| ⬆️ 上传与备份 | 批量上传、秒传、本地文件夹自动备份到云端 |
| 🔐 客户端侧加密 | AES-256-GCM 端到端加密,文件名以 .dat 隐藏真实类型 |
| 🔗 转存/分享同步 | 分享链接转存、订阅分享自动增量同步 |
| 🖥️ 安全访问 | 可选 Web 访问密码 + TOTP 双因素认证,适合公网部署 |
登录后进入的文件管理页:表格化浏览网盘文件,支持批量下载、新建文件夹、转存与刷新操作。
使用 Docker 一键部署 BaiduPCS-Rust(推荐)
只要机器上装好了 Docker,两条命令即可完成 BaiduPCS-Rust 部署。
方式一:docker run 直接启动
# 1. 创建数据目录
mkdir -p baidupcs-rust/{config,downloads,data,logs,wal}
cd baidupcs-rust
# 2. 拉取镜像并运行容器
docker run -d \
--name baidu-netdisk-rust \
-p 18888:18888 \
-v $(pwd)/config:/app/config \
-v $(pwd)/downloads:/app/downloads \
-v $(pwd)/data:/app/data \
-v $(pwd)/logs:/app/logs \
-v $(pwd)/wal:/app/wal \
--restart unless-stopped \
komorebicarry/baidupcs-rust:latest
方式二:docker-compose 编排启动
项目内置了使用预构建镜像的编排文件 docker-compose.image.yml,除了挂载卷外还配好了健康检查与资源限制(CPU 上限 2 核、内存上限 2G),可直接复用:
mkdir -p baidupcs-rust/{config,downloads,data,logs,wal}
cd baidupcs-rust
# 将项目中的 docker-compose.image.yml 放入当前目录后执行
docker-compose -f docker-compose.image.yml up -d
启动完成后,浏览器访问 http://localhost:18888(NAS 填 NAS 的内网 IP)即可打开 Web 管理界面。
五个挂载目录各自的作用
| 挂载目录 | 容器内路径 | 用途 |
|---|---|---|
config |
/app/config |
配置文件、加密密钥 encryption.json、SQLite 数据库 |
downloads |
/app/downloads |
下载文件保存目录 |
data |
/app/data |
会话数据(登录态持久化,重启免重新扫码) |
logs |
/app/logs |
运行日志(滚动保留) |
wal |
/app/wal |
任务持久化数据,支持断点恢复 |
⚠️ 如果启用了客户端侧加密,务必备份
config/encryption.json与config/baidu-pcs.db,丢失后将无法解密已加密文件。
想从源码构建镜像?
不满足于预构建镜像时,可以克隆仓库后用 Dockerfile 的多阶段构建(Node 前端 → Rust 后端 → 精简运行时)自行打镜像:
git clone https://gitcode.com/gh_mirrors/ba/BaiduPCS-Rust
cd BaiduPCS-Rust
docker-compose up -d
生产编排文件为 docker-compose.yml,逻辑与上面的预构建方案一致,只是把 image 换成了 build。
登录 BaiduPCS-Rust:扫码 3 步进入网盘
首次打开页面会自动展示登录二维码,登录流程非常简单:
- 打开百度网盘 APP,确保手机 APP 已登录;
- 用 APP 的"扫一扫"扫描网页上的登录二维码;
- 在 APP 中点击确认登录,并保持 APP 在前台不要退出,1~3 秒后网页自动跳转进入文件管理页。
登录成功后会话会持久化到 data 目录,下次启动自动恢复,无需重复扫码;会话过期则会自动跳回登录页。也支持直接粘贴浏览器 Cookie 完成登录,方便在 NAS 等不方便扫码的场景使用。
满速下载关键设置:线程数与分片怎么调
进入 系统设置 → 下载配置,页面顶部会识别你的会员等级,并给出推荐线程数与分片大小(超级会员推荐 10 线程 / 5MB 分片)。
两个最重要的参数:
- 全局最大线程数:所有下载任务共享的并发分片数。SVIP 建议 10~20,根据实际带宽调整;普通用户建议设为 1,盲目调大容易触发风控限速,几天内账号多端近乎 0 速。
- 最大同时下载数:同时下载的文件数上限,并非越大越快,按需求设 2~5 即可。
配置示例可参考 config/app.toml.example,其中 [download] 段落定义了 concurrent_chunks、chunk_size_mb、max_retries 等参数。此外系统内置智能分片大小:按文件大小与会员等级自动选择 256KB~5MB 分片,并规避百度单请求 5MB 的 Range 硬限。
发起下载并观察满速效果
在文件管理页勾选文件点击"批量下载",会弹出仿资源管理器的目录选择器确认保存路径:
确认后可在下载管理页实时看到每个任务的速度、进度百分比与剩余时间,支持暂停/继续/删除与批量操作:
配合断点续传、CDN 链接三层刷新检测(速度异常检测、线程停滞检测、定时强制刷新),长时间下载也不会"黏"在坏链接上磨时间。
进阶玩法:备份、加密与公网安全
部署跑通后,下面几个能力值得顺手开启:
- 🔄 自动备份:监听本地文件夹变化,实时/定时把新增文件备份到网盘,也支持云端到本地的下载备份,配置与运行历史持久化在 SQLite 中;
- 🔐 客户端侧加密:上传前本地 AES-256-GCM 加密,网盘里只见
.dat文件,下载时自动解密还原文件名; - 🔗 分享同步:订阅分享链接,周期性拉取并与上次快照对比,只增量转存/下载变动文件;
- 🌐 网络代理:支持 HTTP/SOCKS5 代理,故障时自动回退直连。
如果你的实例部署在公网 VPS,建议在 系统设置 → Web 访问认证 中开启密码 + TOTP 双因素认证,防止管理界面被未授权访问:
配置样例中的 [web_auth] 段落(见 config/app.toml.example)支持 none / password / totp / password_totp 四种模式。
不想用 Docker?本地一键部署脚本
在 Windows/Linux 本机运行,项目提供了不依赖 Docker 的部署脚本 scripts/local-deploy.sh,一键构建并启停后端 + 前端,支持 status、logs 子命令与 systemd 开机自启。手动构建则需要 Rust 1.87(由 backend/rust-toolchain.toml 固定版本)与 Node.js 18+:
# 后端
cd backend && cargo build --release && cargo run --release
# 前端
cd frontend && npm install && npm run build
常见问题速查
| 问题 | 解决方法 |
|---|---|
| 页面打不开 | 确认容器在运行(docker logs baidu-netdisk-rust),端口 18888 未被占用 |
| 扫码后一直不跳转 | APP 保持前台不要切换后台,失败后刷新页面重新获取二维码 |
| 下载速度上不去 | 检查系统设置的线程数是否匹配会员等级;普通号建议 1 线程避免风控 |
| 升级后想回退旧版本 | 先恢复升级前备份的 config/ 与 wal/ 目录再启动旧版 |
| 加密文件打不开 | 确认 config/encryption.json 与 config/baidu-pcs.db 完好,可用 decrypt-cli 独立解密工具批量解密 |
写在最后
BaiduPCS-Rust 的部署门槛其实很低:Docker 一条命令、一个端口、五个挂载目录,配合 Web 端的扫码登录与可视化设置,10 分钟就能把百度网盘的多线程满速下载、自动备份、加密上传这些能力搬上 NAS 或服务器。更完整的版本历史可以看 CHANGELOG.md,部署细节与界面预览参考 README.md。 </输出文章>
等一下——我在文中引用了 docs/images/file-management.png 两次,违反了"同一张图片只能使用一次"的规则。让我检查并修正后再输出最终版本。
<输出文章>
BaiduPCS-Rust快速开始完整指南:Docker一键部署,10分钟实现百度网盘满速下载
BaiduPCS-Rust 是一个使用 Rust + Vue 3 构建的百度网盘第三方客户端,提供多线程满速下载、多账号管理、自动备份与本地侧加密上传能力。本文带你通过 Docker 一键部署 BaiduPCS-Rust,从扫码登录到配置下载线程数,10 分钟跑通 Web 管理界面,让会员带宽真正跑满。
BaiduPCS-Rust 是什么?能做什么
BaiduPCS-Rust 把"网盘客户端"做成了一个跑在浏览器里的 Web 应用:后端是 Rust 编写的高性能下载/上传引擎,前端是 Vue 3 现代界面,一个端口(18888)就能访问完整功能。
| 核心能力 | 说明 |
|---|---|
| ⬇️ 多线程下载 | 8 个并发分片可配置、断点续传、文件夹/批量下载、CDN 链接智能刷新 |
| 👥 多账号管理 | 多账号独立会话与任务队列,按会员权重分配线程配额 |
| ⬆️ 上传与备份 | 批量上传、秒传、本地文件夹自动备份到云端 |
| 🔐 客户端侧加密 | AES-256-GCM 端到端加密,文件名以 .dat 隐藏真实类型 |
| 🔗 转存/分享同步 | 分享链接转存、订阅分享自动增量同步 |
| 🖥️ 安全访问 | 可选 Web 访问密码 + TOTP 双因素认证,适合公网部署 |
登录后进入的文件管理页:表格化浏览网盘文件,支持批量下载、新建文件夹、转存与刷新操作。
使用 Docker 一键部署 BaiduPCS-Rust(推荐)
只要机器上装好了 Docker,两条命令即可完成 BaiduPCS-Rust 部署。
方式一:docker run 直接启动
# 1. 创建数据目录
mkdir -p baidupcs-rust/{config,downloads,data,logs,wal}
cd baidupcs-rust
# 2. 拉取镜像并运行容器
docker run -d \
--name baidu-netdisk-rust \
-p 18888:18888 \
-v $(pwd)/config:/app/config \
-v $(pwd)/downloads:/app/downloads \
-v $(pwd)/data:/app/data \
-v $(pwd)/logs:/app/logs \
-v $(pwd)/wal:/app/wal \
--restart unless-stopped \
komorebicarry/baidupcs-rust:latest
方式二:docker-compose 编排启动
项目内置了使用预构建镜像的编排文件 docker-compose.image.yml,除了挂载卷外还配好了健康检查与资源限制(CPU 上限 2 核、内存上限 2G),可直接复用:
mkdir -p baidupcs-rust/{config,downloads,data,logs,wal}
cd baidupcs-rust
# 将项目中的 docker-compose.image.yml 放入当前目录后执行
docker-compose -f docker-compose.image.yml up -d
启动完成后,浏览器访问 http://localhost:18888(NAS 填 NAS 的内网 IP)即可打开 Web 管理界面。
五个挂载目录各自的作用
| 挂载目录 | 容器内路径 | 用途 |
|---|---|---|
config |
/app/config |
配置文件、加密密钥 encryption.json、SQLite 数据库 |
downloads |
/app/downloads |
下载文件保存目录 |
data |
/app/data |
会话数据(登录态持久化,重启免重新扫码) |
logs |
/app/logs |
运行日志(滚动保留) |
wal |
/app/wal |
任务持久化数据,支持断点恢复 |
⚠️ 如果启用了客户端侧加密,务必备份
config/encryption.json与config/baidu-pcs.db,丢失后将无法解密已加密文件。
想从源码构建镜像?
不满足于预构建镜像时,可以克隆仓库后用 Dockerfile 的多阶段构建(Node 前端 → Rust 后端 → 精简运行时)自行打镜像:
git clone https://gitcode.com/gh_mirrors/ba/BaiduPCS-Rust
cd BaiduPCS-Rust
docker-compose up -d
生产编排文件为 docker-compose.yml,逻辑与上面的预构建方案一致,只是把 image 换成了 build。
登录 BaiduPCS-Rust:扫码 3 步进入网盘
首次打开页面会自动展示登录二维码,登录流程非常简单:
- 打开百度网盘 APP,确保手机 APP 已登录;
- 用 APP 的"扫一扫"扫描网页上的登录二维码;
- 在 APP 中点击确认登录,并保持 APP 在前台不要退出,1~3 秒后网页自动跳转进入文件管理页。
登录成功后会话会持久化到 data 目录,下次启动自动恢复,无需重复扫码;会话过期则会自动跳回登录页。也支持直接粘贴浏览器 Cookie 完成登录,方便在 NAS 等不方便扫码的场景使用。
满速下载关键设置:线程数与分片怎么调
进入 系统设置 → 下载配置,页面顶部会识别你的会员等级,并给出推荐线程数与分片大小(超级会员推荐 10 线程 / 5MB 分片)。
两个最重要的参数:
- 全局最大线程数:所有下载任务共享的并发分片数。SVIP 建议 10~20,根据实际带宽调整;普通用户建议设为 1,盲目调大容易触发风控限速,几天内账号多端近乎 0 速。
- 最大同时下载数:同时下载的文件数上限,并非越大越快,按需求设 2~5 即可。
配置示例可参考 config/app.toml.example,其中 [download] 段落定义了 concurrent_chunks、chunk_size_mb、max_retries 等参数。此外系统内置智能分片大小:按文件大小与会员等级自动选择 256KB~5MB 分片,并规避百度单请求 5MB 的 Range 硬限。
发起下载并观察满速效果
在文件管理页勾选文件点击"批量下载",会弹出仿资源管理器的目录选择器确认保存路径:
确认后可在下载管理页实时看到每个任务的速度、进度百分比与剩余时间,支持暂停/继续/删除与批量操作:
配合断点续传、CDN 链接三层刷新检测(速度异常检测、线程停滞检测、定时强制刷新),长时间下载也不会"黏"在坏链接上磨时间。
进阶玩法:备份、加密与公网安全
部署跑通后,下面几个能力值得顺手开启:
- 🔄 自动备份:监听本地文件夹变化,实时/定时把新增文件备份到网盘,也支持云端到本地的下载备份,配置与运行历史持久化在 SQLite 中;
- 🔐 客户端侧加密:上传前本地 AES-256-GCM 加密,网盘里只见
.dat文件,下载时自动解密还原文件名; - 🔗 分享同步:订阅分享链接,周期性拉取并与上次快照对比,只增量转存/下载变动文件;
- 🌐 网络代理:支持 HTTP/SOCKS5 代理,故障时自动回退直连。
如果你的实例部署在公网 VPS,建议在 系统设置 → Web 访问认证 中开启密码 + TOTP 双因素认证,防止管理界面被未授权访问:
配置样例中的 [web_auth] 段落(见 config/app.toml.example)支持 none / password / totp / password_totp 四种模式。
不想用 Docker?本地一键部署脚本
在 Windows/Linux 本机运行,项目提供了不依赖 Docker 的部署脚本 scripts/local-deploy.sh,一键构建并启停后端 + 前端,支持 status、logs 子命令与 systemd 开机自启。手动构建则需要 Rust 1.87(由 backend/rust-toolchain.toml 固定版本)与 Node.js 18+:
# 后端
cd backend && cargo build --release && cargo run --release
# 前端
cd frontend && npm install && npm run build
常见问题速查
| 问题 | 解决方法 |
|---|---|
| 页面打不开 | 确认容器在运行(docker logs baidu-netdisk-rust),端口 18888 未被占用 |
| 扫码后一直不跳转 | APP 保持前台不要切换后台,失败后刷新页面重新获取二维码 |
| 下载速度上不去 | 检查系统设置的线程数是否匹配会员等级;普通号建议 1 线程避免风控 |
| 升级后想回退旧版本 | 先恢复升级前备份的 config/ 与 wal/ 目录再启动旧版 |
| 加密文件打不开 | 确认 config/encryption.json 与 config/baidu-pcs.db 完好,可用 decrypt-cli 独立解密工具批量解密 |
写在最后
BaiduPCS-Rust 的部署门槛其实很低:Docker 一条命令、一个端口、五个挂载目录,配合 Web 端的扫码登录与可视化设置,10 分钟就能把百度网盘的多线程满速下载、自动备份、加密上传这些能力搬上 NAS 或服务器。更完整的版本历史可以看 CHANGELOG.md,部署细节与界面预览参考 README.md。




