{"id":43258563,"url":"https://github.com/pbh-btn/peerbanhelper","last_synced_at":"2026-04-26T20:01:08.025Z","repository":{"id":221361817,"uuid":"754169590","full_name":"PBH-BTN/PeerBanHelper","owner":"PBH-BTN","description":"Automatically block unwanted, leeches and abnormal BT peers with support for customized and cloud rules.| BT 反吸血工具 - 自动封禁不受欢迎、吸血和异常的 BT 客户端，并支持自定义规则。支持 qB/qBEE/Deluge/BiglyBT/BitComet","archived":false,"fork":false,"pushed_at":"2026-04-26T18:45:32.000Z","size":124771,"stargazers_count":5938,"open_issues_count":15,"forks_count":141,"subscribers_count":10,"default_branch":"dev","last_synced_at":"2026-04-26T19:23:01.736Z","etag":null,"topics":["biglybt","bitcomet","bittorrent","deluge","dt-torrrent","dt0001","gt0002","gt0003","hp-torrent","hp0001","peerbanhelper","qbittorrent","transmission","xl0012","xl0018","xl0019","xm0001","xunlei"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PBH-BTN.png","metadata":{"files":{"readme":"README.EN.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"custom":["https://mbd.pub/o/ghostchu","https://ifdian.net/a/Ghost_chu"]}},"created_at":"2024-02-07T14:35:16.000Z","updated_at":"2026-04-26T18:45:36.000Z","dependencies_parsed_at":"2024-03-15T17:32:22.689Z","dependency_job_id":"c136ebf4-d4c0-4186-a936-5b0b1c0b8eca","html_url":"https://github.com/PBH-BTN/PeerBanHelper","commit_stats":null,"previous_names":["ghost-chu/peerbanhelper","pbh-btn/peerbanhelper"],"tags_count":233,"template":false,"template_full_name":null,"purl":"pkg:github/PBH-BTN/PeerBanHelper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PBH-BTN%2FPeerBanHelper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PBH-BTN%2FPeerBanHelper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PBH-BTN%2FPeerBanHelper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PBH-BTN%2FPeerBanHelper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PBH-BTN","download_url":"https://codeload.github.com/PBH-BTN/PeerBanHelper/tar.gz/refs/heads/dev","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PBH-BTN%2FPeerBanHelper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32310804,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T19:15:34.056Z","status":"ssl_error","status_checked_at":"2026-04-26T19:15:15.467Z","response_time":129,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["biglybt","bitcomet","bittorrent","deluge","dt-torrrent","dt0001","gt0002","gt0003","hp-torrent","hp0001","peerbanhelper","qbittorrent","transmission","xl0012","xl0018","xl0019","xm0001","xunlei"],"created_at":"2026-02-01T14:01:17.687Z","updated_at":"2026-04-26T20:01:07.998Z","avatar_url":"https://github.com/PBH-BTN.png","language":"Java","funding_links":["https://mbd.pub/o/ghostchu","https://ifdian.net/a/Ghost_chu"],"categories":[],"sub_categories":[],"readme":"# PeerBanHelper\n[简体中文](./README.md)\n\nAutomatically ban unwelcome, leeching, and abnormal BT clients with support for custom rules.\n\n![page-views](https://raw.githubusercontent.com/PBH-BTN/views-counter/refs/heads/master/svg/754169590/badge.svg)\n\n**Try PeerBanHelper before install to your device:** [Demo Site](https://pbh-demo.pbh-btn.com)\n\n## Features\n\nPeerBanHelper consists of the following core modules:\n\n- [PeerID Blacklist](https://docs.pbh-btn.com/docs/module/peer-id)\n- [Client Name Blacklist](https://docs.pbh-btn.com/docs/module/client-name)\n- [IP/GeoIP/IP Type Blacklist](https://docs.pbh-btn.com/docs/module/ip-address-blocker)\n- [Fake Progress Checker (Progress Cheat Blocker)](https://docs.pbh-btn.com/docs/module/progress-cheat-blocker)\n- [Automatic Chain Banning](https://docs.pbh-btn.com/docs/module/auto-range-ban)\n- [Multi-Dial Tracking](https://docs.pbh-btn.com/docs/module/multi-dial)\n- Peer ID/Client Name Spoofing Detection via [AviatorScript Engine](https://docs.pbh-btn.com/docs/module/expression-engine)\n- [Active Monitoring (Local Data Analysis)](https://docs.pbh-btn.com/docs/module/active-monitoring)\n- [IP Set Rules Subscription](https://docs.pbh-btn.com/docs/module/ip-address-blocker-rules)\n- WebUI (Current Features: Active Banlist, Ban History, Top 50 Most Banned IPs, Rule Subscription Management, Charts, Peer List)\n\nAdditionally, PeerBanHelper downloads the GeoIP database on startup. Once loaded, it supports:\n\n- Viewing IP geolocation, AS info (ASN, ISP, AS Name), and network type (Broadband, Cellular, IoT, Data Center, etc.) in ban lists\n- Banning IPs by country/region, city, network type, ASN, etc.\n- GeoIP statistics visualization\n\n\u003e [!TIP]\n\u003e For optimal performance, we recommend using our maintained IP rule repository [PBH-BTN/BTN-Collected-Rules](https://github.com/PBH-BTN/BTN-Collected-Rules) and [BTN Network](https://docs.pbh-btn.com/docs/btn/intro), though this is entirely optional.\n\n## Supported Clients\n\n\u003e [!CAUTION]\n\u003e All Docker-based downloaders must use host network driver. PBH requires real peer IPs - bridge mode is unsupported!\n\n- qBittorrent/qBittorrent **v4.5.0 or newer** (XDown not supported)\n- BiglyBT (requires [plugin](https://github.com/PBH-BTN/PBH-Adapter-BiglyBT))\n- Deluge (requires [plugin](https://github.com/PBH-BTN/PBH-Adapter-Deluge))\n- Transmission **(v4.1.0-beta2 or newer required)**\n- BitComet **v2.18 or newer** (LTSeed anti-leech unsupported due to BitComet's limitation)\n\nPeerBanHelper only supports traditional IPv4/IPv6 anti-leech. I2P/Tor connections are ignored.\n\n# Screenshots\n\n| Main UI                                                                                                                              | Ban List                                                                                                                           | Ban Logs                                                                                                                           | Ban Statistics                                                                                                                     | Rule Statistics                                                                                                                     | Rule Subscriptions                                                                                                                   |\n| ------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |\n| \u003cimg width=\"1280\" alt=\"homepage\" src=\"https://github.com/PBH-BTN/PeerBanHelper/assets/19235246/d7f7ea9f-70df-40f1-a782-260450972bc9\"\u003e | \u003cimg width=\"1280\" alt=\"banlist\" src=\"https://github.com/PBH-BTN/PeerBanHelper/assets/19235246/c3e139e6-eb82-423f-b083-1839713ec801\"\u003e | \u003cimg width=\"1280\" alt=\"banlogs\" src=\"https://github.com/PBH-BTN/PeerBanHelper/assets/19235246/00d8efcc-0dd7-4e05-bdeb-9444e14739d6\"\u003e | \u003cimg width=\"1280\" alt=\"maxban\" src=\"https://github.com/PBH-BTN/PeerBanHelper/assets/30802565/ae78ebb9-67f7-481a-9afc-7ced2c6a2534\"\u003e | \u003cimg width=\"1280\" alt=\"banMetrics\" src=\"https://github.com/PBH-BTN/PeerBanHelper/assets/19235246/9e4cd7b7-aaff-4b66-8d1d-ad4ef3466b1f\"\u003e | \u003cimg width=\"1280\" alt=\"banMetrics\" src=\"https://github.com/PBH-BTN/PeerBanHelper/assets/19235246/dc312186-9643-4f23-9d53-7b8e0852f228\"\u003e |\n\n## Installation\n\nSee [PeerBanHelper Documentation](https://docs.pbh-btn.com/docs/category/%E5%AE%89%E8%A3%85%E9%83%A8%E7%BD%B2)\n\n## FAQ\n\nBefore reporting issues, check [FAQ](https://docs.pbh-btn.com/docs/faq)\n\n## Need Help?\n\nJoin our [QQ Group](https://qm.qq.com/cgi-bin/qm/qr?k=w5as_wH2G1ReUrClreCYhR69XiNCuP65\u0026jump_from=webapi\u0026authKey=EyjMX7Pwc77XLM51V6FEcR7oXnG8fsUbSFqYZ4PPiEpq32vBglJn/jFvpc3LFDhn) or [Telegram Group](https://t.me/+_t3Nt5GZ6bJmYjBl)!\n\n## Disclaimer\n\n**By using this software, you agree to:**\n\nIllegal 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.  \nUsers shall not use PBH-BTN assets to harm other individuals/organizations. Any usage infringing rights of others is prohibited.  \nUsers bear full responsibility for consequences arising from software usage. Developers assume no liability.\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=PBH-BTN/PeerBanHelper\u0026type=Date)](https://star-history.com/#PBH-BTN/PeerBanHelper\u0026Date)\n\n## Tools\n\nWe use these excellent tools during development. Thanks to the companies/projects for providing open-source licenses:\n\n### Install4j\n\nPeerBanHelper uses [Install4j multi-platform installer builder](https://www.ej-technologies.com/products/install4j/overview.html). Thanks to ej-technologies for the OSS license. Click the link or image below for install4j.\n\n[![Install4j](https://www.ej-technologies.com/images/product_banners/install4j_large.png)](https://www.ej-technologies.com/products/install4j/overview.html)\n\n### JProfiler\n\nPeerBanHelper uses [JProfiler all-in one Java profiler](https://www.ej-technologies.com/jprofiler) for performance analysis. Thanks to ej-technologies for the OSS license. Click the link or image below for JProfiler.\n\n[![JProfiler](https://www.ej-technologies.com/images/product_banners/jprofiler_large.png)](https://www.ej-technologies.com/jprofiler)\n\n## Credit\n\n### Backend\n\n- [Cordelia](https://github.com/bochkov/cordelia)\n- [IPAddress](https://github.com/seancfoley/IPAddress)\n- [YamlConfiguration](https://github.com/bspfsystems/YamlConfiguration)\n- [libby](https://github.com/AlessioDP/libby)\n- [AviatorScript](https://github.com/killme2008/aviatorscript)\n- [javalin](https://javalin.io/)\n- [deluge-java](https://github.com/RangerRick/deluge-java)\n- [jSystemThemeDetector](https://github.com/Dansoftowner/jSystemThemeDetector)\n- [Methanol](https://github.com/mizosoft/methanol)\n- [Flatlaf](https://github.com/JFormDesigner/FlatLaf)\n- [GeoIP2](https://dev.maxmind.com/geoip)\n- [ormlite](https://ormlite.com/)\n- [SimpleReloadLib](https://github.com/Ghost-chu/SimpleReloadLib)\n- [portmapper](https://github.com/offbynull/portmapper)\n- [xz](https://github.com/tukaani-project/xz-java)\n- [commonmark](https://github.com/commonmark/commonmark-java)\n- [oshi](https://github.com/oshi/oshi)\n- [semver4j](https://github.com/vdurmont/semver4j)\n- [commonmark](https://github.com/commonmark/commonmark-java)\n- [dnsjava](https://github.com/dnsjava/dnsjava)\n- [SWT](https://eclipse.dev/eclipse/swt/)\n- [simple-java-mail](https://www.simplejavamail.org/)\n- [PF4J](https://pf4j.org/)\n- [completable-futures](https://github.com/spotify/completable-futures)\n- [cdnbye/NatTypeDetector](https://github.com/cdnbye/NatTypeDetector)\n\n### WebUI\n\n- [Vue](https://vuejs.org/)\n- [ArcoDesign](https://arco.design/)\n- [ECharts](https://echarts.apache.org/en/index.html)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpbh-btn%2Fpeerbanhelper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpbh-btn%2Fpeerbanhelper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpbh-btn%2Fpeerbanhelper/lists"}