开源软件名称:felixonmars/BaiduPCS-Go
开源软件地址:https://github.com/felixonmars/BaiduPCS-Go
开源编程语言:
Go
98.6%
开源软件介绍:BaiduPCS-Go 百度网盘客户端
仿 Linux shell 文件处理命令的百度网盘命令行客户端.
This project was largely inspired by GangZhuo/BaiduPCS
注意
此文档只针对于最新的commit, 可能不适用于已发布的最新版本.
目录
特色
多平台支持, 支持 Windows, macOS, linux, 移动设备等.
百度帐号多用户支持;
通配符匹配网盘路径和 Tab 自动补齐命令和路径, 通配符_百度百科;
下载网盘内文件, 支持多个文件或目录下载, 支持断点续传和单文件并行下载;
上传本地文件, 支持上传大文件(>2GB), 支持多个文件或目录上传;
离线下载, 支持http/https/ftp/电驴/磁力链协议.
编译/交叉编译 说明
参见 编译/交叉编译帮助
下载/运行 说明
Go语言程序, 可直接在发布页下载使用.
可在这里下载最新commit对应的测试版: https://ci.appveyor.com/project/iikira/baidupcs-go/build/artifacts
如果程序运行时输出乱码, 请检查下终端的编码方式是否为 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 移动设备操作比较麻烦, 不建议在移动设备上使用本程序.
安卓, 建议使用 Termux 或 NeoTerm 或 终端模拟器, 以提供终端环境.
示例: Android 运行本项目程序参考示例, 有兴趣的可以参考一下.
苹果iOS, 需要越狱, 在 Cydia 搜索下载并安装 MobileTerminal, 或者其他提供终端环境的软件.
示例: iOS 运行本项目程序参考示例, 有兴趣的可以参考一下.
具体使用方法请参见 命令列表及说明 和 初级使用教程.
命令列表及说明
注意 ! ! !
命令的前缀 BaiduPCS-Go 为指向程序运行的全路径名 (ARGv 的第一个参数)
直接运行程序时, 未带任何其他参数, 则程序进入cli交互模式, 运行以下命令时, 要把命令的前缀 BaiduPCS-Go 去掉!
cli交互模式已支持按tab键自动补全命令和路径.
检测程序更新
登录百度帐号
常规登录百度帐号
支持在线验证绑定的手机号或邮箱,
使用百度 BDUSS 来登录百度帐号
关于 获取百度 BDUSS
BaiduPCS-Go login -bduss=<BDUSS>
例子
BaiduPCS-Go login -bduss=1234567
BaiduPCS-Go login
请输入百度用户名(手机号/邮箱/用户名), 回车键提交 > 1234567
列出帐号列表
列出所有已登录的百度帐号
获取当前帐号
切换百度帐号
切换已登录的百度帐号
BaiduPCS-Go su
请输入要切换帐号的 # 值 >
退出百度帐号
退出当前登录的百度帐号
程序会进一步确认退出帐号, 防止误操作.
获取网盘配额
获取网盘的总储存空间, 和已使用的储存空间
切换工作目录
切换工作目录后自动列出工作目录下的文件和目录
例子
# 切换 /我的资源 工作目录
BaiduPCS-Go cd /我的资源
# 切换 上级目录
BaiduPCS-Go cd ..
# 切换 根目录
BaiduPCS-Go cd /
# 切换 /我的资源 工作目录, 并自动列出 /我的资源 下的文件和目录
BaiduPCS-Go cd -l 我的资源
# 使用通配符
BaiduPCS-Go cd /我的*
输出工作目录
列出目录
列出当前工作目录的文件和目录或指定目录
可选参数
-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> , 自定义保存的目录.
支持多个文件或目录下载.
支持下载完成后自动校验文件, 但并不是所有的文件都支持校验!
自动跳过下载重名的文件!
关于下载的简单说明
下载模式说明
-
pcs: 通过百度网盘的 PCS API 下载
-
stream: 通过百度网盘的 PCS API, 以流式文件的方式下载, 效果同 pcs
-
locate: 默认的下载模式。从百度网盘 Android 客户端, 获取下载链接的方式来下载
例子
# 设置保存目录, 保存到 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> ... <目标目录>
-
上传默认采用分片上传的方式, 上传的文件将会保存到, <目标目录>.
-
遇到同名文件将会自动覆盖!!
-
当上传的文件名和网盘的目录名称相同时, 不会覆盖目录, 防止丢失数据.
注意:
- 分片上传之后, 服务器可能会记录到错误的文件md5, 可使用 fixmd5 命令尝试修复文件的MD5值, 修复md5不一定能成功, 但文件的完整性是没问题的.
fixmd5 命令使用方法:
例子:
# 将本地的 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 rapidupload -length=<文件的大小> -md5=<文件的md5值> -slicemd5=<文件前256KB切片的md5值(可选)> -crc32=<文件的crc32值(可选)> <保存的网盘路径, 需包含文件名>
BaiduPCS-Go ru -length=<文件的大小> -md5=<文件的md5值> -slicemd5=<文件前256KB切片的md5值(可选)> -crc32=<文件的crc32值(可选)> <保存的网盘路径, 需包含文件名>
注意: 使用此功能秒传文件, 前提是知道文件的大小, md5, 前256KB切片的 md5 (可选), crc32 (可选), 且百度网盘中存在一模一样的文件.
上传的文件将会保存到网盘的目标目录.
遇到同名文件将会自动覆盖!
可能无法秒传 20GB 以上的文件!!
例子:
# 如果秒传成功, 则保存到网盘路径 /test
BaiduPCS-Go rapidupload -length=56276137 -md5=fbe082d80e90f90f0fb1f94adbbcfa7f -slicemd5=38c6a75b0ec4499271d4ea38a667ab61 -crc32=314332359 /test
修复文件MD5
BaiduPCS-Go fixmd5 <文件1> <文件2> <文件3> ...
尝试修复文件的MD5值, 以便于校验文件的完整性和导出文件.
使用分片上传文件, 当文件分片数大于1时, 百度网盘服务端最终计算所得的md5值和本地的不一致, 这可能是百度网盘的bug.
不过把上传的文件下载到本地后,对比md5值是匹配的, 也就是文件在传输中没有发生损坏.
对于MD5值可能有误的文件, 程序会在获取文件的元信息时, 给出MD5值 "可能不正确" 的提示, 表示此文件可以尝试进行MD5值修复.
修复文件MD5不一定能成功, 原因可能是服务器未刷新, 可过几天后再尝试.
修复文件MD5的原理为秒传文件, 即修复文件MD5成功后, 文件的创建日期, 修改日期, fs_id, 版本历史等信息将会被覆盖, 修复的MD5值将覆盖原先的MD5值, 但不影响文件的完整性.
注意: 无法修复 20GB 以上文件的 md5!!
例子:
# 修复 /我的资源/1.mp4 的 MD5 值
BaiduPCS-Go fixmd5 /我的资源/1.mp4
获取本地文件的秒传信息
BaiduPCS-Go sumfile <本地文件的路径>
BaiduPCS-Go sf <本地文件的路径>
获取本地文件的大小, md5, 前256KB切片的 md5, crc32, 可用于秒传文件.
例子:
# 获取 C:\Users\Administrator\Desktop\1.mp4 的秒传信息
BaiduPCS-Go sumfile C:/Users/Administrator/Desktop/1.mp4
|