Peerbanhelper

프로그램 소개

PeerBanHelper는 BitTorrent 클라이언트의 Web API를 통해 연결된 피어 정보를 실시간으로 모니터링하여, 흡혈 피어, 알려진 악성 IP, 비정상적인 행동을 보이는 클라이언트를 자동으로 차단하는 개인용 네트워크 방화벽입니다. qBittorrent, Transmission, BitComet, BiglyBT 등 주요 토렌트 클라이언트와 연동하여 작동하며, 사용자 정의 규칙과 커뮤니티 유지 관리형 클라우드 규칙을 모두 지원합니다. 오픈소스 프로젝트로 GPL-3.0-only 라이선스 하에 배포되며, Java 기반으로 개발되어 Windows 환경에서 실행 가능합니다.

주요 기능

피어 ID 및 클라이언트 이름 기반 차단

PeerBanHelper는 알려진 악성 피어 ID 또는 의심스러운 클라이언트 이름을 실시간으로 탐지하여 해당 연결을 차단합니다. 이는 AviatorScript 엔진을 기반으로 한 유연한 표현 언어를 통해 고급 조건 규칙을 정의할 수 있도록 지원합니다.

IP/GeoIP 기반 차단

내장된 GeoIP2 라이브러리를 통해 IP 주소의 지리적 위치, ASN, ISP, 네트워크 유형(예: 데이터센터, 모바일, 주거망)을 분석하고, 국가별, 도시별, ASN별로 차단 규칙을 적용할 수 있습니다. GeoIP 정보는 프로그램 시작 시 자동으로 다운로드됩니다.

가짜 진행도 탐지기

일부 비정상 클라이언트는 다운로드 진행도를 조작하여 기여도를 속입니다. PeerBanHelper는 이러한 행동을 휴리스틱하게 분석하여 속이는 클라이언트를 탐지하고 차단합니다.

자동 범위 차단 및 다중 dial 추적

동일한 네트워크 대역에서 다수의 의심스러운 연결이 감지될 경우, 전체 IP 범위를 자동으로 차단하는 기능을 제공합니다. 또한, 자주 변경하는 IP를 사용하는 피어를 추적하여 지속적으로 차단할 수 있는 다중 dial 추적 모듈을 포함합니다.

주동 모니터링 및 로컬 데이터 분석

실시간 연결 흐름을 분석하여 비정상적인 패턴(예: 과도한 연결 요청, 비정상적인 핸드셰이크)을 탐지하고, 이를 기반으로 선제적 차단을 수행합니다. 수집된 데이터는 로컬에 저장되어 통계 및 분석에 활용됩니다.

웹 기반 사용자 인터페이스(WebUI)

PeerBanHelper는 내장된 WebUI를 통해 브라우저에서 다음과 같은 기능을 제공합니다:

• 현재 활성 차단 목록 보기
• 과거 차단 이력 및 통계 조회
• 차단 빈도가 높은 상위 50개 IP 확인
• 규칙 구독 목록 관리 및 업데이트
• GeoIP 통계 및 IP 지리 정보 시각화
• 실시간 피어 목록 모니터링

다운로드 및 설치 방법

PeerBanHelper는 Scoop 패키지 관리자를 통해 간단히 설치할 수 있습니다. Scoop이 이미 설치되어 있다면, 다음 명령어를 실행하여 extras 저장소에서 PeerBanHelper를 설치할 수 있습니다:

scoop install extras/peerbanhelper

수동 설치를 원한다면, 공식 GitHub 저장소에서 최신 �리스의 ZIP 파일을 다운로드한 후 압축을 해제하고, 실행 파일을 직접 실행할 수 있습니다. 설치 후 처음 실행 시, 프로그램은 자동으로 GeoIP 데이터베이스를 다운로드하고, 연동할 토렌트 클라이언트의 Web API 설정을 안내합니다.

기본 사용법

PeerBanHelper를 실행하면 시스템 트레이에 아이콘이 나타나며, 이를 통해 WebUI에 접근하거나 프로그램을 종료할 수 있습니다. WebUI는 기본적으로 http://localhost:25565 주소에서 이용 가능하며, 브라우저를 열어 해당 주소에 접속하면 대시보드를 확인할 수 있습니다.
연동하려는 토렌트 클라이언트(qBittorrent, Transmission 등)의 Web API를 활성화하고, PeerBanHelper 설정에서 해당 클라이언트의 호스트, 포트, 사용자명 및 비밀번호를 입력하면 연결이 완료됩니다. 연결이 성공되면, PeerBanHelper는 실시간으로 피어 정보를 수신하고, 설정된 규칙에 따라 차단 작업을 시작합니다.
규칙은 WebUI의 ‘규칙 관리’ 메뉴에서 활성화/비활성화하거나, 클라우드 규칙 구독을 통해 자동으로 업데이트받을 수 있습니다. 사용자 정의 규칙은 AviatorScript 문법을 기반으로 작성할 수 있으며, 예시 및 문법 도움말은 공식 문서에서 제공됩니다.

