☰
百度网盘命令行 BaiduPCS-Go 使用指南:从登录到批量转存的完整流程
2026/9/28 2:31:35 网站建设 项目流程

百度网盘命令行 BaiduPCS-Go 使用指南:从登录到批量转存的完整流程

【免费下载链接】BaiduPCS-Goiikira/BaiduPCS-Go原版基础上集成了分享链接/秒传链接转存功能项目地址: https://gitcode.com/GitHub_Trending/ba/BaiduPCS-Go

网盘文件动辄成百上千,用官方客户端一个个点选很容易让人抓狂。BaiduPCS-Go 是一个开源的百度网盘命令行工具,把登录、文件管理、批量下载上传、分享转存都搬进终端,让你用几行指令完成过去需要大量点击的操作,也方便写进自动化脚本。它在 iikira 原版基础上扩展了分享链接转存能力,支持 Windows、macOS、Linux 等多平台。

为什么选命令行管理百度网盘

图形客户端适合偶尔点几下,可一旦要处理几百个文件,或想把网盘操作排进定时任务,逐层点击就显得笨重了。命令行把每一步都变成可复制、可拼接、可放进脚本的文本指令,批量与自动化场景下效率差距很明显,出错后也容易复现和排查。

五分钟完成安装与登录

先拿到程序。两种途径都可以:一是直接下载预编译的二进制文件,解压后就能跑,省去编译环节;二是从源码自行编译,适合想要最新特性或自定义的情况。

# 克隆仓库 git clone https://gitcode.com/GitHub_Trending/ba/BaiduPCS-Go # 进入目录后编译 cd BaiduPCS-Go go build

拿到可执行文件后,登录是第一步,这里有三种方式。最省事的是用浏览器里复制出来的 Cookies:

# 推荐:用浏览器复制的 Cookies 登录 BaiduPCS-Go login -cookies="你的Cookies" # 备选:用 BDUSS 和 STOKEN BaiduPCS-Go login -bduss=你的BDUSS -stoken=你的STOKEN # 传统方式:用户名密码登录 BaiduPCS-Go login

登录成功后可用who看当前账号、loglist列出所有已登录账号、su在不同账号间切换。多个账号并存时,先想清楚当前操作落在哪个账号上。

日常文件管理:查看、创建、删除与搜索

文件操作沿用了类似 Linux shell 的习惯,看目录、换目录、建目录、删文件,一条命令就能落地:

# 列出某个目录的内容 BaiduPCS-Go ls /我的资源 # 切换工作目录 / 查看当前所在目录 BaiduPCS-Go cd /视频 BaiduPCS-Go pwd

整理网盘时,建目录和删文件同样直接。删完会进回收站,后面还能找回:

# 创建新目录 BaiduPCS-Go mkdir 新文件夹 # 删除指定文件 BaiduPCS-Go rm /我的资源/旧文件.mp4

想从一堆文件里定位目标,用搜索比翻目录快得多。可以只搜当前目录,也可以指定目录递归搜索:

# 当前目录内按关键字搜索 BaiduPCS-Go search 关键字 # 在根目录递归搜索 BaiduPCS-Go search -path=/ -r 文档

大文件与批量传输:并行下载与上传策略

下载是百度网盘命令行用得最多的场景。整目录拉取、单文件下载都支持,断点续传意味着中途断了再执行一次同一命令即可续传,不必从头开始。给单文件加-p可以提升并行度:

# 下载整个目录 BaiduPCS-Go d /我的资源 # 单文件多线程下载,-p 指定并行数 BaiduPCS-Go d /大文件.zip -p 8 # 只测试连接与任务,不落盘 BaiduPCS-Go d /测试文件.zip --test

命令的并行与断点续传逻辑实现见 baidupcs/download.go。

上传侧支持命令行上传网盘,单文件和整目录都行,单文件上限 128GB:

