如何快速上手qBit Manage？5分钟搭建你的BT任务自动化工具
项目地址: https://gitcode.com/gh_mirrors/qb/qbit_manage qBit Manage是一款功能强大的BT任务自动化工具，能够帮助用户轻松管理qBittorrent中的繁琐任务，实现标签管理、分类整理、删除孤立数据、移除未注册种子等多种自动化操作，让你的BT下载体验更加高效便捷。
快速了解qBit Manage核心功能
qBit Manage作为一款优秀的BT任务自动化工具，为用户提供了丰富的功能，主要包括以下几个方面：
- 标签与分类管理：能够根据种子的不同属性自动为其添加标签和分类，让你的种子库更加有序。
- 孤立数据清理：可以智能识别并移除那些没有对应种子的孤立文件，释放磁盘空间。
- 未注册种子处理：自动检测并处理未注册的种子，保持种子库的健康状态。
- 共享限制管理：灵活设置种子的共享比率、播种时间等限制，优化你的上传和下载策略。
超简单安装步骤，5分钟搞定
1. 下载qBit Manage
你可以通过克隆仓库的方式获取qBit Manage，在终端中输入以下命令：
git clone https://gitcode.com/gh_mirrors/qb/qbit_manage
2. 选择合适的安装方式
qBit Manage提供了多种安装方式，你可以根据自己的需求选择：
- 桌面应用（推荐大多数用户）：Windows用户下载并运行
.exe安装程序，macOS用户下载并安装.dmg包，Linux用户下载并安装.deb包。桌面应用提供图形界面，会自动处理配置文件设置。 - 独立二进制文件（命令行）：适用于服务器环境、自动化场景或喜欢命令行工具的用户。根据你的操作系统选择相应的二进制文件，如Windows的
qbit-manage-windows-amd64.exe，macOS的qbit-manage-macos-arm64（Apple Silicon）或qbit-manage-macos-x86_64（Intel），Linux的qbit-manage-linux-amd64。 - Docker容器：支持多架构（amd64、arm64、arm/v7），非常适合容器化环境和NAS系统。
- Python安装：适合开发者或想要修改代码的用户，可以从源码或PyPI安装。
这里以独立二进制文件安装为例，下载对应文件后，在终端中进入文件所在目录，执行以下命令使其可执行（以Linux为例）：
chmod +x qbit-manage-linux-amd64
然后可以将其移动到系统PATH目录下，方便随时调用：
sudo mv qbit-manage-linux-amd64 /usr/local/bin/qbit-manage
轻松配置，开启自动化之旅
1. 找到配置文件位置
qBit Manage会在不同平台的特定位置查找配置文件：
- Windows：
%APPDATA%\qbit-manage\config.yml（通常是C:\Users\<username>\AppData\Roaming\qbit-manage\config.yml） - macOS：
~/Library/Application Support/qbit-manage/config.yml - Linux/Unix：
~/.config/qbit-manage/config.yml（如果设置了XDG_CONFIG_HOME，则为$XDG_CONFIG_HOME/qbit-manage/config.yml） - Docker安装：容器内路径为
/config/config.yml
你也可以使用--config-dir或-cd命令行选项指定自定义目录来覆盖默认位置。
2. 配置关键参数
配置文件中有一些关键参数需要设置，以确保qBit Manage能够正常工作：
- qbt部分：定义你的qBittorrent实例信息，包括
host（qB安装的IP地址，必填）、user（qB的webUI用户名，选填）、pass（qB的webUI密码，选填）。 - directory部分：定义qBit Manage用于各种操作的目录，如
root_dir（根下载目录，用于检查孤立文件等，当使用某些功能时必填）、recycle_bin（回收站文件夹路径，选填）等。
你可以参考仓库中的模板配置文件config/config.yml.sample来进行设置。
运行qBit Manage，体验自动化管理
完成安装和配置后，就可以运行qBit Manage了。在终端中输入以下命令查看帮助和可用选项：
qbit-manage --help
你可以根据需要执行不同的命令，例如：
- 运行一次（不使用调度器）：
qbit-manage --run - 运行并启用Web UI（桌面版默认启用）：
qbit-manage --web-server
探索更多高级功能
qBit Manage还有许多强大的高级功能等待你去探索，例如：
- share_limits：可以根据分组的优先级控制种子的共享限制，设置最大比率、播种时间限制、上传速度限制等。
- webhooks：能够基于事件触发器提供webhook通知，让你及时了解工具的运行状态。
你可以查看官方文档docs/Commands.md和docs/Web-API.md来了解更多详细信息。
通过以上简单的步骤，你就可以快速上手qBit Manage，让它为你自动管理BT任务，节省时间和精力，享受更高效的下载体验！ 🚀
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
