MCPcopy
hub / github.com/qjfoidnh/BaiduPCS-Go

github.com/qjfoidnh/BaiduPCS-Go @v4.0.1 sqlite

repository ↗ · DeepWiki ↗ · release v4.0.1 ↗
1,170 symbols 3,418 edges 191 files 728 documented · 62%
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, macOS, linux, 移动设备等.

百度帐号多用户支持;

通配符匹配网盘路径和 Tab 自动补齐命令和路径, 通配符_百度百科;

下载网盘内文件, 支持多个文件或目录下载, 支持断点续传和单文件并行下载;

上传本地文件, 支持上传最大128G大文件, 支持多个文件或目录上传;

转存其他用户分享的文件, 支持带密码的分享链接;

离线下载, 支持http/https/ftp/电驴/磁力链协议.

版本更新

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, 提前fail和skip上传策略中重名文件的检测环节(存在问题)
  • fix #158, config可配置关闭文件名合法性检测
  • fix #141, download增加--mtime选项可保持文件修改时间
  • fix #130, config可配置force_login_username, 强制登录指定用户名
  • 首条下载链接不可用时自动切换, 增加下载成功率

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:

  • 优化了上传的输出信息格式
  • 优化了上传逻辑,提升上传速度
  • transfer增加--fix参数,可转存被屏蔽的秒传链接(inspired by dupan-rapid-extract

2021.3.11 v3.7.7:

  • fix 移动和重命名文件时末尾/导致报错
  • fix 3.7.2版本后在线升级无效
  • fix 转存误报缺少STOKEN

2021.2.23 v3.7.6:

  • fix 下载文件报x509: certificate is valid错误
  • 完善了下载错误的捕获种类
  • download增加--fullpath参数,本地目录保留网盘从根目录开始的完整结构

2021.2.8 v3.7.5:

  • fix 某些时候误报stoken缺失
  • fix windows平台上秒传链接转存失败
  • fix 某些时候pcs请求缺少Host
  • 当分享链接包含多文件/目录时,可选归档到第一个文件命名的目录里(不支持秒传)

2021.1.31 v3.7.4:

  • fix 下载目录会丢失目录结构
  • fix 分享列表状态信息显示错误
  • 支持自定义文件上传服务器

2021.1.22 v3.7.3:

  • 分享支持自定义分享码和有效天数
  • 转存支持转存完毕后自动下载到默认目录
  • 增加恢复默认配置功能
  • tree命令支持指定输出最大层数和带fsid输出

2021.1.9 v3.7.2:

  • 基本修复了登录验证失效问题(#15)
  • 优化下载模块的实现策略, 保证稳定性同时进一步提升下载速度 (需按显示和修改程序配置项中建议修改)
  • update 功能恢复, 以后可以在线升级了
  • 支持导出秒传链接不写文件, 直接输出到控制台; 支持通用秒传格式导出, 具体参见export --help
  • 其他bug修正

2021.1.2 v3.7.1:

  • 支持了多文件并发上传,文件并发数和单文件分片数可在配置中指定
  • 修复了最大同时下载文件数配置不生效的问题
  • 修正了部分显示和帮助的错误

2020.12.19 v3.7.0:

  • 替换了iikira版本的失效仓库
  • 转存功能支持旧的短链接
  • 默认关闭下载文件校验,配置文件可设置开启
  • 修复了关闭校验时会误报下载失败的问题
  • 转存功能除了cookies方式登录,现已支持用户名密码登录和bduss登录;bduss登录需同时指定stoken

2020.11.08 v3.6.3:

  • 修复转存失败
  • 修复分享文件失败

编译/交叉编译 说明

设置好 GOOS 和 GOARCH 环境变量,

运行 go tool dist list 查看所有支持的 GOOS/GOARCH

Linux/Darwin 例子: 编译 Windows 下的 64 位程序

GOOS=windows GOARCH=amd64 CGO_ENABLED=0 go build

Windows 例子: 编译 Linux 下的 32 位程序

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>$

程序会提供相关命令的使用说明.

安装

Windows

程序应在 命令提示符 (Command Prompt) 或 PowerShell 中运行, 在 mintty (例如: GitBash) 可能会有显示问题.

也可直接双击程序运行, 具体使用方法请参见 命令列表及说明初级使用教程.

Linux / macOS

程序应在 终端 (Terminal) 运行.

具体使用方法请参见 命令列表及说明初级使用教程.

Android / iOS

Android / iOS 移动设备操作比较麻烦, 不建议在移动设备上使用本程序. 移动设备不可直接使用预编译的Linux arm64版本, 使用者需下载源码自行交叉编译.

安卓, 建议使用 TermuxNeoTerm 或 终端模拟器, 以提供终端环境.

示例: Android 运行本项目程序参考示例, 有兴趣的可以参考一下.

苹果iOS, 需要越狱, 在 Cydia 搜索下载并安装 MobileTerminal, 或者其他提供终端环境的软件.

示例: iOS 运行本项目程序参考示例, 有兴趣的可以参考一下.

具体使用方法请参见 命令列表及说明初级使用教程.

命令列表及说明

注意 ! ! !

命令的前缀 BaiduPCS-Go 为指向程序运行的全路径名 (ARGv 的第一个参数)

直接运行程序时, 未带任何其他参数, 则程序进入cli交互模式, 运行以下命令时, 要把命令的前缀 BaiduPCS-Go 去掉!

cli交互模式已支持按tab键自动补全命令和路径.

检测程序更新

BaiduPCS-Go update

登录百度帐号

常规登录百度帐号

支持在线验证绑定的手机号或邮箱, 注: 此方式已长期不维护, 建议使用其他登录方式

BaiduPCS-Go login

使用百度 BDUSS 和 百度网盘 STOKEN 来登录百度账号

关于 获取百度 BDUSS STOKEN 获取方式与 BDUSS 基本相同。注意 STOKEN 必须在百度网盘页面获取,否则无效. STOKEN是cookie中的一个字段, 注意不是bdstoken, 如果拿到的STOKEN里没有大写字母多半是拿错了

BaiduPCS-Go login -bduss=<BDUSS> -stoken=<STOKEN>

使用百度 Cookies 来登录百度账号(推荐)

关于 获取百度 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, 默认为 locate, 相关说明见上面的帮助 (default: "locate")
  -p value        指定下载线程数 (default: 0)
  -l value        指定同时进行下载文件的数量 (default: 0)
  --retry value   下载失败最大重试次数 (default: 3)
  --nocheck       下载文件完成后不校验文件

下载的文件默认保存到 程序所在目录 的 download/ 目录, 支持设置指定目录, 重名的文件会自动跳过!

下载的文件默认保存到, 程序所在目录download/ 目录.

通过 BaiduPCS-Go config set -savedir <savedir>, 自定义保存的目录.

支持多个文件或目录下载.

自动跳过下载重名的文件!

例子

# 设置保存目录, 保存到 D:\Downloads
# 注意区别反斜杠 "\" 和 斜杠 "/" !!!
BaiduPCS-Go config set -savedir D:/Downloads

# 下载 /我的资源/1.mp4
BaiduPCS-Go d /我的资源/1.mp4

# 下载 /我的资源 整个目录!!
BaiduPCS-Go d /我的资源

# 下载网盘内的全部文件!!
BaiduPCS-Go d /
BaiduPCS-Go d *

上传文件/目录

BaiduPCS-Go upload <本地文件/目录的路径1> <文件/目录2> <文件/目录3> ... <目标目录>
BaiduPCS-Go u <本地文件/目录的路径1> <文件/目录2> <文件/目录3> ... <目标目录>
  • 上传默认采用分片上传的方式, 上传的文件将会保存到, <目标目录>. 不支持断点续传

  • 遇到同名文件会自动跳过, 也可配置upload_policy选择覆盖或者只跳过同大小文件

  • 当上传的文件名和网盘的目录名称相同时, 不会覆盖目录, 防止丢失数据.

  • 所有上传均默认检测秒传, 可添加参数--norapid跳过

例子:

# 将本地的 C:\Users\Administrator\Desktop\1.mp4 上传到网盘 /视频 目录
# 注意区别反斜杠 "\" 和 斜杠 "/" !!!
BaiduPCS-Go upload C:/Users/Administrator/Desktop/1.mp4 /视频

# 将本地的 C:\Users\Administrator\Desktop\1.mp4 上传到网盘 /视频 目录, 不检测秒传
BaiduPCS-Go upload C:/Users/Administrator/Desktop/1.mp4 /视频 --norapid

# 将本地的 C:\Users\Administrator\Desktop\1.mp4 和 C:\Users\Administrator\Desktop\2.mp4 上传到网盘 /视频 目录
BaiduPCS-Go upload C:/Users/Administrator/Desktop/1.mp4 C:/Users/Administrator/Desktop/2.mp4 /视频

# 将本地的 C:\Users\Administrator\Desktop 整个目录上传到网盘 /视频 目录, 只覆盖与本地大小不同的同名文件
BaiduPCS-Go upload C:/Users/Administrator/Desktop /视频 --policy rsync

获取下载直链

BaiduPCS-Go locate <文件1> <文件2> ...

例子:

BaiduPCS-Go config set -user_agent "netdisk;2.2.51.6;netdisk;10.0.63;PC;android-android"

导出文件/目录


BaiduPCS-Go export <文件/目录1> <文件/目录2> ...

BaiduPCS-Go ep <文件/目录1> <文件/目录2> ...

导出网盘内的文件或目录, 原理为秒传文件, 此操作会生成导出文件或目录的命令.

注意

秒传已不被支持, 该功能已无实际作用

例子:


# 导出当前工作目录:

BaiduPCS-Go export

# 导出所有文件和目录, 并设置新的根目录为 /root

BaiduPCS-Go export -root=/root /

# 导出 /我的资源

BaiduPCS-Go export /我的资源

# 导出 /我的资源 格式为通用秒传链接格式

BaiduPCS-Go export /我的资源 --link

创建目录

BaiduPCS-Go mkdir <目录>

例子

BaiduPCS-Go mkdir 123

删除文件/目录

BaiduPCS-Go rm <网盘文件或目录的路径1> <文件或目录2> <文件或目录3> ...

注意: 删除多个文件和目录时, 请确保每一个文件和目录都存在, 否则删除操作会失败.

被删除的文件或目录可在网盘文件回收站找回.

例子

# 删除 /我的资源/1.mp4
BaiduPCS-Go rm /我的资源/1.mp4

# 删除 /我的资源/1.mp4 和 /我的资源/2.mp4
BaiduPCS-Go rm /我的资源/1.mp4 /我的资源/2.mp4

# 删除 /我的资源 内的所有文件和目录, 但不删除该目录
BaiduPCS-Go rm /我的资源/*

# 删除 /我的资源 整个目录 !!
BaiduPCS-Go rm /我的资源

拷贝文件/目录

BaiduPCS-Go cp <文件/目录> <目标 文件/目录>
BaiduPCS-Go cp <文件/目录1> <文件/目录2> <文件/目录3> ... <目标目录>

注意: 拷贝多个文件和目录时, 请确保每一个文件和目录都存在, 否则拷贝操作会失败.

例子

# 将 /我的资源/1.mp4 复制到 根目录 /
BaiduPCS-Go cp /我的资源/1.mp4 /

# 将 /我的资源/1.mp4 和 /我的资源/2.mp4 复制到 根目录 /
BaiduPCS-Go cp /我的资源/1.mp4 /我的资源/2.mp4 /

移动/重命名文件/目录

# 移动:
BaiduPCS-Go mv <文件/目录1> <文件/目录2> <文件/目录3> ... <目标目录>
# 重命名:
BaiduPCS-Go mv <文件/目录> <重命名的文件/目录>

注意: 移动多个文件和目录时, 请确保每一个文件和目录都存在, 否则移动操作会失败.

例子

# 将 /我的资源/1.mp4 移动到 根目录 /
BaiduPCS-Go mv /我的资源/1.mp4 /

# 将 /我的资源/1.mp4 重命名为 /我的资源/3.mp4
BaiduPCS-Go mv /我的资源/1.mp4 /我的资源/3.mp4

转存文件/目录

# 转存分享链接里的文件到当前目录:
BaiduPCS-Go transfer <分享链接> <提取码>

注意: 转存文件保存到当前工作目录下, 不支持指定.

例子

```

将 https://pan.baidu.com

Extension points exported contracts — how you extend this code

Lener (Interface)
Lener 返回32-bit长度接口 [8 implementers]
requester/rio/rio.go
Error (Interface)
Error 错误信息接口 [4 implementers]
baidupcs/pcserror/pcserror.go
Readed64 (Interface)
Readed64 增加获取已读取数据量, 用于统计速度 [2 implementers]
requester/uploader/readed.go
Cache (Interface)
Cache cache [1 implementers]
pcsutil/cachepool/cachepool.go
TaskUnit (Interface)
(no doc) [3 implementers]
pcsutil/taskframework/task_unit.go
ChecksumWriter (Interface)
(no doc) [3 implementers]
pcsutil/checksum/checksum_write.go
SignRes (Interface)
SignRes 签名结果 [1 implementers]
baidupcs/internal/panhome/sign.go
ContentTyper (Interface)
ContentTyper Content-Type 接口 [1 implementers]
requester/requester.go

Core symbols most depended-on inside this repo

String
called by 50
baidupcs/publicsuffix.go
Id
called by 47
pcsutil/taskframework/taskinfo.go
Close
called by 42
pcsliner/pcsliner.go
String
called by 42
requester/rio/buf.go
Get
called by 39
pcsutil/cachepool/idcachepool.go
lazyInit
called by 39
baidupcs/baidupcs.go
Infof
called by 38
pcsverbose/pcsverbose.go
sendReqReturnReadCloser
called by 35
baidupcs/prepare.go

Shape

Method 667
Function 293
Struct 149
Interface 27
TypeAlias 19
FuncType 15

Languages

Go100%
TypeScript1%

Modules by API surface

baidupcs/prepare.go47 symbols
requester/transfer/transfer.pb.go31 symbols
baidupcs/baidupcs.go29 symbols
requester/downloader/downloader.go28 symbols
requester/downloader/worker.go26 symbols
requester/downloader/monitor.go26 symbols
requester/transfer/download_status.go24 symbols
internal/pcsconfig/maniper.go24 symbols
baidupcs/file_directory.go21 symbols
baidupcs/cloud_dl.go20 symbols
requester/uploader/multiuploader.go19 symbols
requester/transfer/rangelist.go18 symbols

Dependencies from manifests, versioned

github.com/GeertJohan/go.incrementalv1.0.0 · 1×
github.com/GeertJohan/go.ricev1.0.2 · 1×
github.com/astaxie/beegov1.12.3 · 1×
github.com/bmizerany/assertv0.0.0-2016061122193 · 1×
github.com/cpuguy83/go-md2man/v2v2.0.0-2019031423301 · 1×
github.com/daaku/go.zipexev1.0.2 · 1×
github.com/dgrijalva/jwt-gov3.2.0+incompatible · 1×
github.com/json-iterator/gov1.1.12 · 1×
github.com/kardianos/osextv0.0.0-2019022217332 · 1×

For agents

$ claude mcp add BaiduPCS-Go \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact