# PBH-BTN/PeerBanHelper

Automatically block unwanted, leeches and abnormal BT peers with support for customized and cloud rules.| BT 反吸血工具 - 自动封禁不受欢迎、吸血和异常的 BT 客户端，并支持自定义规则。支持 qB/qBEE/Deluge/BiglyBT/BitComet

Repository: https://github.com/PBH-BTN/PeerBanHelper
Canonical: https://ross.abutalabs.com/products/peerbanhelper
Language: Java
License: GPL-3.0
License Family: copyleft
Topics: bittorrent, qbittorrent, xunlei, transmission, peerbanhelper, dt-torrrent, hp-torrent, biglybt, deluge, gt0002, gt0003, xl0012, xl0018, xl0019, xm0001, dt0001, hp0001, bitcomet
Last push: 2026-08-21T13:57:09+00:00

## Health v2 (maintenance only)
Score: 88/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 98, release rhythm 86, longevity 67
- inputs: {"age_days": 938, "days_push": 12, "days_rel": 14, "gap_med": 3.0, "n_releases_24m": 101}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 6210, forks 152 (observed 2026-08-28T04:09:40.016454+00:00)

## What it is
PeerBanHelper is a self-hosted Java application that automatically bans unwanted, leeching, and abnormal BitTorrent peers by connecting to the Web APIs of supported clients like qBittorrent, Transmission, Deluge, BiglyBT, and BitComet. It offers customizable and cloud-sourced block rules, GeoIP-based banning, fake-progress detection, and a WebUI for viewing ban statistics.

## Use cases
- automatically ban leeching bittorrent peers
- block clients that fake upload progress
- ban peers by country or ASN with geoip rules
- subscribe to community ip blocklists for my torrent client
- protect qbittorrent from abusive swarm peers
- view which ips got banned and why
- auto range-ban related ips of a banned peer

## When to choose
- you run a supported BitTorrent client (qBittorrent 4.5+, Transmission 4.1+, Deluge, BiglyBT, BitComet) and want automated anti-leech protection
- you want customizable rules plus optional community/cloud rule subscriptions
- you want a WebUI with ban history, statistics, and GeoIP insights

## When to avoid
- your downloader runs in Docker bridge mode, since real peer IPs are required (host networking is mandatory)
- you use clients outside the supported list or older versions
- you need to block I2P or Tor connections, which are deliberately ignored

## Facets
- artifact type: application
- maturity: active
- function: security, networking, monitoring, webhook, self-hosted
- domain: networking, security, privacy, self-hosted
- platform: cross-platform, self-hosted, jvm
- tags: bittorrent, anti-leech, peer-banning, ip-blocklist, geoip, qbittorrent, transmission, deluge, biglybt, bitcomet, java, docker, web-server

## Member repositories
- PBH-BTN/PeerBanHelper (main) score 88

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:40.016454+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:47:17.811977+00:00, confidence not recorded.
  - readme: https://github.com/PBH-BTN/PeerBanHelper (fetched 2026-08-28T04:09:40.016454+00:00, sha e0271d69d7e6)
- Data as of 2026-08-30T08:39:29.467469+00:00.