winget install --id=qjfoidnh.BaiduPCS-Go -e A command-line Baidu Netdisk client written in Go, providing useful functionalities for operating Baidu Netdisk. This version is based on iikira's original BaiduPCS-Go v3.6.2, with additional ability of saving shared files.
仿 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/电驴/磁力链协议.
2025.08.30 v3.9.9
2025.08.29 v3.9.8
2025.01.07 v3.9.7
2024.12.14 v3.9.6
2023.09.30 v3.9.5
2023.09.06 v3.9.5-beta
2023.09.05 v3.9.4
2023.08.26 v3.9.3
2023.06.03 v3.9.2
2023.03.19 v3.9.1
2022.12.04 v3.9.0:
2022.11.25 v3.8.9:
2022.11.12 v3.8.8:
2022.2.18 v3.8.7:
2022.2.14 v3.8.6:
2022.1.1 v3.8.5:
2021.10.6 v3.8.4:
2021.8.27 v3.8.3:
2021.7.20 v3.8.2:
2021.6.9 v3.8.1:
2021.5.21 v3.8.0:
2021.4.14 v3.7.9:
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版本, 使用者需下载源码自行交叉编译.
示例: Android 运行本项目程序参考示例, 有兴趣的可以参考一下.
苹果iOS, 需要越狱, 在 Cydia 搜索下载并安装 MobileTerminal, 或者其他提供终端环境的软件.
示例: iOS 运行本项目程序参考示例, 有兴趣的可以参考一下.
命令的前缀 BaiduPCS-Go 为指向程序运行的全路径名 (ARGv 的第一个参数)
直接运行程序时, 未带任何其他参数, 则程序进入cli交互模式, 运行以下命令时, 要把命令的前缀 BaiduPCS-Go 去掉!
cli交互模式已支持按tab键自动补全命令和路径.
BaiduPCS-Go update
支持在线验证绑定的手机号或邮箱, 注: 此方式已长期不维护, 建议使用其他登录方式
BaiduPCS-Go login
关于 获取百度 BDUSS STOKEN 获取方式与 BDUSS 基本相同。注意 STOKEN 必须在百度网盘页面获取，否则无效.
BaiduPCS-Go login -bduss= -stoken=
关于 获取百度 Cookies 教程中为百度经验的Cookies获取, 这里换成百度网盘首页即可.
BaiduPCS-Go login -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
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 , 自定义保存的目录.
支持多个文件或目录下载.
自动跳过下载重名的文件!
# 设置保存目录, 保存到 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> ... <目标目录>
上传默认采用分片上传的方式, 上传的文件将会保存到, <目标目录>.
遇到同名文件会自动跳过
当上传的文件名和网盘的目录名称相同时, 不会覆盖目录, 防止丢失数据.
# 将本地的 C:\Users\Administrator\Desktop\1.mp4 上传到网盘 /视频 目录
# 注意区别反斜杠 "\" 和 斜杠 "/" !!!
BaiduPCS-Go upload C:/Users/Administrator/Desktop/1.mp4 /视频
# 将本地的 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 /视频
BaiduPCS-Go locate <文件1> <文件2> ...
若该功能无法正常使用, 提示user is not authorized, hitcode:xxx, 尝试更换 User-Agent 为 netdisk;2.2.51.6;netdisk;10.0.63;PC;android-android:
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/s/12L_ZZVNxz5f_2CccoyyVrW (提取码edv4) 转存到当前目录
BaiduPCS-Go transfer https://pan.baidu.com/s/12L_ZZVNxz5f_2CccoyyVrW edv4
BaiduPCS-Go transfer https://pan.baidu.com/s/12L_ZZVNxz5f_2CccoyyVrW?pwd=edv4
BaiduPCS-Go share
BaiduPCS-Go share set <文件/目录1> <文件/目录2> ...
BaiduPCS-Go share s <文件/目录1> <文件/目录2> ...
BaiduPCS-Go share list
BaiduPCS-Go share l
BaiduPCS-Go share cancel ...
BaiduPCS-Go share c ...
目前只支持通过分享id (shareid) 来取消分享.
BaiduPCS-Go offlinedl
BaiduPCS-Go clouddl
BaiduPCS-Go od
离线下载支持http/https/ftp/电驴/磁力链协议
离线下载同时进行的任务数量有限, 超出限制的部分将无法添加.
BaiduPCS-Go offlinedl add -path=<离线下载文件保存的路径> 资源地址1 地址2 ...
添加任务成功之后, 返回离线下载的任务ID.
BaiduPCS-Go offlinedl query 任务ID1 任务ID2 ...
BaiduPCS-Go offlinedl list
BaiduPCS-Go offlinedl cancel 任务ID1 任务ID2 ...
BaiduPCS-Go offlinedl delete 任务ID1 任务ID2 ...
# 清空离线下载任务记录, 程序不会进行二次确认, 谨慎操作!!!
BaiduPCS-Go offlinedl delete -all
# 将百度和腾讯主页, 离线下载到根目录 /
BaiduPCS-Go offlinedl add -path=/ http://baidu.com http://qq.com
# 添加磁力链接任务
BaiduPCS-Go offlinedl add magnet:?xt=urn:btih:xxx
# 查询任务ID为 12345 的离线下载任务状态
BaiduPCS-Go offlinedl query 12345
# 取消任务ID为 12345 的离线下载任务
BaiduPCS-Go offlinedl cancel 12345
BaiduPCS-Go recycle
回收站操作.
BaiduPCS-Go recycle list
--page value 回收站文件列表页数 (default: 1)
BaiduPCS-Go recycle restore ...
根据文件/目录的 fs_id, 还原回收站指定的文件或目录.
BaiduPCS-Go recycle delete [-all] ...
根据文件/目录的 fs_id 或 -all 参数, 删除回收站指定的文件或目录或清空回收站.
# 从回收站还原两个文件, 其中的两个文件的 fs_id 分别为 1013792297798440 和 643596340463870
BaiduPCS-Go recycle restore 1013792297798440 643596340463870
# 从回收站删除两个文件, 其中的两个文件的 fs_id 分别为 1013792297798440 和 643596340463870
BaiduPCS-Go recycle delete 1013792297798440 643596340463870
# 清空回收站, 程序不会进行二次确认, 谨慎操作!!!
BaiduPCS-Go recycle delete -all
BaiduPCS-Go env
BAIDUPCS_GO_CONFIG_DIR: 配置文件路径,
BAIDUPCS_GO_VERBOSE: 是否启用调试.
# 显示配置
BaiduPCS-Go config
# 设置配置
BaiduPCS-Go config set
注意: v3.5 以后, 程序对配置文件储存路径的寻找做了调整, 配置文件所在的目录可以是程序本身所在目录, 也可以是家目录.
配置文件所在的目录为家目录的情况:
Windows: %APPDATA%\BaiduPCS-Go
其他操作系统: $HOME/.config/BaiduPCS-Go
可通过设置环境变量 BAIDUPCS_GO_CONFIG_DIR, 指定配置文件存放的目录.
谨慎修改 appid, user_agent, pcs_ua, pan_ua 的值, 否则访问网盘服务器时, 可能会出现错误.
如上传遇到异常可尝试修改 pcs_addr, 目前已知的地址有:
pcs.baidu.com
c.pcs.baidu.com
c2.pcs.baidu.com
c3.pcs.baidu.com
c4.pcs.baidu.com
c5.pcs.baidu.com
d.pcs.baidu.com
v3.9.8后上传时支持动态获取pcs服务器, 理论上不需要手动配置. 如希望使用静态pcs服务器, 可配置打开fix_pcs_addr
cache_size 的值支持可选设置单位了, 单位不区分大小写, b 和 B 均表示字节的意思, 如 64KB, 1MB, 32kb, 65536b, 65536.
max_download_rate, max_upload_rate 的值支持可选设置单位了, 单位为每秒的传输速率, 后缀/s 可省略, 如 2MB/s, 2MB, 2m, 2mb 均为一个意思.
普通用户请将max_parallel和max_download_load都设置为1, 调大线程数只会在短时间内提升下载速度, 且极易很快触发限速, 导致几小时至几天内账号在各客户端都接近0速. 本软件不支持普通用户提速.
SVIP用户建议max_parallel设置为10以上, 根据实际带宽可调大, 但不建议超过20, max_download_load设置为1 - 2, 实验表明可以稳定满速下载.
# 显示所有可以设置的值
BaiduPCS-Go config -h
BaiduPCS-Go config set -h
# 设置下载文件的储存目录
BaiduPCS-Go config set -savedir D:/Downloads
# 设置下载最大并发量为 15
BaiduPCS-Go config set -max_parallel 15
# 组合设置
BaiduPCS-Go config set -max_parallel 150 -savedir D:/Downloads
BaiduPCS-Go match <通配符表达式>
测试通配符匹配路径, 操作成功则输出所有匹配到的路径.
# 匹配 /我的资源 目录下所有mp4格式的文件
BaiduPCS-Go match /我的资源/*.mp4
BaiduPCS-Go tool
目前工具箱支持加解密文件等.
新手建议: 双击运行程序, 进入仿 Linux shell 的 cli 交互模式;
cli交互模式下, 光标所在行的前缀应为 BaiduPCS-Go >, 如果登录了百度帐号则格式为 BaiduPCS-Go:<工作目录> <百度ID>$
以下例子的命令, 均为 cli交互模式下的命令
运行命令的正确操作: 输入命令, 按一下回车键 (键盘上的 Enter 键), 程序会接收到命令并输出结果
cli交互模式下, 运行命令 help
cli交互模式下, 运行命令 login -h (注意空格) 查看帮助
cli交互模式下, 运行命令 login 程序将会提示你输入百度用户名(手机号/邮箱/用户名)和密码, 必要时还可以在线验证绑定的手机号或邮箱
cli交互模式下, 运行命令 cd /我的资源 将工作目录切换为 /我的资源 (前提: 该目录存在于网盘)
目录支持通配符匹配, 所以你也可以这样: 运行命令 cd /我的* 或 cd /我的?? 将工作目录切换为 /我的资源, 简化输入.
将工作目录切换为 /我的资源 成功后, 运行命令 cd .. 切换上级目录, 即将工作目录切换为 /
为什么要这样设计呢, 举个例子,
假设 你要下载 /我的资源 内名为 1.mp4 和 2.mp4 两个文件, 而未切换工作目录, 你需要依次运行以下命令:
d /我的资源/1.mp4
d /我的资源/2.mp4
而切换网盘工作目录之后, 依次运行以下命令:
cd /我的资源
d 1.mp4
d 2.mp4
这样就达到了简化输入的目的
cli交互模式下, 运行命令 ls -h (注意空格) 查看帮助
cli交互模式下, 运行命令 ls 来列出当前所在目录的文件和目录
cli交互模式下, 运行命令 ls /我的资源 来列出 /我的资源 内的文件和目录
cli交互模式下, 运行命令 ls .. 来列出当前所在目录的上级目录的文件和目录
说明: 下载的文件默认保存到 download/ 目录 (文件夹)
cli交互模式下, 运行命令 d -h (注意空格) 查看帮助
cli交互模式下, 运行命令 d /我的资源/1.mp4 来下载位于 /我的资源/1.mp4 的文件 1.mp4 , 该操作等效于运行以下命令:
cd /我的资源
d 1.mp4
现在已经支持目录 (文件夹) 下载, 所以, 运行以下命令, 会下载 /我的资源 内的所有文件 (违规文件除外):
d /我的资源
cli交互模式下, 运行命令 config set -h (注意空格) 查看设置帮助以及可供设置的值
cli交互模式下, 运行命令 config set -max_parallel 2 将下载最大并发量设置为 2
注意：普通用户下载最大并发量的值超过1将导致账号被限速; SVIP同样不宜设置过高, 建议10~20
cli交互模式下, 运行命令 config reset
运行命令 quit 或 exit 或 组合键 Ctrl+C 或 组合键 Ctrl+D
提交Issue: Issues