Repolode
PBH-BTN

PBH-BTN/PeerBanHelper

qBittorrent, Transmission, Deluge 등 클라이언트의 Web API를 통해 원치 않거나 업로드를 받기만 하는 비정상 BitTorrent 피어를 탐지하고 차단하는 셀프 호스팅 방화벽입니다.

스타
6,350
포크
155
열린 이슈
12
마지막 커밋
3일 전

어떤 프로젝트인가요?

PeerBanHelper는 BitTorrent 사용자를 위한 오픈소스 개인 네트워크 방화벽입니다. 지원되는 클라이언트의 Web API에 연결해 현재 피어 연결 목록을 읽고, 시더에게서 받기만 하거나 보안 위협으로 보이는 피어를 식별한 뒤 클라이언트에 연결 해제를 요청합니다.

qBittorrent(4.5.0 이상), Transmission(4.1.0-beta2 이상), 플러그인을 통한 BiglyBT 및 Deluge, BitComet v2.18 이상을 지원합니다. Docker로 배포할 때는 클라이언트가 실제 피어 IP를 확인할 수 있도록 호스트 네트워크 드라이버를 사용해야 합니다. I2P와 Tor 연결은 무시합니다.

탐지 기능은 피어 ID, 클라이언트 이름, IP, GeoIP 및 IP 유형별 블랙리스트, 진행률 조작 탐지기, 자동 대역 차단, 멀티 다이얼 추적, 클라이언트 이름 및 피어 ID 스푸핑을 확인하는 스크립팅 엔진, 규칙 구독 모듈로 구성됩니다. 웹 UI에서는 활성 차단, 차단 기록, 가장 많이 문제를 일으킨 IP, 차트, 피어 목록을 확인할 수 있습니다.

핵심 기능

  • 01피어 ID, 클라이언트 이름, IP 주소, GeoIP 위치 또는 IP 유형을 기준으로 피어를 차단합니다
  • 02휴리스틱 기반 조작 탐지기로 다운로드 진행률을 속이는 피어를 찾아냅니다
  • 03관련 IP 대역을 자동으로 차단하고 멀티 다이얼 피어를 추적합니다
  • 04사용자 지정 표현식 규칙과 클라우드 규칙 구독을 지원합니다
  • 05차단 목록, 기록, 통계, 차트를 제공하는 웹 UI가 포함되어 있습니다

활용 사례

  • qBittorrent 또는 Transmission을 실행하는 시드박스나 홈 서버를 시더에게서 받기만 하는 피어로부터 보호
  • 비율 규정이 엄격한 프라이빗 트래커에서 업로드 낭비 줄이기
  • 특정 국가, 네트워크 또는 데이터 센터의 피어 차단

빠른 시작

  1. 1

    README에 링크된 설치 문서를 여세요

사용 전 알아둘 점

  • qBittorrent 4.5.0 이상, Transmission 4.1.0-beta2 이상, BitComet v2.18 이상과 같이 Web API가 활성화된 지원 BitTorrent 클라이언트가 필요합니다.
  • Docker에 설치된 클라이언트는 bridge 모드가 아닌 host 네트워크 드라이버를 사용해야 합니다.
  • IPv4 및 IPv6 피어만 처리하며, I2P 및 Tor 연결은 무시됩니다.
  • 카피레프트 라이선스인 GPL-3.0에 따라 라이선스가 부여됩니다.

토픽

자주 묻는 질문

PeerBanHelper은(는) 무엇인가요?
qBittorrent, Transmission, Deluge 등 클라이언트의 Web API를 통해 원치 않거나 업로드를 받기만 하는 비정상 BitTorrent 피어를 탐지하고 차단하는 셀프 호스팅 방화벽입니다. PeerBanHelper는 BitTorrent 사용자를 위한 오픈소스 개인 네트워크 방화벽입니다. 지원되는 클라이언트의 Web API에 연결해 현재 피어 연결 목록을 읽고, 시더에게서 받기만 하거나 보안 위협으로 보이는 피어를 식별한 뒤 클라이언트에 연결 해제를 요청합니다.
PeerBanHelper은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
PeerBanHelper은(는) GPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
PeerBanHelper은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. PeerBanHelper의 마지막 커밋은 2026년 10월 18일입니다.
PeerBanHelper은(는) 어디에 사용할 수 있나요?
qBittorrent 또는 Transmission을 실행하는 시드박스나 홈 서버를 시더에게서 받기만 하는 피어로부터 보호 비율 규정이 엄격한 프라이빗 트래커에서 업로드 낭비 줄이기 특정 국가, 네트워크 또는 데이터 센터의 피어 차단
PeerBanHelper는 어떻게 설치하나요?
README에 링크된 설치 문서를 여세요
PeerBanHelper은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/PBH-BTN/PeerBanHelper

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트