bypy使用指南 | 如何在linux服务器上下载百度云/百度网盘文件？（超级详细版）
以下是根据 BaiduPCS-Py（bypy） 项目提供的中文详细使用指南：
bypy 介绍
bypy 是一个用于操作百度云的命令行工具，支持文件上传、下载、同步等操作。它是用 Python 编写的，使用百度开放的 PCS（云存储服务）API。
安装
1. 系统要求
- Python 3.6 及以上版本
- pip 包管理工具
2. 安装步骤
方法一：通过 pip 安装
- 执行以下命令安装：
pip install bypy- 检查安装是否成功：
bypy --help方法二：从源码安装
- 克隆源码：
git clone https://github.com/houtianze/bypy.git
cd bypy- 安装：
python setup.py install首次使用 - 授权配置
- 首次运行时，需进行百度云的 OAuth2 授权：
bypy info运行后，命令行会输出一个 URL。
- 打开 URL，在浏览器中登录百度账号，授予权限后，将生成的授权码复制到命令行中。
- 配置完成后，
bypy会将授权信息保存在本地，通常位于~/.bypy/目录中。
常用命令
1. 查看帮助
- 显示所有支持的命令：
bypy --help- 查看具体命令的用法：
bypy <命令> --help2. 文件上传
上传文件到百度云
- 上传单个文件：
bypy upload <本地文件路径> [远程目标路径]示例：
bypy upload example.txt /apps/bypy-folder/- 上传整个文件夹：
bypy upload <本地文件夹> [远程目标路径]示例：
bypy upload ./local-folder /apps/bypy-folder/3. 文件下载
下载文件到本地
- 下载单个文件：
bypy download <远程文件路径> [本地保存路径]示例：
bypy download /apps/bypy-folder/example.txt ./downloads/- 下载整个文件夹：
bypy download <远程文件夹路径> [本地保存路径]示例：
bypy download /apps/bypy-folder ./downloads/4. 文件同步
本地与百度云文件同步
- 单向同步（本地 → 百度云）：
bypy syncup [远程目标路径]示例：
bypy syncup /apps/bypy-folder/- 单向同步（百度云 → 本地）：
bypy syncdown [本地目标路径]示例：
bypy syncdown ./downloads/- 双向同步（本地 ↔ 百度云）：
bypy sync [本地路径] [远程路径]示例：
bypy sync ./local-folder /apps/bypy-folder/5. 删除文件或文件夹
删除远程文件或文件夹
- 删除单个文件：
bypy delete <远程文件路径>示例：
bypy delete /apps/bypy-folder/example.txt- 删除整个文件夹：
bypy delete <远程文件夹路径>示例：
bypy delete /apps/bypy-folder/6. 查看文件信息和列表
查看文件或文件夹信息
- 查看指定文件信息：
bypy info <远程文件路径>示例：
bypy info /apps/bypy-folder/example.txt- 查看文件夹信息：
bypy info <远程文件夹路径>示例：
bypy info /apps/bypy-folder/列出文件夹内容
- 列出远程文件夹内容：
bypy list [远程文件夹路径]示例：
bypy list /apps/bypy-folder/7. 配额与校验
检查网盘配额
- 查看总空间与已使用空间：
bypy quota校验文件完整性
- 校验本地与百度云文件的一致性（MD5 校验）：
bypy compare <本地路径> <远程路径>示例：
bypy compare ./local-folder /apps/bypy-folder/8. 其他命令
显示当前配置
bypy info清除本地缓存
清理 bypy 本地缓存文件，避免因缓存问题导致错误：
bypy cleancache获取远程文件的下载链接
获取远程文件的公开下载链接：
bypy downtolink <远程文件路径>示例：
bypy downtolink /apps/bypy-folder/example.txt使用建议
- 备份重要文件：在执行删除、同步等操作前，确保本地或远程文件已备份。
- 定期校验文件完整性：使用
compare命令定期检查文件一致性。 - 控制同步频率：避免过于频繁地上传/下载大量文件，可能导致 API 请求速率限制。
- 使用日志功能：可以将输出保存到日志文件，方便排查问题。
常见问题
1. 如何解决授权失败？
- 确保复制的授权码正确无误。
- 如果已过期，重新运行授权命令
bypy info。
2. 如何提升上传/下载速度？
- 避免高峰时段操作。
- 使用稳定的网络连接，建议在宽带网络环境下操作。
3. 如何排查报错信息？
- 查看命令行输出的错误日志。
- 使用
--verbose参数获取更详细的调试信息：
bypy <命令> --verbose4. 如何重置配置？
- 删除本地授权配置文件：
rm -rf ~/.bypy/- 重新执行授权流程。
通过以上指南，您可以熟练掌握 bypy 的使用，并高效管理百度云中的文件。如果遇到其他问题，请查阅 bypy 官方文档 或提交 Issue 反馈。