Repolode
Submit
PBH-BTN

PBH-BTN/PeerBanHelper

Self-hosted firewall that detects and bans unwanted, leeching and abnormal BitTorrent peers via qBittorrent, Transmission, Deluge and other clients' Web APIs.

View on GitHub
Stars
6,350
Forks
155
Open issues
12
Last commit
3 days ago

What is it?

PeerBanHelper is an open-source personal network firewall for BitTorrent users. It connects to the Web API of supported clients, reads the list of current peer connections, flags those that look like leeches or security threats, and asks the client to disconnect them.

It works with qBittorrent (4.5.0 and later), Transmission (4.1.0-beta2 and later), BiglyBT and Deluge through plugins, and BitComet v2.18 and later. Docker deployments must use the host network driver so the client can see real peer IPs. I2P and Tor connections are ignored.

Detection is organized into modules: blacklists by peer ID, client name, IP, GeoIP and IP type; a progress-cheat detector; automatic range bans; multi-dial tracking; a scripting engine for client name and peer ID spoofing checks; and rule subscriptions. A web UI shows active bans, ban history, top offending IPs, charts and the peer list.

Key features

  • 01Blocks peers by peer ID, client name, IP address, GeoIP location or IP type
  • 02Detects fake download progress with a heuristic cheat checker
  • 03Automatically bans related IP ranges and tracks multi-dial peers
  • 04Supports custom expression rules and cloud rule subscriptions
  • 05Includes a web UI with ban lists, history, statistics and charts

Use cases

  • Protecting a seedbox or home server running qBittorrent or Transmission from leech clients
  • Reducing upload waste on private trackers with strict ratio rules
  • Blocking peers from specific countries, networks or data centers

Quick start

  1. 1

    Open the installation documentation linked in the README

Things to know

  • Requires a supported BitTorrent client with its Web API enabled, such as qBittorrent 4.5.0 or later, Transmission 4.1.0-beta2 or later, or BitComet v2.18 or later.
  • Clients installed in Docker must use the host network driver, not bridge mode.
  • Only handles IPv4 and IPv6 peers; I2P and Tor connections are ignored.
  • Licensed under GPL-3.0, a copyleft license.

Topics

#bittorrent#peer-blocking#firewall#qbittorrent#transmission#self-hosted#geoip#biglybt#bitcomet#deluge

FAQ

What is PeerBanHelper?
Self-hosted firewall that detects and bans unwanted, leeching and abnormal BitTorrent peers via qBittorrent, Transmission, Deluge and other clients' Web APIs. PeerBanHelper is an open-source personal network firewall for BitTorrent users. It connects to the Web API of supported clients, reads the list of current peer connections, flags those that look like leeches or security threats, and asks the client to disconnect them.
Is PeerBanHelper free to use? What license does it have?
PeerBanHelper is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is PeerBanHelper still maintained?
Actively maintained. The last commit to PeerBanHelper was on Oct 18, 2026.
What can I use PeerBanHelper for?
Protecting a seedbox or home server running qBittorrent or Transmission from leech clients Reducing upload waste on private trackers with strict ratio rules Blocking peers from specific countries, networks or data centers
How do I install PeerBanHelper?
Open the installation documentation linked in the README
Where can I get PeerBanHelper?
The source code and installation instructions are on GitHub: https://github.com/PBH-BTN/PeerBanHelper

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects