PeerBanHelper

简体中文

Automatically ban unwelcome, leeching, and abnormal BT clients with support for custom rules.

Try PeerBanHelper before install to your device: Demo Site

Features

PeerBanHelper consists of the following core modules:

• PeerID Blacklist
• Client Name Blacklist
• IP/GeoIP/IP Type Blacklist
• Fake Progress Checker (Progress Cheat Blocker)
• Automatic Chain Banning
• Multi-Dial Tracking
• Peer ID/Client Name Spoofing Detection via AviatorScript Engine
• Active Monitoring (Local Data Analysis)
• IP Set Rules Subscription
• WebUI (Current Features: Active Banlist, Ban History, Top 50 Most Banned IPs, Rule Subscription Management, Charts, Peer List)

Additionally, PeerBanHelper downloads the GeoIP database on startup. Once loaded, it supports:

• Viewing IP geolocation, AS info (ASN, ISP, AS Name), and network type (Broadband, Cellular, IoT, Data Center, etc.) in ban lists
• Banning IPs by country/region, city, network type, ASN, etc.
• GeoIP statistics visualization

[!TIP] For optimal performance, we recommend using our maintained IP rule repository PBH-BTN/BTN-Collected-Rules and BTN Network, though this is entirely optional.

Supported Clients

[!CAUTION] All Docker-based downloaders must use host network driver. PBH requires real peer IPs - bridge mode is unsupported!

• qBittorrent/qBittorrent v4.5.0 or newer (XDown not supported)
• BiglyBT (requires plugin)
• Deluge (requires plugin)
• Transmission (v4.1.0-beta2 or newer required)
• BitComet v2.18 or newer (LTSeed anti-leech unsupported due to BitComet's limitation)

PeerBanHelper only supports traditional IPv4/IPv6 anti-leech. I2P/Tor connections are ignored.

Screenshots

Main UI	Ban List	Ban Logs	Ban Statistics	Rule Statistics	Rule Subscriptions

Installation

See PeerBanHelper Documentation

FAQ

Before reporting issues, check FAQ

Need Help?

Join our QQ Group or Telegram Group!

Disclaimer

By using this software, you agree to:

Illegal websites and black/grey industries shall not request any form of manual service from PBH-BTN developers/supporters. Strictly prohibited to use any PBH-BTN assets (including but not limited to code, images, programs, BTN rulesets) for illegal activities, endangering national security, telecom fraud, or assisting others in such acts.
Users shall not use PBH-BTN assets to harm other individuals/organizations. Any usage infringing rights of others is prohibited.
Users bear full responsibility for consequences arising from software usage. Developers assume no liability.

Star History

Tools

We use these excellent tools during development. Thanks to the companies/projects for providing open-source licenses:

Install4j

PeerBanHelper uses Install4j multi-platform installer builder. Thanks to ej-technologies for the OSS license. Click the link or image below for install4j.

JProfiler

PeerBanHelper uses JProfiler all-in one Java profiler for performance analysis. Thanks to ej-technologies for the OSS license. Click the link or image below for JProfiler.

Credit

Backend

• Cordelia
• IPAddress
• YamlConfiguration
• libby
• AviatorScript
• javalin
• deluge-java
• jSystemThemeDetector
• Methanol
• Flatlaf
• GeoIP2
• ormlite
• SimpleReloadLib
• portmapper
• xz
• commonmark
• oshi
• semver4j
• commonmark
• dnsjava
• SWT
• simple-java-mail
• PF4J
• completable-futures
• cdnbye/NatTypeDetector

WebUI

• Vue
• ArcoDesign
• ECharts