5分钟上手BaiduPCS-Go:百度网盘命令行管理实用教程
【免费下载链接】BaiduPCS-Goiikira/BaiduPCS-Go原版基础上集成了分享链接/秒传链接转存功能项目地址: https://gitcode.com/GitHub_Trending/ba/BaiduPCS-Go
在网盘里取回几十个文件,网页版只能逐个勾选;转存别人的分享链接,要在浏览器里点很多次。BaiduPCS-Go 是一个百度网盘命令行客户端,把这些操作搬进终端:网页上要点一下的活,在这里敲一行命令就完成。
它是什么
BaiduPCS-Go 是用 Go 语言写的百度网盘命令行客户端,基于 iikira 原版 BaiduPCS-Go 继续开发,额外集成了分享链接转存功能,这是它和原版最直接的区别。命令体系仿照 Linux shell:cd 切目录、ls 列文件、rm 删除、d 下载,全程支持通配符和 Tab 补全。相比官方客户端,它多出两个实在的能力:一是把分享链接写进脚本批量转存,二是在服务器上无图形界面地操作网盘。
5分钟上手:安装、登录与第一条命令
安装BaiduPCS-Go:源码编译或预编译版
已有 Go 环境的读者,克隆源码编译是最省事的方式:
git clone https://gitcode.com/GitHub_Trending/ba/BaiduPCS-Go cd BaiduPCS-Go go build编译完在当前目录生成 BaiduPCS-Go 可执行文件,Linux/macOS 用./BaiduPCS-Go运行,Windows 直接双击。README 里也提供了各平台预编译版下载入口,不想编译可以直接下载使用。
BaiduPCS-Go 登录与首次配置
装好后第一步是登录百度账号,最稳的方式是用浏览器里复制的 Cookies:
BaiduPCS-Go login -cookies="BAIDUID=...; BDUSS=...; STOKEN=..."成功后提示符变为BaiduPCS-Go:<工作目录> <百度ID>$形式,说明账号就绪。没有完整 Cookies 时也可以用-bduss和-stoken组合登录,但 STOKEN 必须在百度网盘页面获取,里面没有大写字母多半是拿错了字段。
跑通第一条命令:quota 与 ls
登录后先查网盘容量,确认整条链路没问题:
BaiduPCS-Go quota输出网盘的总空间和已用空间。接着切到常用的目录列出内容:
BaiduPCS-Go cd /我的资源 BaiduPCS-Go ls目录支持通配符匹配,cd /我的*效果相同;切进去之后,后续命令写文件名即可,不用每次输全路径。
三个高频任务拆解
把分享链接批量转存到网盘
这个项目最常被用到的就是分享转存,支持带密码的链接。先 cd 到想存放的目录,再执行:
BaiduPCS-Go transfer https://pan.baidu.com/s/1abc123 edv4命令输出“转存成功, 保存了xxx到当前目录”,文件立即出现在网盘当前工作目录下。注意两点:转存只能保存到当前工作目录,目录要提前切好;链接自带?pwd=xxxx形式的提取码时,第二个参数可省略。加--collect可把多个文件整合进一个文件夹,加--fs_id能绕过转存数量限制。核心逻辑在 internal/pcscommand/transfer.go,它解析链接和提取码后,重放网页端的保存请求。
从网盘批量下载指定类型的文件
整目录批量取回时,先确认通配符会命中哪些文件,避免误操作:
BaiduPCS-Go match /视频/*.mp4输出符合预期后直接下载:
BaiduPCS-Go d /视频/*.mp4文件默认存到程序所在目录的 download/ 目录,重名文件自动跳过,用--saveto可指定保存位置。下载引擎在 requester/downloader/,支持断点续传,单次运行还能用-p指定并行线程数。
本地文件上传与同步到网盘
上传是下载的逆过程,同名文件的处理策略决定它能否反复使用:
BaiduPCS-Go upload ./project /备份 --policy rsync默认跳过同名文件;rsync 策略只跳过大小未变化的文件、其余覆盖,适合定期备份。上传默认检测秒传,加--norapid可跳过。上传引擎在 requester/uploader/,分片上传,单文件支持到 128G。有一点要提前知道:受官方接口变动影响,v4.0.0 起上传不再支持断点续传,大文件中断后要重传。
自动化组合:批量转存与定时备份
命令能单独跑通后,价值在于组合成脚本。思路一,批量转存:links.txt 每行一条“链接|提取码”,循环执行:
while IFS='|' read -r link pwd; do BaiduPCS-Go transfer "$link" "$pwd" sleep 2 done < links.txt每转存完一条停 2 秒,避免请求过于频繁。思路二,cron 定时备份,在 crontab 里加一行:
0 3 * * * /path/to/BaiduPCS-Go upload ~/logs /备份/日志 --policy rsync每天凌晨 3 点把日志上传到网盘,rsync 保证未变化的文件不重复传。两个脚本都依赖登录态已写入配置文件,登录一次即可长期生效。
BaiduPCS-Go 并发配置与常见失败排错
并发数是最容易配错的一项。程序不提供超出官方客户端的提速,普通用户调大线程数会很快触发限速,导致几小时到几天内账号在所有客户端都接近 0 速:
| 配置项 | 普通用户 | SVIP |
|---|---|---|
| max_parallel 下载并发 | 1 | 10~20 |
| max_download_load 同时下载文件数 | 1 | 1~2 |
修改配置一行命令即可:
BaiduPCS-Go config set -max_parallel 1 -savedir ~/Downloads其他常见失败,按现象对号入座:
- 登录失败、报 STOKEN 缺失:重新从浏览器获取 Cookies,确认 BDUSS、STOKEN、BAIDUID 字段齐全,STOKEN 务必在百度网盘页面取。
- 上传异常:先确认是否卡在服务器地址上。v3.9.8 后默认动态获取 pcs 服务器,需要静态地址时配置
fix_pcs_addr打开,可选地址如pcs.baidu.com、c.pcs.baidu.com等。 - 下载校验 MD5 不通过但文件实际正常:这是已知问题,下载时加
--nocheck,或在配置中启用no_check。 - 交互式登录繁琐:触发手机或邮箱验证时,图片验证码至少要输入两到四次,且该方式已长期不维护,长期使用建议直接走 Cookies 登录。
- 配置改乱了:
BaiduPCS-Go config reset恢复全部默认值。
配置文件在 Windows 位于%APPDATA%\BaiduPCS-Go,其他系统在~/.config/BaiduPCS-Go,可用环境变量BAIDUPCS_GO_CONFIG_DIR指定位置;BaiduPCS-Go env显示当前环境变量,排查问题时设置BAIDUPCS_GO_VERBOSE可打开调试输出。
接下来做什么
建议的顺序:先熟悉 cd、ls、d、u 四个命令,再试 transfer 和通配符批量下载,然后用 config 检查一遍并发配置。完整参数直接看程序里的help命令和 README 的命令列表,接口相关文档在 docs/README.md。遇到问题先翻项目 Issues 页,同类报错大多有现成的处理记录。终端一行命令顶浏览器二十次点击,这个工具的价值就在这里。
【免费下载链接】BaiduPCS-Goiikira/BaiduPCS-Go原版基础上集成了分享链接/秒传链接转存功能项目地址: https://gitcode.com/GitHub_Trending/ba/BaiduPCS-Go
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考