如何用命令行管理百度网盘：BaiduPCS-Go 实战教程

如何用命令行管理百度网盘：BaiduPCS-Go 实战教程

【免费下载链接】BaiduPCS-Goiikira/BaiduPCS-Go原版基础上集成了分享链接/秒传链接转存功能项目地址: https://gitcode.com/GitHub_Trending/ba/BaiduPCS-Go

一个常见场景：每天凌晨，你的服务器把一天的日志自动传到百度网盘；白天，你敲一行命令，就把同事发来的带提取码分享链接收进自己网盘——不用点鼠标，不用盯着进度条。BaiduPCS-Go是一个用 Go 语言编写的网盘管理命令行工具，在原 iikira/BaiduPCS-Go 基础上增加了分享链接转存功能，覆盖登录、上传下载、搜索、离线下载等日常操作。如果你需要在服务器或脚本里自动化网盘操作，它值得试试。

一、能力全景：一个工具能干什么 🗂️

它模仿 Linux shell 设计命令：cd切换网盘工作目录、ls列目录、d下载、u上传，用惯终端的人几乎零学习成本。核心能力一览：

两个容易忽略的小亮点：交互模式支持 Tab 自动补全和通配符（比如cd /我的*）；源码可交叉编译出 Windows、Linux、macOS 甚至移动端二进制。完整命令清单见 README 命令手册。

二、快速上手：三步完成第一次下载 🚀

第 1 步：安装 BaiduPCS-Go

克隆仓库并编译（需要 Go 环境），也可以直接下载 README 中提供的各平台预编译包：

git clone https://gitcode.com/GitHub_Trending/ba/BaiduPCS-Go cd BaiduPCS-Go && go build -o BaiduPCS-Go

不带任何参数直接运行，会进入仿 Linux shell 的交互模式（提示符BaiduPCS-Go >），新手推荐这种玩法；脚本里则用"程序全路径 + 命令"的完整写法。

第 2 步：用 Cookies 登录

浏览器登录百度网盘首页，按 F12 打开开发者工具，在 Application 面板复制全部 Cookies，然后执行：

BaiduPCS-Go login -cookies="BDUSS=xxxx; STOKEN=yyyy; PANPSC=zzz"

• 这是官方推荐方式，一次登录长期有效；
• 也可以用login -bduss=xxx -stoken=yyy（两者都要在百度网盘页面获取）；
• 老式的用户名+密码交互登录已长期不维护，不建议再碰；
• 多账号直接重复登录即可，loglist查看列表，su <uid>切换，who看当前账号。

第 3 步：第一次成功的操作

BaiduPCS-Go ls / # 列出网盘根目录 BaiduPCS-Go d /我的资料/照片.jpg # 下载到程序的 download/ 目录

下载文件默认存在程序旁边的download/目录，可用config set -savedir改。文件出现的那一刻 🎉，你就走通了最短上手路径。

三、三个高频场景实战

场景 1：定时备份——每晚自动把项目目录传上云 ⏰

目标：服务器/data/projects目录每天自动备份到网盘/backup。核心就两条命令：mkdir建目录、upload递归传目录（同名文件默认跳过）：

30 2 * * * /usr/local/bin/BaiduPCS-Go upload /data/projects /backup

写进 crontab 即可无人值守。目录文件多时加--policy rsync，只重传本地大小发生变化的文件，省流量也省时间；想清理旧备份时先用rm小范围测试（删错还能用recycle restore捞回来）。

场景 2：批量转存分享链接 📦

先切到目标目录，再转存：

BaiduPCS-Go cd /分享转存 BaiduPCS-Go transfer "https://pan.baidu.com/s/1AbCdEf" "edv4"

• 提取码作为第二个参数；链接自带?pwd=edv4时直接整条粘贴也行；
• 转存固定落到当前工作目录，所以务必先cd；
• transfer --download <链接>可以在转存完成后直接下载到本地；
• 链接很多时写进 txt 文件，用 shell 循环逐行转存；
• 新版本支持--fs_id只挑分享里的部分文件转，不必整个目录全收。

转存逻辑的源码在 baidupcs/transfer.go，想搞懂 stoken 与分享链接的解析过程可以从这里读起。

场景 3：批量下载指定类型的文件 ⬇️

两条路：

• 直接上通配符：BaiduPCS-Go d /学习/*.mp4，把目录里所有 mp4 一次下完；
• 先找再下：BaiduPCS-Go search -path=/学习 -r 报告按关键字递归搜出文件，再逐个d。

本地落盘目录用--saveto指定，失败自动重试次数用--retry 3，想盯进度就加--status。

四、调优指南：按身份选参数 ⚙️

最关键的两个参数：

• max_parallel：单个文件切分几条线程并行下载；
• max_download_load：同时下载几个文件。

README 里特意加粗提醒：普通用户请把两者都设为 1。调大线程数只能短时间提速，极易触发限速，账号可能数小时甚至几天内在所有客户端接近 0 速。SVIP 用户则可以放心放开：

常用调整命令（全部参数看config set -h）：

BaiduPCS-Go config set -max_parallel 15 -max_download_load 2 BaiduPCS-Go config set -savedir D:/Downloads BaiduPCS-Go config reset

最后一条是一键恢复默认配置，调乱了别慌。另外两个特殊环境：国外 VPS 上传异常时，可通过proxy_hostnames为pan.baidu.com配回国代理；pcs_addr（上传服务器地址）自 v3.9.8 起动态获取，一般无需手配。

五、踩坑急救包 🚑

Q1：提示重新登录 / 登录失效？Cookies 过期了。先logout清掉，再从浏览器百度网盘页面重新复制 Cookies 执行login -cookies=...。这是最高频的问题。

Q2：下载速度突然归零？先怀疑限速：普通用户如果之前把max_parallel设过了 1，被限的时长从几小时到几天不等，改回 1 等恢复即可。用download --status可以查看每个线程的实时状态，确认是卡住还是真没速度。

Q3：大文件上传失败、md5 不一致？上传本身就是分片机制，单文件上限 128G。"分片上传后 md5 与本地不一致"是百度网盘端已知问题，用fixmd5命令可修复；下载时 MD5 校验误报失败，则加--nocheck跳过校验。

Q4：登录要输好几次图片验证码？用户名+密码方式触发手机/邮箱验证时，验证码需多次输入，属于已知问题。直接改用 Cookies 登录，绕开这一摊事。

更多问题可对照 README 的已知问题清单，接口层面的背景资料在 docs/overview.md。

六、进阶与生态 🔧

• 当库引用：纯 Go 项目、模块边界清晰——网盘 API 封装在 baidupcs/，命令解析在 internal/pcscommand/，下载上传引擎在 requester/ 与 internal/pcsfunctions/。想加自定义命令，仿照命令目录里现有文件加一个新命令即可；
• 研究接口：docs/ 目录整理了百度网盘开放平台文件 API 与结构化数据 API 的文档，读它有助于理解每条命令背后调了什么接口；
• 跟上更新：项目仍在活跃维护（最新 v4.0.2，2026 年 8 月），运行BaiduPCS-Go update可在线升级；
• 参与贡献：Issue 提交通道见 README 的"交流反馈"一节。修复已知问题、完善文档，或者推进 TODO 列表里"转存绕过单次文件数量限制"这类事项，都是不错的切入点。

网盘不再是需要动手点击的工具，让命令行接管重复劳动，把时间留给真正重要的事。

【免费下载链接】BaiduPCS-Goiikira/BaiduPCS-Go原版基础上集成了分享链接/秒传链接转存功能项目地址: https://gitcode.com/GitHub_Trending/ba/BaiduPCS-Go