Repolode
PBH-BTN

PBH-BTN/PeerBanHelper

Firewall autohospedado que detecta y bloquea peers no deseados, leecher y anómalos mediante las Web APIs de qBittorrent, Transmission, Deluge y otros clientes.

Estrellas
6,350
Forks
155
Issues abiertos
12
Último commit
hace 3 días

¿Qué es?

PeerBanHelper es un firewall de red personal y de código abierto para usuarios de BitTorrent. Se conecta a la Web API de los clientes compatibles, consulta la lista de conexiones de peers activas, identifica las que parecen ser de leechers o representar amenazas de seguridad y solicita al cliente que las desconecte.

Es compatible con qBittorrent (4.5.0 y versiones posteriores), Transmission (4.1.0-beta2 y versiones posteriores), BiglyBT y Deluge mediante plugins, y BitComet v2.18 y versiones posteriores. Las instalaciones con Docker deben usar el controlador de red host para que el cliente pueda ver las IP reales de los peers. Se ignoran las conexiones de I2P y Tor.

La detección se organiza en módulos: listas de bloqueo por peer ID, nombre del cliente, IP, ubicación GeoIP y tipo de IP; un detector de trampas de progreso; bloqueos automáticos de rangos; seguimiento de conexiones múltiples; un motor de scripting para detectar suplantaciones del nombre del cliente y del peer ID; y suscripciones a reglas. Una interfaz web muestra los bloqueos activos, el historial de bloqueos, las IP que más infracciones cometen, gráficos y la lista de peers.

Funciones clave

  • 01Bloquea peers por peer ID, nombre del cliente, dirección IP, ubicación GeoIP o tipo de IP
  • 02Detecta el progreso de descarga falso mediante un verificador heurístico de trampas
  • 03Bloquea automáticamente rangos de IP relacionados y rastrea peers con conexiones múltiples
  • 04Admite reglas de expresiones personalizadas y suscripciones a reglas en la nube
  • 05Incluye una interfaz web con listas de bloqueos, historial, estadísticas y gráficos

Casos de uso

  • Proteger un seedbox o servidor doméstico con qBittorrent o Transmission frente a clientes leecher
  • Reducir el desperdicio de subida en trackers privados con reglas estrictas de ratio
  • Bloquear peers de países, redes o centros de datos específicos

Inicio rápido

  1. 1

    Abre la documentación de instalación enlazada en el README

Antes de usarlo

  • Requiere un cliente BitTorrent compatible con su Web API habilitada, como qBittorrent 4.5.0 o posterior, Transmission 4.1.0-beta2 o posterior, o BitComet v2.18 o posterior.
  • Los clientes instalados en Docker deben usar el controlador de red host, no el modo bridge.
  • Solo gestiona peers IPv4 e IPv6; se ignoran las conexiones I2P y Tor.
  • Se distribuye bajo la licencia GPL-3.0, una licencia copyleft.

Temas

Preguntas frecuentes

¿Qué es PeerBanHelper?
Firewall autohospedado que detecta y bloquea peers no deseados, leecher y anómalos mediante las Web APIs de qBittorrent, Transmission, Deluge y otros clientes. PeerBanHelper es un firewall de red personal y de código abierto para usuarios de BitTorrent. Se conecta a la Web API de los clientes compatibles, consulta la lista de conexiones de peers activas, identifica las que parecen ser de leechers o representar amenazas de seguridad y solicita al cliente que las desconecte.
¿PeerBanHelper es gratuito? ¿Qué licencia tiene?
PeerBanHelper es open source bajo la licencia GPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿PeerBanHelper sigue mantenido?
Mantenimiento activo. El último commit de PeerBanHelper fue el 18 oct 2026.
¿Para qué puedo usar PeerBanHelper?
Proteger un seedbox o servidor doméstico con qBittorrent o Transmission frente a clientes leecher Reducir el desperdicio de subida en trackers privados con reglas estrictas de ratio Bloquear peers de países, redes o centros de datos específicos
¿Cómo se instala PeerBanHelper?
Abre la documentación de instalación enlazada en el README
¿Dónde consigo PeerBanHelper?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/PBH-BTN/PeerBanHelper

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados