仿 Linux shell 文件处理命令的百度网盘命令行客户端.
iikira/BaiduPCS-Go was largely inspired by GangZhuo/BaiduPCS and this project was largely based on iikira/BaiduPCS-Go
此版本基于iikira原版BaiduPCS-Go v3.6.2继续开发, 并添加了转存功能.
本软件不提供超出官方客户端的下载提速, 普通用户和SVIP的配置建议参见 显示和修改程序配置项
多平台支持, 支持 Windows, macOS, linux, 移动设备等.
百度帐号多用户支持;
通配符匹配网盘路径和 Tab 自动补齐命令和路径, 通配符_百度百科;
下载网盘内文件, 支持多个文件或目录下载, 支持断点续传和单文件并行下载;
上传本地文件, 支持上传最大128G大文件, 支持多个文件或目录上传;
转存其他用户分享的文件, 支持带密码的分享链接;
离线下载, 支持http/https/ftp/电驴/磁力链协议.
2026.08.21 v4.0.2 - 修复转存误报STOKEN缺失 - feat: add --fs_id flag to transfer command to support granular file selection - fix: 支持下载/查看对象数量超过1000的目录 - fix: remove quotes from cookie values to prevent invalid byte error - 修复上传失败错误码仍为0 - 转存支持分享口令 - 上传链接复用优化
2026.03.26 v4.0.1 - 紧急修复ls等命令的param error
2025.10.29 v4.0.0
- 上传重新支持跳过秒传--norapid
- 上传同名文件覆盖策略--policy支持skip,overwrite,rsync; 支持config配置全局默认策略
- 因接口变化上传不再支持断点续传, 下载不受影响
- 增加config配置proxy_hostnames, 国外VPS用户如遇上传问题可尝试为pan.baidu.com配置回国代理
- 其他细节优化
2025.08.30 v3.9.9
- 最大上传单文件支持至128G
- 上传速度优化
- 下载取消文件预分配
- 因官方接口变动上传文件强制计算秒传
- transfer命令修复--download参数
2025.08.29 v3.9.8 - 全面修复了上传文件的问题 - 全面修复了下载文件的问题 - 去除部分已不可用的功能和已不支持的参数
2025.01.07 v3.9.7 - fix #359, #360 - fix #339
2024.12.14 v3.9.6 - 关闭秒传转存功能 - 修复常规转存失败
2023.09.30 v3.9.5 - 恢复秒传转存功能, 使用前需设置accessToken, 参见setastoken --help - 本地文件上传用秒传无须accessToken - fix #301 - fix #302
2023.09.06 v3.9.5-beta - 恢复了秒传转存(支持长短链), 感谢油猴脚本开发者tousakarin的贡献 - 新秒传接口需要开发者授权, 稳定性未知, 该测试版本仅供有秒传强需求的用户试用, 请谨慎更新
2023.09.05 v3.9.4 - fix #244, 修复断点上传时偶发崩溃 - 优化本地上传秒传失败时的处理逻辑
2023.08.26 v3.9.3 - 因官方接口从原理层面封禁秒传, 取消秒传转存功能 - 更新部分使用说明 - 建议使用文件上传功能的用户更新此版本
2023.06.03 v3.9.2 - 修复秒传链接无法转存, 因官方接口变动秒传已不再支持短链接格式 - 修复上传文件无法使用秒传 - fix #254 支持-f参数输出带密码分享链接 - fix #251 根据mengzonefire同志提供函数增加md5解密
2023.03.19 v3.9.1 - 修复秒传转存返回错误码9019
2022.12.04 v3.9.0: - 优化转存错误提示 - fix #239 - update go version to 1.18
2022.11.25 v3.8.9: - fix #234, 继续修复无法转存文件
2022.11.12 v3.8.8: - fix #234, 修复无法转存文件
2022.2.18 v3.8.7: - fix #175, 在正式上传前即进行文件大小检测
2022.2.14 v3.8.6: - fix #160 #173, 修复上传出现空文件的bug - fix #165, 支持自带提取码的转存链接 - fix #175, upload增加-policy=rsync策略, 配合--norapid使用, 只跳过大小未发生改变的文件 - 鉴于 #172, 建议下载线程数最大不超过12
2022.1.1 v3.8.5:
2021.10.6 v3.8.4: - fix 登录时可能出现内存溢出 - 上传文件名允许包含单引号
2021.8.27 v3.8.3: - fix 更换默认panUA解决svip限速 - fix 移除失效的秒传修复功能 - 优化秒传逻辑, 提高成功率 - 优化秒传导出逻辑, 提高新文件的导出成功率
2021.7.20 v3.8.2:
- fix 读取大量文件信息容易超时
- fix 秒传链接文件名带"#"时解析错误
- share list增加分享下载数显示
- config增加配置: 上传的同名文件处理策略
2021.6.9 v3.8.1: - fix 部分旧链接无法转存 - 增加上传同名文件自动跳过选项
2021.5.21 v3.8.0: - fix 上传到100M左右自动回滚（待测试） - fix 个别正常的秒传链接无法转存 - fix 文件名含有百分号导出异常 - 优化上传重试策略（待测试）
2021.4.14 v3.7.9: - fix 上传时异常退出导致无法加载断点信息 - fix 上传偶发出现0B/s卡住 - 上传时预先检查文件名合法性 - 在线更新使用镜像源加速
2021.3.20 v3.7.8:
2021.3.11 v3.7.7:
/导致报错2021.2.23 v3.7.6:
x509: certificate is valid错误2021.2.8 v3.7.5:
2021.1.31 v3.7.4:
2021.1.22 v3.7.3:
2021.1.9 v3.7.2:
2021.1.2 v3.7.1:
2020.12.19 v3.7.0:
2020.11.08 v3.6.3:
设置好 GOOS 和 GOARCH 环境变量,
运行 go tool dist list 查看所有支持的 GOOS/GOARCH
GOOS=windows GOARCH=amd64 CGO_ENABLED=0 go build
set GOOS=linux
set GOARCH=386
set CGO_ENABLED=0
go build
Go语言程序, 常用几种平台的已编译程序可直接在蓝奏云下载使用. 密码:4pix
如果程序运行时输出乱码, 请检查下终端的编码方式是否为 UTF-8.
使用本程序之前, 建议学习一些 linux 基础知识 和 基础命令.
如果未带任何参数运行程序, 程序将会进入仿Linux shell系统用户界面的cli交互模式, 可直接运行相关命令.
cli交互模式下, 光标所在行的前缀应为 BaiduPCS-Go >, 如果登录了百度帐号则格式为 BaiduPCS-Go:<工作目录> <百度ID>$
程序会提供相关命令的使用说明.
程序应在 命令提示符 (Command Prompt) 或 PowerShell 中运行, 在 mintty (例如: GitBash) 可能会有显示问题.
也可直接双击程序运行, 具体使用方法请参见 命令列表及说明 和 初级使用教程.
程序应在 终端 (Terminal) 运行.
Android / iOS 移动设备操作比较麻烦, 不建议在移动设备上使用本程序. 移动设备不可直接使用预编译的Linux arm64版本, 使用者需下载源码自行交叉编译.
安卓, 建议使用 Termux 或 NeoTerm 或 终端模拟器, 以提供终端环境.
示例: Android 运行本项目程序参考示例, 有兴趣的可以参考一下.
苹果iOS, 需要越狱, 在 Cydia 搜索下载并安装 MobileTerminal, 或者其他提供终端环境的软件.
示例: iOS 运行本项目程序参考示例, 有兴趣的可以参考一下.
命令的前缀 BaiduPCS-Go 为指向程序运行的全路径名 (ARGv 的第一个参数)
直接运行程序时, 未带任何其他参数, 则程序进入cli交互模式, 运行以下命令时, 要把命令的前缀 BaiduPCS-Go 去掉!
cli交互模式已支持按tab键自动补全命令和路径.
BaiduPCS-Go update
支持在线验证绑定的手机号或邮箱, 注: 此方式已长期不维护, 建议使用其他登录方式
BaiduPCS-Go login
关于 获取百度 BDUSS STOKEN 获取方式与 BDUSS 基本相同。注意 STOKEN 必须在百度网盘页面获取，否则无效. STOKEN是cookie中的一个字段, 注意不是bdstoken, 如果拿到的STOKEN里没有大写字母多半是拿错了
BaiduPCS-Go login -bduss=<BDUSS> -stoken=<STOKEN>
关于 获取百度 Cookies 教程中为百度经验的Cookies获取, 这里换成百度网盘首页即可.
BaiduPCS-Go login -cookies=<Cookies>
BaiduPCS-Go login -bduss=1234567 -stoken=234567
BaiduPCS-Go login # 交互式login已不再维护，不推荐使用
请输入百度用户名(手机号/邮箱/用户名), 回车键提交 > 1234567
BaiduPCS-Go login -cookies="BAIDUID=50949C0890YG9735EA6Q3870AFE38:FG=1; BIDUPSID=112335C0ACCAFFJW675EA69A870AFE38; PSTM=1981928511; BDORZ=D6745EBF6F3SW24E515D22A1598; PANWEB=1; BDUSS=ASAYUGFHSTFKGBGSU; STOKEN=gfsdge9gisfgspig34254d7879eee5756b10sgeyrw5vyw342td510ffc9414d32251; SCRC=cwrywec5evyetra26bvvehefvfg6a8; BDCLND=C%4sfgGysrZ%2BML6; PANPSC=wreyewygdfhdggedhsdfg4353"
BaiduPCS-Go loglist
列出所有已登录的百度帐号
BaiduPCS-Go who
切换已登录的百度帐号
BaiduPCS-Go su <uid>
BaiduPCS-Go su
请输入要切换帐号的 # 值 >
退出当前登录的百度帐号
BaiduPCS-Go logout
程序会进一步确认退出帐号, 防止误操作.
BaiduPCS-Go quota
获取网盘的总储存空间, 和已使用的储存空间
BaiduPCS-Go cd <目录>
BaiduPCS-Go cd -l <目录>
# 切换 /我的资源 工作目录
BaiduPCS-Go cd /我的资源
# 切换 上级目录
BaiduPCS-Go cd ..
# 切换 根目录
BaiduPCS-Go cd /
# 切换 /我的资源 工作目录, 并自动列出 /我的资源 下的文件和目录
BaiduPCS-Go cd -l 我的资源
# 使用通配符
BaiduPCS-Go cd /我的*
BaiduPCS-Go pwd
列出当前工作目录的文件和目录或指定目录
BaiduPCS-Go ls
BaiduPCS-Go ls <目录>
-asc: 升序排序
-desc: 降序排序
-time: 根据时间排序
-name: 根据文件名排序
-size: 根据大小排序
# 列出 我的资源 内的文件和目录
BaiduPCS-Go ls 我的资源
# 绝对路径
BaiduPCS-Go ls /我的资源
# 降序排序
BaiduPCS-Go ls -desc 我的资源
# 按文件大小降序排序
BaiduPCS-Go ls -size -desc 我的资源
# 使用通配符
BaiduPCS-Go ls /我的*
列出当前工作目录的文件和目录或指定目录的树形图
BaiduPCS-Go tree <目录>
# 默认获取工作目录元信息
BaiduPCS-Go tree
BaiduPCS-Go meta <文件/目录1> <文件/目录2> <文件/目录3> ...
# 默认获取工作目录元信息
BaiduPCS-Go meta
BaiduPCS-Go meta 我的资源
BaiduPCS-Go meta /
按文件名搜索文件（不支持查找目录）。
默认在当前工作目录搜索.
BaiduPCS-Go search [-path=<需要检索的目录>] [-r] <关键字>
# 搜索根目录的文件
BaiduPCS-Go search -path=/ 关键字
# 搜索当前工作目录的文件
BaiduPCS-Go search 关键字
# 递归搜索当前工作目录的文件
BaiduPCS-Go search -r 关键字
BaiduPCS-Go download <网盘文件或目录的路径1> <文件或目录2> <文件或目录3> ...
BaiduPCS-Go d <网盘文件或目录的路径1> <文件或目录2> <文件或目录3> ...
``` --test 测试下载, 此操作不会保存文件到本地 --ow overwrite, 覆盖已存在的文件 --status 输出所有线程的工作状态 --save 将下载的文件直接保存到当前工作目录 --saveto value 将下载的文件直接保存到指定的目录 -x 为文件加上执行权限, (windows系统无效) --mode value 下载模式, 可选值: pcs, stream, locate, 默认为 l
| 日期 | 榜单 | 排名 | 周期新增 | 总 STAR |
|---|