pbh-btn/peerbanhelper

PeerBanHelper is an open-source security tool for BitTorrent users that automatically detects and blocks unwanted or abusive peers in a torrent download session. In a BitTorrent network, your download client connects to many other users (called peers) to share pieces of a file. Some of these peers behave badly: they might download without uploading (called leeching), report fake progress to cheat the network, or disguise themselves using spoofed client identifiers. PeerBanHelper identifies these peers and tells your BitTorrent client to disconnect from them. The tool connects to supported BitTorrent clients through their web APIs and monitors the peer list in real time. Supported clients include qBittorrent, BiglyBT, Deluge, Transmission, and BitComet, though BiglyBT and Deluge require installing a plugin. The tool is written in Java and runs as a background service with its own web interface. Blocking rules fall into several categories. There are blacklists for known bad peer IDs and client names. IP addresses can be blocked individually or by geographic region using a GeoIP database that the tool downloads automatically on first run. The tool can detect peers that are reporting fake download progress, which is a way some clients try to avoid being disconnected. An auto-range ban feature will block a range of IP addresses if too many bad actors are found within the same block. The web interface shows active bans, historical ban logs, and charts summarizing which rules triggered most often. Users can also subscribe to cloud-maintained rule sets that are updated by the project's community, adding shared knowledge about known bad actors to the local tool. The README is written in Chinese. Documentation and a live demo are linked in the repository. The project notes that it does not support I2P or Tor connections.