一直跟你索取数据，你有求必应地给它了，等你跟它请求的时候，不好意思，没有，不信你看我进度，我可是 0% 啊！——这就是吸血。
然而 BT 协议非常宽松，大多数开源客户端并不屏蔽吸血客户端，有些客户端如
qBittorrent-Enhanced-Edition，可以通过
Peer/Client ID 识别它们并屏蔽。
个人使用的 Transmission 就只能屏蔽 IP，而且作者表示不会加入屏蔽客户端这种功能1。
于是我写了个 Shell 脚本
qianbinbin/transmission-block，可以按客户端屏蔽其
IP，还支持在线黑名单。
近年来出现了 PeerBanHelper 反吸血项目，支持包括
Transmission 在内的很多客户端。然而它太过重量级，而 Transmission 正是以资源占用少著称。
项目创建于 2022 年，2025 年进行了重大更新。
以下是全新的
README，具体请移步我的仓库安装脚本。
Transmission 辅助脚本，屏蔽迅雷等吸血客户端以及在线屏蔽列表（黑名单）中的 IP 地址。
特性：
支持屏蔽指定客户端（已预设，详见配置文件中的 LEECHER_CLIENTS）。支持抓取多个指定在线黑名单，支持文本、gzip、zip 格式（详见配置文件中的 EXTERNAL_BL）。完全端到端访问，理论支持容器中的 Transmission，甚至可以运行在另一主机。支持受限用户运行。理论兼容 POSIX Shell 环境。同步转换 BTN-Collected-Rules 为
Transmission 兼容的黑名单（详见
blocklist
分支）。依赖：
transmission-remote 命令，通常已经与 Transmission 一起安装。隔离安装（如某些 NAS 系统）的
transmission-remote 可能需要设置 PATH，详见配置文件。curl、file 命令（如果使用在线黑名单）。HTTP 服务程序，nginx、busybox httpd、python3 任意一种（排序分先后）。前两者资源占用极低，后两者普遍预装。systemd 235 或以上版本（如果使用 systemd
管理）。要在更低版本上使用，参考问题排查。使用删除旧版 trans-block.sh 脚本（可选）以 root 权限运行：
rm /path/to/trans-block.sh # 旧脚本保存路径
systemctl disable transmission-block.service
systemctl stop transmission-block.service
rm /etc/systemd/system/transmission-block.service
systemctl daemon-reload
删除配置目录下的旧黑名单：
rm -i /path/to/config/blocklists/leechers.txt*
如果不知道配置目录，可以使用以下命令获取（替换自己的用户名和密码）：
transmission-remote --auth username:password --session-info | sed -n -E 's/.*Configuration directory: (.*)/\1/p'
设置 Transmission启用远程访问；设置用户名和密码（可选）。启用黑名单，并设置为 http://127.0.0.1:9098/blocklist.p2p.gz。以 transmission-daemon
为例，在配置文件中：
{
"rpc-enabled": true, <--- 启用远程访问
"rpc-authentication-required": true, <--- 启用用户验证
"rpc-username": "username", <--- 用户名
"rpc-password": "password", <--- 密码
"blocklist-enabled": true, <--- 启用黑名单
"blocklist-url": "http://127.0.0.1:9098/blocklist.p2p.gz" <--- 黑名单地址
}
[!NOTE]
修改密码建议在 daemon 关闭状态下，因为密码会在启动后加盐哈希。
如不使用默认 HTTP 监听地址（见配置文件中的 BL_SERVER），则 "blocklist-url" 要相应修改。
如果 daemon 正在运行，使用 systemctl reload transmission-daemon.service
重新加载配置，直接重启不会生效。
自动运行（systemd）下载脚本及配置文件，以 root 权限运行：
mkdir -p /usr/local/bin /usr/local/lib/systemd/system /usr/local/etc/transmission-block
chmod 700 /usr/local/etc/transmission-block
curl https://raw.githubusercontent.com/qianbinbin/transmission-block/master/transmission-block.sh \
-o /usr/local/bin/transmission-block \
https://raw.githubusercontent.com/qianbinbin/transmission-block/master/transmission-block.service \
-o /usr/local/lib/systemd/system/transmission-block.service \
https://raw.githubusercontent.com/qianbinbin/transmission-block/master/transmission-block.conf \
-o /usr/local/etc/transmission-block/transmission-block.conf
chmod +x /usr/local/bin/transmission-block
systemctl daemon-reload
如果启用了用户验证，在 /usr/local/etc/transmission-block/transmission-block.conf 中设置
TR_AUTH 用户名和密码。其余均为可选参数，用法由注释给出。
[!TIP]
推荐启用 BTN-Collected-Rules 黑名单：
EXTERNAL_BL=https://raw.githubusercontent.com/qianbinbin/transmission-block/blocklist/btn-all.p2p
# 更新较为频繁
RENEW_INTERVAL=1h
列表CDN备注完整列表Cloudflare jsDelivr包括 IPv4 和 IPv6 地址，适用于 Transmission v4.0.0 及以上版本仅 IPv4Cloudflare jsDelivr仅 IPv4 地址，适用于 Transmission v4.0.0 以下版本注：jsDelivr 有一定延迟，部分地区可能存在 DNS 污染。
其他黑名单可以查看
blocklist
和其他黑名单。
运行：
systemctl enable transmission-block.service # 开机启动
systemctl start transmission-block.service # 立即启动
systemctl status transmission-block.service # 查看状态
journalctl -f -u transmission-block.service # 查看 log
在 Transmission Web 管理页面，点击 🔧 > Peers，查看屏蔽规则是否生效。
手动运行手动运行curl https://raw.githubusercontent.com/qianbinbin/transmission-block/master/transmission-block.sh \
-o ./transmission-block.sh
chmod +x ./transmission-block.sh
export TR_AUTH=username:password # 用户名和密码，可以加入到环境变量
./transmission-block.sh # ./transmission-block.sh -h 查看更多参数
补充吸血客户端和可疑 IP欢迎在 https://github.com/qianbinbin/transmission-block/issues/9 补充吸血客户端和可疑 IP。
通过 transmission-remote --auth username:password --torrent all --peer-info
查看所有连接。
[!TIP]
如何确定可疑 IP？在 https://iknowwhatyoudownload.com/en/peer/ 上查询该 IP
的下载记录，如果下载量远超普通用户，说明可能是离线下载服务器或刷流量的。
问题排查加入黑名单后不会立即生效，系
Transmission bug，预计 v4.1.0 版本将修复这个问题。对于小于此版本，脚本尝试通过重启任务解决（见配置文件中的
RESTART_TORRENT），但偶尔会重启失败。
Transmission v4.0.0 以下不支持屏蔽 IPv6 地址。
一些客户端被离线下载服务器使用，但不排除有正常用户使用。例如
libtorrent (Rasterbar) 2.0.7、libTorrent (Rakshasa) 0.13.8 可能是迅雷或 PikPak
服务器，脚本默认屏蔽。
一些数据中心 IP 会被激进的在线黑名单拉黑，如 Vultr。
systemd 235 以下版本（通过 systemctl --version 查看）不支持 DynamicUser 和
StateDirectory，有条件建议升级。如果无法升级，需自行创建工作目录并修改 systemd 单元文件：
mkdir /var/lib/transmission-block
chown nobody:nogroup /var/lib/transmission-block # nobody:nogroup 可改为自己想要的用户和用户组
sed -i -e 's/DynamicUser=yes/User=nobody/' \ # User= 要与上面的用户相同
-e '/StateDirectory=%p/d' \
-e 's,"$STATE_DIRECTORY",/var/lib/transmission-block,' \
/usr/local/lib/systemd/system/transmission-block.service
systemctl daemon-reload
如果你不在乎安全问题，可以删除文件中 DynamicUser= 和 User= 的行，这将直接以 root 用户运行。
鸣谢blocklist
分支同步并转换以下数据为 Transmission 兼容的格式：
PBH-BTN/BTN-Collected-Rules，CC-BY 4.0
许可。https://github.com/qianbinbin/transmission-block/issues/9其他黑名单以下黑名单搜集自网络，仅供参考。
waelisa/Best-blocklist：作者表示只禁止了坏节点和版权
IP，不会禁止好节点。数据来源未知。mirror.codebucket.de - transmission：主要包括恶意
IP，但这似乎应该在防火墙禁止，而不是 P2P。I-BlockList - level1：网站声称这是反
P2P 地址列表，但其标注的来源 Bluetack
事实上已经关闭了很多年，而奇怪的是黑名单还在“更新”，经检查发现它似乎只是随机添加和删除一些 IP。I-BlockList
是商用的，网站还包括一些付费黑名单。eMule Security：包括了大量数据中心 IP，不推荐。原理原理脚本主要做以下几件事：
匹配指定客户端，并将其 IP 加入客户端黑名单（可选）。下载在线黑名单（可选）。将两种黑名单合并，在本地建立 HTTP 服务，提供给 Transmission 访问。其中客户端黑名单和在线黑名单，两者至少需要选择一种。
要屏蔽的客户端是由 LEECHER_CLIENTS 指定的，使用区分大小写的 BRE（POSIX 基本正则表达式）匹配，即 grep 不加 -i 和
-E 的匹配方式。
考虑到普通用户的 IP 动态分配，客户端黑名单默认每 7 天清空一次；在线黑名单默认每 1 天检查更新一次。这些都是可定制项。
systemd 方式默认工作目录为 /var/lib/transmission-block/（请勿手动创建），结构示例如下：
/var/lib/transmission-block/
├── extern <--- 在线黑名单目录
│ ├── b56582a4987b9324003eadc4fced8127.data <--- 在线黑名单原始文件
│ └── b56582a4987b9324003eadc4fced8127.etag <--- 在线黑名单 Etag 信息
├── leechers.p2p <--- 客户端黑名单
└── web <--- HTTP 服务根目录
└── blocklist.p2p.gz <--- 最终黑名单文件
Transmission
会更新黑名单到配置目录下的
blocklists/blocklist.bin。
[!TIP]
如果遇到可疑
IP，你可以在配置目录下新建一个文本文件，格式为
描述:起始IP-结束IP，例如 suspect:106.8.130.0-106.8.130.255，然后重新加载或重启 Transmission。
加戏时间不吸血我怎么办？开会员？
更不能用。
一个号称离线下载的？
正经人谁用离线啊。
是啊。
你用离线吗？
我不用，你用吗？
玩 P2P 的能用离线下载？
用离线下载的能叫 P2P？
（异口同声）__！
Feature request: client-based blocking · Issue #735 · transmission/transmission ↩︎