☰
5分钟上手BaiduPCS-Go:百度网盘命令行管理实用教程
2026/9/29 2:28:20 网站建设 项目流程

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 下载并发110~20
max_download_load 同时下载文件数11~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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询