BaiduPCS-Rust

项目概述

BaiduPCS-Rust 是一个用 Rust 与 Vue 3 构建的百度网盘第三方客户端，提供网页界面与高效的上传下载能力。它面向 NAS 与服务器场景，通过多线程并发下载与断点续传充分发挥会员带宽，并整合了自动备份、分享转存、离线下载与客户端侧加密，可用 Docker 一键部署。

给 NAS 用的百度网盘客户端，把带宽和自动化都用起来。

主要功能

• 多账号管理：添加、切换与删除多个账号，各账号的会话与任务队列完全隔离
• 多线程下载：单文件多分片并发下载，支持文件夹递归下载、批量下载与断点续传
• 下载冲突策略：覆盖、跳过或自动重命名，适用于单文件、文件夹与批量任务
• 上传与秒传：支持文件与文件夹批量上传，冲突策略可选智能去重、自动重命名与覆盖，并标注秒传任务
• 分享链接转存：转存百度网盘及企业版分享链接，支持提取码验证与转存后自动下载
• 分享同步：订阅分享链接并定时比对快照，仅同步变动文件，可按账号隔离并配置包含与排除路径
• 离线下载：支持 HTTP、磁力与 ed2k 链接，由网盘服务器代为下载，并智能轮询任务进度
• 自动备份：本地到云端、云端到本地的双向备份，配合文件系统监听与定时轮询兜底
• 客户端侧加密：AES-256-GCM 端到端加密，加密文件以 .dat 扩展名隐藏类型，下载时自动解密
• Web 访问认证：可开启密码保护与 TOTP 双因素认证，并提供恢复码机制
• 网络代理：支持 HTTP 与 SOCKS5 代理、代理认证、实时测速与故障自动回退直连

适用人群

• 在 NAS 上使用百度网盘的会员用户
• 需要自动化备份与同步的个人用户
• 希望上传前加密文件内容的用户

快速上手

1. 安装 Docker 后创建 config、downloads、data、logs、wal 五个目录
2. 以映射上述目录的方式运行官方镜像，并把容器端口 18888 映射到宿主机
3. 浏览器访问 http://localhost:18888，页面会显示登录二维码
4. 用手机百度网盘应用扫码并在应用中确认登录，确认期间保持应用在前台
5. 登录成功后在文件管理页浏览与下载，上传页可选择本地文件或文件夹
6. 如需加密，在系统设置的加密选项中生成并导出密钥

核心优势

• 速度更快：多线程分片配合链接健康管理，在 NAS 上也能跑满会员带宽
• 自动化到位：分享同步与自动备份把重复的搬运工作交给程序
• 数据更安全：可选客户端侧加密，密钥与映射表都由自己保管
• 部署省事：官方镜像与编排文件开箱可用

系统要求

项目	要求
部署方式	Docker 或 Docker Compose，也可从源码构建
平台	Windows、Linux、macOS
访问入口	浏览器访问，默认端口 18888

注意事项

• 启用加密后请同时备份密钥文件与数据库文件，否则已加密的文件将无法解密
• 扫码登录时百度网盘应用确认后不能关闭或切到后台，否则登录可能失败
• 本项目为第三方客户端，与百度官方无关联，请遵守服务条款
• 离线下载与转存能力受网盘账号权限与平台策略限制