qBittorrent-ClientBlocker

qBittorrent-ClientBlocker

中文 English

一款适用于 qBittorrent 的客户端屏蔽器, 默认屏蔽包括但不限于迅雷等客户端, 支持 qBittorrent 4.1 及以上版本.

• 全平台支持
• 支持记录日志及热重载配置
• 支持忽略私有 IP 地址
• 支持自定义屏蔽列表 (不区分大小写, 支持正则表达式)
• 支持客户端认证
• 支持增强自动屏蔽 (默认禁用): 根据默认或设定的相关参数自动屏蔽 Peer
• 在 Windows 下支持通过 CTRL+ALT+B 窗口热键显示及隐藏窗口 (部分用户反馈其可能会影响屏蔽, 由于原因不明, 若遇到相关问题可避免使用该功能)

使用 Usage

前提

• 必须启用 qBittorrent Web UI 功能.

常规版本使用

1. 从 GitHub Release 下载压缩包并解压;

   查看 常见平台下载版本 对照表

   操作系统	处理器架构	处理器位数	下载版本	说明
   macOS	ARM64	64 位	darwin-arm64	常见于 Apple M 系列
   macOS	AMD64	64 位	darwin-amd64	常见于 Intel 系列
   Windows	AMD64	64 位	windows-amd64	常见于大部分现代 PC
   Windows	i386	32 位	windows-386	少见于部分老式 PC
   Windows	ARM64	64 位	windows-arm64	常见于新型平台, 应用于部分平板/笔记本/少数特殊硬件
   Windows	ARMv6	32 位	windows-arm	少见于罕见平台, 应用于部分上古硬件, 如 Surface RT 等
   Linux	AMD64	64 位	linux-amd64	常见于大部分 NAS 及服务器
   Linux	i386	32 位	linux-386	少见于部分老式 NAS 及服务器
   Linux	ARM64	64 位	linux-arm64	常见于部分服务器及开发板, 如 Oracle 或 Raspberry Pi 等
   Linux	ARMv6	32 位	linux-arm	少见于部分老式服务器及开发板

   其它版本的 Linux/NetBSD/FreeBSD/OpenBSD/Solaris 可以此类推, 并在列表中选择适合自己的.

2. 解压后, 可能需要修改随附的配置文件 config.json;

   • 可根据高级需求, 按需设置配置, 具体见 配置 Config.
   • 若客户端屏蔽器运行于本机, 但未启用 qBittorrent "跳过本机客户端认证" (及密码不为空且并未手动设置密码), 则必须修改配置文件, 并填写 qBPassword.
   • 若客户端屏蔽器不运行于本机 或 qBittorrent 未安装在默认路径 或 使用 2.4 及以下版本的客户端屏蔽器, 则必须修改配置文件, 并填写 qBURL/qBUsername/qBPassword.

3. 启动客户端屏蔽器, 并观察信息输出是否正常即可;

   对于 Windows, 可选修改 qBittorrent 的快捷方式, 放入自己的屏蔽器路径, 使 qBittorrent 与屏蔽器同时运行;

   C:\Windows\System32\cmd.exe /c "(tasklist | findstr qBittorrent-ClientBlocker || start C:\Users\Example\qBittorrent-ClientBlocker\qBittorrent-ClientBlocker.exe) && start     qbittorrent.exe"
   

   对于 macOS, 可选使用一基本 LaunchAgent 用户代理 用于开机自启及后台运行;

   对于 Linux, 可选使用一基本 Systemd 服务配置文件 用于开机自启及后台运行;

Docker 版本使用

• 从 Docker Hub 拉取 Docker 镜像.

  docker pull simpletracker/qbittorrent-clientblocker:latest
  

• 配置方法一: 使用 配置文件映射

  1. 在合适位置新建 config.json 作为配置文件, 具体内容可参考 config.json 及 配置 Config;

  2. 填入 qBURL/qBUsername/qBPassword;

     • 可根据高级需求, 按需设置其它配置, 具体见 配置 Config.
     • 若启用 qBittorrent 的 "IP 子网白名单", 则可不填写 qBUsername 和 qBPassword.

  3. 替换 /path/config.json 为你的配置文件路径;

  4. 运行 Docker 并查看日志, 观察信息输出是否正常即可;

     以下命令模版仅作为参考.

     docker run -d \
         --name=qbittorrent-clientblocker --network=bridge --restart unless-stopped \
         -v /path/config.json:/app/config.json \
         simpletracker/qbittorrent-clientblocker:latest
     

• 配置方法二: 使用 环境变量

  • 使用前提: 设置 useENV 环境变量为 true.

  • 使用环境变量按需配置设置, 具体见 配置 Config.

  • 若设置较复杂, 则可能出现 blockList 不生效的情况. 因此, 若需要配置此设置, 则使用环境变量是不推荐的.

  • 以下命令模版仅作为参考.

    docker run -d \
        --name=qbittorrent-clientblocker --network=bridge --restart unless-stopped \
        -e debug=false \
        -e logPath=logs \
        -e blockList='["ExampleBlockList1", "ExampleBlockList2"]' \
        -e qBURL=http://example.com \
        -e qBUsername=exampleUser \
        -e qBPassword=examplePass \
        simpletracker/qbittorrent-clientblocker:latest
    

参数 Flag

配置 Config

Docker 版本通过相同名称的环境变量配置, 通过自动转换环境变量为配置文件实现.

反馈 Feedback

用户及开发者可以通过 Issue 反馈 bug, 通过 Discussion 提问/讨论/分享 使用方法, 通过 Pull Request 向客户端屏蔽器贡献代码改进.
注意: 为 Feature 发起 Pull Request 时, 请不要同步创建 Issue.

致谢 Credit

1. 我们在客户端屏蔽器的早期开发过程中部分参考了 jinliming2/qbittorrent-ban-xunlei;
2. 我们会在每期版本的 Release Note 中感谢当期通过 Pull Request 向客户端屏蔽器贡献代码改进的用户及开发者;