BaiduPCS-Rust快速开始完整指南:Docker一键部署,10分钟实现百度网盘满速下载

原创2026-10-26 11:17:252,676 阅读
文章标签:后端前端数据同步存储跨平台

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 双因素认证,适合公网部署

BaiduPCS-Rust百度网盘客户端文件管理界面

登录后进入的文件管理页:表格化浏览网盘文件,支持批量下载、新建文件夹、转存与刷新操作。

使用 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 步进入网盘

首次打开页面会自动展示登录二维码,登录流程非常简单:

  1. 打开百度网盘 APP,确保手机 APP 已登录;
  2. 用 APP 的"扫一扫"扫描网页上的登录二维码;
  3. 在 APP 中点击确认登录,并保持 APP 在前台不要退出,1~3 秒后网页自动跳转进入文件管理页。

登录成功后会话会持久化到 data 目录,下次启动自动恢复,无需重复扫码;会话过期则会自动跳回登录页。也支持直接粘贴浏览器 Cookie 完成登录,方便在 NAS 等不方便扫码的场景使用。

BaiduPCS-Rust登录后的文件管理界面

满速下载关键设置:线程数与分片怎么调

进入 系统设置 → 下载配置,页面顶部会识别你的会员等级,并给出推荐线程数与分片大小(超级会员推荐 10 线程 / 5MB 分片)。

BaiduPCS-Rust百度网盘下载线程数系统设置页面

两个最重要的参数:

  • 全局最大线程数:所有下载任务共享的并发分片数。SVIP 建议 10~20,根据实际带宽调整;普通用户建议设为 1,盲目调大容易触发风控限速,几天内账号多端近乎 0 速。
  • 最大同时下载数:同时下载的文件数上限,并非越大越快,按需求设 2~5 即可。

配置示例可参考 config/app.toml.example,其中 [download] 段落定义了 concurrent_chunks、chunk_size_mb、max_retries 等参数。此外系统内置智能分片大小:按文件大小与会员等级自动选择 256KB~5MB 分片,并规避百度单请求 5MB 的 Range 硬限。

发起下载并观察满速效果

在文件管理页勾选文件点击"批量下载",会弹出仿资源管理器的目录选择器确认保存路径:

BaiduPCS-Rust选择下载目录对话框

确认后可在下载管理页实时看到每个任务的速度、进度百分比与剩余时间,支持暂停/继续/删除与批量操作:

BaiduPCS-Rust多线程下载管理进度页面

配合断点续传、CDN 链接三层刷新检测(速度异常检测、线程停滞检测、定时强制刷新),长时间下载也不会"黏"在坏链接上磨时间。

进阶玩法:备份、加密与公网安全

部署跑通后,下面几个能力值得顺手开启:

  • 🔄 自动备份:监听本地文件夹变化,实时/定时把新增文件备份到网盘,也支持云端到本地的下载备份,配置与运行历史持久化在 SQLite 中;
  • 🔐 客户端侧加密:上传前本地 AES-256-GCM 加密,网盘里只见 .dat 文件,下载时自动解密还原文件名;
  • 🔗 分享同步:订阅分享链接,周期性拉取并与上次快照对比,只增量转存/下载变动文件;
  • 🌐 网络代理:支持 HTTP/SOCKS5 代理,故障时自动回退直连。

如果你的实例部署在公网 VPS,建议在 系统设置 → Web 访问认证 中开启密码 + TOTP 双因素认证,防止管理界面被未授权访问:

BaiduPCS-Rust 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 双因素认证,适合公网部署

BaiduPCS-Rust百度网盘客户端文件管理界面

登录后进入的文件管理页:表格化浏览网盘文件,支持批量下载、新建文件夹、转存与刷新操作。

使用 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 步进入网盘

首次打开页面会自动展示登录二维码,登录流程非常简单:

  1. 打开百度网盘 APP,确保手机 APP 已登录;
  2. 用 APP 的"扫一扫"扫描网页上的登录二维码;
  3. 在 APP 中点击确认登录,并保持 APP 在前台不要退出,1~3 秒后网页自动跳转进入文件管理页。

登录成功后会话会持久化到 data 目录,下次启动自动恢复,无需重复扫码;会话过期则会自动跳回登录页。也支持直接粘贴浏览器 Cookie 完成登录,方便在 NAS 等不方便扫码的场景使用。

满速下载关键设置:线程数与分片怎么调

进入 系统设置 → 下载配置,页面顶部会识别你的会员等级,并给出推荐线程数与分片大小(超级会员推荐 10 线程 / 5MB 分片)。

BaiduPCS-Rust百度网盘下载线程数系统设置页面

两个最重要的参数:

  • 全局最大线程数:所有下载任务共享的并发分片数。SVIP 建议 10~20,根据实际带宽调整;普通用户建议设为 1,盲目调大容易触发风控限速,几天内账号多端近乎 0 速。
  • 最大同时下载数:同时下载的文件数上限,并非越大越快,按需求设 2~5 即可。

配置示例可参考 config/app.toml.example,其中 [download] 段落定义了 concurrent_chunks、chunk_size_mb、max_retries 等参数。此外系统内置智能分片大小:按文件大小与会员等级自动选择 256KB~5MB 分片,并规避百度单请求 5MB 的 Range 硬限。

发起下载并观察满速效果

在文件管理页勾选文件点击"批量下载",会弹出仿资源管理器的目录选择器确认保存路径:

BaiduPCS-Rust选择下载目录对话框

确认后可在下载管理页实时看到每个任务的速度、进度百分比与剩余时间,支持暂停/继续/删除与批量操作:

BaiduPCS-Rust多线程下载管理进度页面

配合断点续传、CDN 链接三层刷新检测(速度异常检测、线程停滞检测、定时强制刷新),长时间下载也不会"黏"在坏链接上磨时间。

进阶玩法:备份、加密与公网安全

部署跑通后,下面几个能力值得顺手开启:

  • 🔄 自动备份:监听本地文件夹变化,实时/定时把新增文件备份到网盘,也支持云端到本地的下载备份,配置与运行历史持久化在 SQLite 中;
  • 🔐 客户端侧加密:上传前本地 AES-256-GCM 加密,网盘里只见 .dat 文件,下载时自动解密还原文件名;
  • 🔗 分享同步:订阅分享链接,周期性拉取并与上次快照对比,只增量转存/下载变动文件;
  • 🌐 网络代理:支持 HTTP/SOCKS5 代理,故障时自动回退直连。

如果你的实例部署在公网 VPS,建议在 系统设置 → Web 访问认证 中开启密码 + TOTP 双因素认证,防止管理界面被未授权访问:

BaiduPCS-Rust 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。

登录后查看全文
BaiduPCS-Rust