이런 경우에 유용합니다

토렌트 사용 중 다운로드 속도가 비정상적으로 느리거나, 업로드 기여도가 인정받지 못하는 경우, PeerBanHelper를 설치하여 흡혈 피어와 비정상적인 클라이언트를 차단하면 네트워크 효율을 개선할 수 있습니다. 특히 공유 트래커나 공개 토렌트에서 자주 발생하는 악성 피어 공격을 방어하는 데 유용하며, GeoIP 기반 차단을 통해 특정 국가나 데이터센터 IP에서의 연결을 선제적으로 방지할 수 있습니다. 또한, 토렌트 클라이언트의 Web API를 통해 외부 도구와 연동이 가능한 고급 사용자는 PeerBanHelper의 로그 및 통계 데이터를 활용해 네트워크 행동을 분석할 수 있습니다.

지원 환경·시스템 요구사항

PeerBanHelper는 Windows 10 이상 64비트 운영체제에서 실행 가능하며, Java 런타임 환경이 필요하지 않습니다. 이는 패키징 과정에서 내장된 JRE를 포함하기 때문입니다. 토렌트 클라이언트 측면에서는 다음과 같은 버전을 지원합니다:

• qBittorrent 4.5.0 이상
• Transmission 4.1.0-beta2 이상
• BitComet v2.18 이상
• BiglyBT (별도 플러그인 설치 필요)
• Deluge (별도 플러그인 설치 필요)

Docker 환경에서 토렌트 클라이언트를 사용하는 경우, 호스트 네트워크 모드를 반드시 사용해야 하며, 브리지 모드에서는 피어의 실제 IP를 얻을 수 없어 정상 작동하지 않습니다.

최신 버전·업데이트

현재 최신 버전은 9.5.1이며, 공식 GitHub 저장소의 dev 브랜치에서 지속적인 개발이 이루어지고 있습니다. 업데이트는 Scoop을 통해 scoop update peerbanhelper 명령어로 수행할 수 있으며, 수동 설치 시 최신 ZIP 파일을 다시 다운로드하여 교체하면 됩니다. 버전별 변경 사항은 GitHub의 �리스 노트에서 확인할 수 있습니다.

제한 사항·확인 사항

PeerBanHelper는 IPv4 및 IPv6 주소에 대해서만 차단 기능을 제공하며, I2P 또는 Tor 네트워크를 통해 연결된 피어는 의도적으로 무시합니다. 이는 해당 네트워크의 특성상 IP 기반 차단이 의미가 없기 때문입니다. 또한, 토렌트 클라이언트의 Web API가 비활성화되거나 방화벽에 의해 차단된 경우 PeerBanHelper는 피어 정보를 얻을 수 없으므로, 사전에 클라이언트 측 Web API를 활성화하고 접근 권한을 설정해야 합니다. BiglyBT 및 Deluge를 사용하는 경우, 각각의 공식 플러그인을 별도로 설치해야 정상 연동이 가능합니다.

FAQ

• PeerBanHelper는 무료인가요?
  네, PeerBanHelper는 GPL-3.0-only 라이선스로 배포되는 완전 무료 오픈소스 소프트웨어입니다.
• 인터넷 연결이 필수인가요?
  프로그램 핵심 기능은 로컬에서 작동하지만, GeoIP 데이터베이스 초기 다운로드 및 클라우드 규칙 구독을 위해서는 인터넷 연결이 필요합니다. 오프라인 환경에서도 마지막으로 다운로드된 규칙과 GeoIP 정보로는 제한적인 차단 기능이 가능합니다.
• 어떤 토렌트 클라이언트와 호환되나요?
  qBittorrent 4.5.0+, Transmission 4.1.0-beta2+, BitComet v2.18+와 공식적으로 호환되며, BiglyBT 및 Deluge는 각각의 커뮤니티 플러그인 설치를 통해 사용할 수 있습니다.
• 사용 중에 토렌트 클라이언트를 재시작해도 되나요?
  네, 토렌트 클라이언트를 재시작해도 PeerBanHelper는 자동으로 재연결을 시도하며, 설정 정보는 유지됩니다.