PeerBanHelper is a scriptable BitTorrent peer banning system that automatically detects and blocks malicious, leeching, or unwanted peers using configurable rules, GeoIP data, and scriptable detection logic. It integrates with popular BitTorrent clients through their web APIs to enforce blocking rules automatically, and provides a self-hosted WebUI dashboard for monitoring active bans, historical blocks, and peer lists.
The system distinguishes itself through collaborative threat intelligence, submitting ban reports and peer population data to a central server for aggregate threat analysis while receiving cloud-defined block rules and remote deny lists. It supports GeoIP-based IP filtering to block connections by country, city, ASN, ISP, or network type, and includes an AviatorScript extensible framework that allows loading custom scripts to add new peer-evaluation rules without modifying the core application.
Additional capabilities include subnet multi-dial detection, progress cheat detection, peer history persistence to prevent ban evasion, and remote rule subscription for automatically updating blocking criteria from external sources. The system also provides traffic monitoring and statistics, daily traffic alerts, and upload speed throttling to manage peer traffic. Deployment options include Docker, FreeBSD, and Windows installations.
