BaiduPCS-Go 使用指南：3 条命令下网盘文件，1 个脚本挂定时备份-平芜编程栈

BaiduPCS-Go 使用指南：3 条命令下网盘文件，1 个脚本挂定时备份

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

BaiduPCS-Go 是一款用 Go 编写的百度网盘命令行客户端，一行命令就能在终端里下载、上传、转存网盘文件，还能直接挂 cron 做定时备份。适合刚学命令行、运维和开发同学，10 分钟内完成第一次下载。

🧰 它能替你干哪些活

平时要开着浏览器点来点去的活，现在一条命令一个：

服务器数据目录每天定时备份到网盘
整目录批量下载到本地或服务器
带密码的分享链接直接转存到自己网盘
构建产物、日志文件批量上传
把网盘操作写进 CI 或 shell 脚本
按关键字搜索网盘里的文件

🚀 三步跑起来

3 条命令，2 分钟，第一个文件就能落到本地目录。

第一步：装好它。需要本机装过 Go，克隆仓库后直接编译出可执行文件：

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

第二步：登录一次。在浏览器登录百度网盘，F12 打开 Network 面板复制完整 Cookies，然后：

./BaiduPCS-Go login -cookies="<粘贴完整Cookies>"

看到"百度帐号登录成功"就对了，登录态会写进配置文件，后面不用重复登录。

第三步：下第一个文件。把<网盘文件路径>换成你网盘里的真实路径（比如/我的资源/demo.txt）：

./BaiduPCS-Go download -saveto ~/Downloads <网盘文件路径>

文件会存到~/Downloads。中断也没关系，重新执行同一条命令即可接着下——断点续传是内置的，下载进度记录在本地（下载器实现位于 requester/downloader/）。

📤 高频功能上手

登录之后，这 3 个能力马上就能用。

上传本地文件与断点续传

上传默认走分片方式，同名文件不会覆盖目录：

./BaiduPCS-Go upload -p 5 -retry 3 ~/data/project.zip /我的资源

参数	含义	建议值
`-p`	单文件最大上传线程数	3-5
`-l`	同时上传的最大文件数	1-2
`-retry`	失败最大重试次数	3
`-norapid`	跳过秒传校验	秒传反复失败时加

注意：v4.0.0 起官方接口变化导致上传不再支持断点续传，靠-retry自动重试兜底；下载不受影响。

分享链接一条命令转存

这是它相对传统客户端多出来的能力：把别人分享的链接直接搬进自己网盘，不用开浏览器。

./BaiduPCS-Go transfer https://pan.baidu.com/s/<分享码> <提取码>

执行后终端会先列出分享里的文件清单，再逐个转存到你当前网盘工作目录，最后打印转存结果；加-download参数则转存完直接下载到本地。转存逻辑在 baidupcs/ 模块里实现。

目录管理与搜索

./BaiduPCS-Go ls -size -desc /我的资源 ./BaiduPCS-Go search -r 报表

ls支持按大小倒序列目录，search -r递归按文件名搜索，配合通配符（如/我的资源/*.pdf）做批量操作很方便。

🕒 服务器里自动备份

把这段脚本交给 cron，服务器每天自动备份到网盘，只保留最近 30 天：

#!/bin/bash # 定时备份：每天把 /data/projects 传到网盘，只保留最近 30 天 BIN=/usr/local/bin/BaiduPCS-Go # 可执行文件位置，按实际安装路径改 SRC=/data/projects # 要备份的本地目录 DEST=/我的资源/服务器备份 # 网盘上的备份目录 DATE=$(date +%Y%m%d) # 本次备份日期，如 20260927 $BIN mkdir "$DEST/$DATE" || true # 建当天目录，已存在则跳过 $BIN upload -retry 3 "$SRC" "$DEST/$DATE" # 上传数据目录，失败自动重试 3 次 # 清理逻辑：倒序列出目录，第 31 个开始就是超过 30 天的旧备份，逐个删除 $BIN ls "$DEST" | awk 'NR>2 && NF {print $NF}' | sort -r | tail -n +31 | while read -r d; do [ -n "$d" ] && $BIN rm "$DEST/$d" && echo "已删除旧备份: $d" >> /var/log/baidu_backup.log done

保存为/root/baidu_backup.sh并chmod +x，然后写进 crontab（每天 02:00 执行）：

0 2 * * * /root/baidu_backup.sh >> /var/log/baidu_backup.log 2>&1

🛠 排错 FAQ

你八成只会遇到下面 4 种错，每条都给一条命令解决。

现象：某次操作突然报"登录失败/会话失效"原因：Cookies 过期了，登录态是写在本地配置里的。解决：重新从浏览器复制 Cookies 再登录一次。

./BaiduPCS-Go login -cookies="<新的Cookies>"

现象：下载速度长期卡在 KB/s原因：并发设置和你账号的限速档不匹配，普通账号开高并发反而被限。解决：把并发拉回保守值，普通用户 1-5 即可。

./BaiduPCS-Go config set -max_parallel 5 -max_download_load 2

现象：下载报 "user is not authorized"原因：默认 locate 模式取直链失败，换 pcs 模式即可。

./BaiduPCS-Go download -mode pcs <网盘文件路径>

现象：大文件传到一半失败原因：秒传校验没通过或线程中断，跳过秒传并加重试。

./BaiduPCS-Go upload -norapid -retry 3 <本地文件> /我的资源

⚙️ 进阶小技

三条设置，用同一个工具体验会完全不同。

多账号切换：先./BaiduPCS-Go login登录多个账号，之后./BaiduPCS-Go su交互式切换，./BaiduPCS-Go loglist查看已登录列表。
并发调参：普通用户-max_parallel保持 1-5，SVIP 可试 8-12（官方建议下载线程不超过 12），例如./BaiduPCS-Go config set -max_parallel 12。
日志开关：任意命令前加-verbose看调试输出，例如./BaiduPCS-Go -verbose download /我的资源，排错时很有用。