README

BaiduPCS-Go 百度网盘客户端(加强版)


仿 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
   Linux / macOS
   Android / iOS
- 命令列表及说明
   注意 ! ! !
   检测程序更新
   登录百度帐号
   列出帐号列表
   获取当前帐号
   切换百度帐号
   退出百度帐号
   获取网盘配额
   切换工作目录
   输出工作目录
   列出目录
   列出目录树形图
   获取文件/目录的元信息
   搜索文件
   下载文件/目录
   上传文件/目录
   获取下载直链
   修复文件MD5
   创建目录
   删除文件/目录
   拷贝文件/目录
   移动/重命名文件/目录
   转存文件/目录
   分享文件/目录
    + 设置分享文件/目录
    + 列出已分享文件/目录
    + 取消分享文件/目录
   离线下载
    + 添加离线下载任务
    + 精确查询离线下载任务
    + 查询离线下载任务列表
    + 取消离线下载任务
    + 删除离线下载任务
   回收站
    + 列出回收站文件列表
    + 还原回收站文件或目录
    + 删除回收站文件或目录/清空回收站
   显示和修改程序配置项
   测试通配符
   工具箱
- 初级使用教程
   1. 查看程序使用说明
   2. 登录百度帐号 (必做)
   3. 切换网盘工作目录
   4. 网盘内列出文件和目录
   5. 下载文件
   6. 设置下载最大并发量
   7. 恢复默认配置
   8. 退出程序
- 已知问题
- TODO
- 交流反馈



 特色

多平台支持, 支持 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:
 该版本存在已知问题将导致上传文件失败及出现空文件，建议跳过更新
- 2022新年好, 本次更新增加较多特性, 欢迎测试
- fix 146, 提前f