# 上传单个文件到网盘目录 BaiduPCS-Go upload /本地/文件.mp4 /网盘目录 # 上传整个目录 BaiduPCS-Go u /本地目录 /网盘目标目录

遇到同名文件时,可以用--policy指定三种策略:skip跳过同名(默认)、overwrite覆盖同名、rsync只覆盖大小不同的同名文件。增量同步场景用rsync最省心:

# 用 rsync 策略上传,只覆盖大小不同的同名文件 BaiduPCS-Go upload /本地目录 /网盘目录 --policy=rsync

上传策略与秒传逻辑在 baidupcs/upload.go。

如何在终端转存百度网盘分享链接并管理分享

拿到别人的分享链接后,直接转存到自己网盘。不带提取码和带提取码两种写法都支持,带密码的链接把密码拼在参数里:

# 转存分享链接并附带提取码 BaiduPCS-Go transfer https://pan.baidu.com/s/分享链接 提取码 # 转存带密码的链接 BaiduPCS-Go transfer "https://pan.baidu.com/s/链接?pwd=密码"

反过来,把自己的文件分享出去、查看已有哪些分享、或撤销某个分享,也都能用一条share子命令完成:

# 创建分享 BaiduPCS-Go share set /我的资源/分享文件.mp4 # 查看分享列表 BaiduPCS-Go share list # 按分享 ID 取消分享 BaiduPCS-Go share cancel 分享ID

分享链接转存的核心逻辑见 baidupcs/transfer.go。

进阶调优:线程配置、离线下载与回收站

线程数是最常调的一项。普通用户把并行数设回 1 往往更稳,SVIP 才适合调高;配置修改后会写回本地,不必每次手动指定:

# 设置下载线程数(普通用户建议 1) BaiduPCS-Go config set -max_parallel 1 # SVIP 可适当调高 BaiduPCS-Go config set -max_parallel 15

配置项的读写逻辑集中在 internal/pcsconfig/pcsconfig.go。

除了网盘内的下载,还能把外链、磁力链交给百度网盘做离线下载,省掉本机挂下载的麻烦:

# 添加 http/https 离线下载任务 BaiduPCS-Go offlinedl add -path=/ http://example.com/file.zip # 添加磁力链离线下载 BaiduPCS-Go offlinedl add magnet:?xt=urn:btih:磁力链哈希

误删的文件别急着慌,先在回收站里找回来:

# 查看回收站文件 BaiduPCS-Go recycle list # 按文件 ID 恢复 BaiduPCS-Go recycle restore 文件ID # 清空回收站 BaiduPCS-Go recycle delete -all

另外,直接运行程序而不带任何参数就进入交互式模式,支持 Tab 补全命令和路径,反复操作时比每次敲全参数省心得多。项目内部的模块划分与代码结构,感兴趣可直接看 docs/ 目录下的说明。

常见问题:登录、下载与上传排错

登录失败怎么办?优先换 Cookies 方式登录,从浏览器登录网盘后复制完整 Cookies;同时确认账号状态正常、网络可达。

下载速度慢?普通用户把并行数设为 1 反而更稳定;SVIP 可适当调高并行数。别在普通账号上盲目堆线程。

上传失败?试试--norapid跳过秒传检测;确认单文件不超过 128GB 上限;再检查网络连接是否稳定。

转存提示与 STOKEN 相关?用login时把 BDUSS 和 STOKEN 一并带上,或在登录态正常的情况下重试转存。

从登录、日常文件管理,到批量下载上传、分享链接转存,BaiduPCS-Go 把网盘操作都收进了终端,批量与自动化场景尤其顺手。上面只覆盖了最常用的路径,完整的命令列表、参数细节和离线下载子命令都在 docs/ 里,动手前花几分钟过一遍,能少走很多弯路。

【免费下载链接】BaiduPCS-Goiikira/BaiduPCS-Go原版基础上集成了分享链接/秒传链接转存功能项目地址: https://gitcode.com/GitHub_Trending/ba/BaiduPCS-Go

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询