PeerBanHelper

PeerBanHelper is a self-hosted security tool that protects BitTorrent clients from unwanted peers.

  • Network Services
  • Security
  • Tools & Utilities
PeerBanHelper is a self-hosted security tool that protects BitTorrent clients from unwanted peers. It connects to your torrent client through its Web API, monitors incoming connections, and automatically bans leechers and unruly or suspicious peers, with support for custom rules. It keeps your bandwidth focused on fast, healthy, and fair sharing.

Platform availability

Available on 1 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

81/100 Excellent

Maintained
100last commit 5 days ago
Popular
766,400 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data
Security check
94no serious findings, 1 minor, CI, tests

Based on 4 of 5 factors.

GitHub stars
6,400
Open issues
16
Last commit
2026-11-16
Latest release
v9.5.5
License
GPL-3.0
Activity
steady

Checked 4 days ago - source: GitHub (PBH-BTN/PeerBanHelper)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Use Docker Compose, open port 9898, keep data safe Save the Docker Compose file (the script that starts the app in a container) and run it, then make sure port 9898 is open because that’s where you reach the web interface; also match PUID/PGID (the container’s user/group IDs) to your host user so it can read and write the data folder. source
  • Set the server token in config.yml In config.yml under server, set the token to a secret you remember because it acts like the password for the Web UI/API; if you lose it, you may be locked out of managing bans. source
  • Manual Linux: install Java 21 and use nogui If you’re installing without Docker, install OpenJDK 21 (Java) first, then start the JAR with the nogui option on a machine with no desktop. Without Java the app can’t start, and without nogui it may try to open a graphical window that isn’t available. source

Fetched 53 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Which Docker network mode should I use for PeerBanHelper?

Host network mode is recommended since v9.0.0. In bridge mode, 127.0.0.1 or localhost inside the container points to the container itself, not the host machine.

How do I access or recover the PeerBanHelper web interface?

Set the server token in config.yml under the server section. It acts as the password for the Web UI/API, and losing it can lock you out of managing bans.

Can PeerBanHelper run on a headless Linux server?

Yes. Install OpenJDK 21 first, then start the JAR with the nogui option. Without Java it will not start, and without nogui it may try to open a graphical window.

Do users report false bans from PeerBanHelper?

A community thread asks whether it false-bans normal users and whether the ban rate is high. One user reported that upload speed was zero most of the time after using it.

Answers sourced from github.com, github.com, pbh-docs.ghostchu.com, tieba.baidu.com

Community

Collected 48 days ago - public community threads