Docker环境下部署qBittorrent-ClientBlocker的快速教程

Docker环境下部署qBittorrent-ClientBlocker的快速教程

【免费下载链接】qBittorrent-ClientBlocker一款适用于 qBittorrent 的客户端屏蔽器, 默认屏蔽包括但不限于迅雷等客户端.项目地址: https://gitcode.com/gh_mirrors/qb/qBittorrent-ClientBlocker

qBittorrent-ClientBlocker是一款适用于qBittorrent的客户端屏蔽器，默认屏蔽包括但不限于迅雷等客户端。本教程将带你快速掌握在Docker环境下部署该工具的方法，轻松实现客户端屏蔽功能。

准备工作

在开始部署前，请确保你的系统已安装Docker和Docker Compose。如果尚未安装，可以参考Docker官方文档进行安装。

克隆项目仓库

首先，克隆qBittorrent-ClientBlocker项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/qb/qBittorrent-ClientBlocker cd qBittorrent-ClientBlocker

配置文件修改

项目提供了两种配置文件格式：config.toml和config.json，你可以根据自己的喜好选择其中一种进行配置。

config.toml配置

打开config.toml文件，你可以看到以下主要配置项：

[qbittorrent] Host = "localhost" Port = 8080 Username = "admin" Password = "adminadmin" [blocker] Interval = 2 CheckPort = 26000 BanTime = 86400 BanPortTorrent = true StartDelay = 0

根据你的qBittorrent实际情况，修改Host、Port、Username和Password等参数。

config.json配置

如果你更喜欢JSON格式，可以编辑config.json文件：

{ "qbittorrent": { "Host": "localhost", "Port": 8080, "Username": "admin", "Password": "adminadmin" }, "blocker": { "Interval": 2, "CheckPort": 26000, "BanTime": 86400, "BanPortTorrent": true, "StartDelay": 0 } }

构建Docker镜像

在项目根目录下，执行以下命令构建Docker镜像：

docker build -t qbittorrent-clientblocker .

运行Docker容器

构建完成后，使用以下命令运行Docker容器：

docker run -d --name qb-clientblocker \ -v $(pwd)/config.toml:/app/config.toml \ -v $(pwd)/blockList.json:/app/blockList.json \ --network host \ qbittorrent-clientblocker

注意：这里使用了--network host模式，确保容器能够访问到本地的qBittorrent服务。如果你需要使用端口映射，可以将--network host替换为-p参数，例如-p 26000:26000。

验证部署结果

容器启动后，你可以通过查看日志来验证部署是否成功：

docker logs -f qb-clientblocker

如果一切正常，你将看到类似以下的日志输出：

日志中会显示客户端屏蔽器的运行状态，包括当前屏蔽的客户端数量和IP地址等信息。

常见问题解决

无法连接到qBittorrent

如果日志中出现无法连接到qBittorrent的错误，请检查以下几点：

1. qBittorrent是否已启动并正常运行
2. config.toml或config.json中的Host、Port、Username和Password是否正确
3. Docker容器是否能够访问到qBittorrent服务（特别是使用--network host模式时）

屏蔽规则不生效

如果发现屏蔽规则不生效，可以检查blockList.json文件是否正确配置。该文件定义了需要屏蔽的客户端规则，你可以根据需要进行修改。

总结

通过本教程，你已经学会了如何在Docker环境下快速部署qBittorrent-ClientBlocker。该工具能够帮助你有效屏蔽不需要的客户端，提升qBittorrent的使用体验。如果你在使用过程中遇到任何问题，可以参考项目中的doc/SyncServer.md文档，或者查看项目源码进行深入了解。

希望本教程对你有所帮助，祝你使用愉快！ 🚀

【免费下载链接】qBittorrent-ClientBlocker一款适用于 qBittorrent 的客户端屏蔽器, 默认屏蔽包括但不限于迅雷等客户端.项目地址: https://gitcode.com/gh_mirrors/qb/qBittorrent-ClientBlocker