Minecraft 서버(Paper, Velocity 및 Bungee)

VPN 및 프록시 연결이 게임 세계에 참여하기 전에 중지하세요.

ProxyTracer는 고정밀 ProxyTracer API를 기준으로 참여하는 플레이어 IP를 확인하고 악성 연결을 차단, 경고 또는 로그할 수 있도록 해줍니다. 금지 회피, 대체 및 VPN 기반 봇 습격을 막는 데 적합합니다.

미리보기

게임 내 킥 화면	콘솔 경고 경고

왜 ProxyTracer인가요?

실시간 감지: ProxyTracer의 지속적으로 업데이트되는 주거용 및 공용 VPN 데이터베이스를 정확하게 검사합니다.
다중 플랫폼 기본: 단일 서버(Paper/Spigot) 및 다중 서버 네트워크(Velocity 또는 BungeeCord/Waterfall)를 위한 전용 통합입니다.
빠른 성능: 내장된 메모리 내 캐싱으로 API 크레딧을 절약하고 복귀 플레이어가 즉시 연결되도록 보장합니다.
스마트 화이트리스트: 신뢰할 수 있는 플레이어 이름과 네트워크 IP에 대한 화이트리스트 우회 명령입니다.
Discord 경고: 차단된 VPN 연결을 직원 채널에 직접 기록합니다.
브랜드 킥 화면: 'proxytracer.com'을 인용하는 전문적인 차단 메시지를 플레이어에게 표시합니다.

어떤 jar 파일을 설치해야 합니까?

설정	이 병을 설치하세요	위치	행동
단일 Paper / Spigot / Purpur 서버	`proxytracer-bukkit-1.4.0.jar`	게임 서버 `plugins/`	다운로드
Velocity 프록시 네트워크	`proxytracer-velocity-1.4.0.jar`	프록시 서버 `plugins/` (Paper에는 설치하지 마세요)	다운로드
BungeeCord / Waterfall 네트워크	`proxytracer-bungee-1.4.0.jar`	프록시 서버 `plugins/` (Paper에는 설치하지 마세요)	다운로드

규칙: 실제 클라이언트 IP가 표시되는 곳에 ProxyTracer를 설치합니다. 프록시 네트워크(Velocity 또는 BungeeCord)를 실행하는 경우 프록시에만 설치하세요. Bukkit 및 Velocity 플러그인을 모두 차단 모드에서 실행하지 마십시오(이로 인해 이중 청구 및 중복 확인이 발생함).

빠른 설정 (60초)

ProxyTracer.com/dashboard에서 무료 API 키를 받으세요.
릴리스에서 설정에 맞는 올바른 jar를 다운로드하세요.
jar를 서버의 plugins/ 디렉토리에 넣고 한 번 시작하세요.
게임 내에서 직접 또는 콘솔을 통해 API 키를 설정하세요:
```
/proxytracer set your_api_key_here
```
(이렇게 하면 자동으로 구성 파일에 키가 기록되고 플러그인이 다시 로드됩니다.)
다음을 실행하여 연결을 확인하십시오: /proxytracer status

주요 설정 항목


mode: "block"          # 프록시 감지 시 작업: block | warn | log
 
api:
  base-url: "https://api.proxytracer.com/v1"
  key: "proxy_your_key_here"
  on-error: "allow"    # API가 오프라인 상태가 될 경우 페일 오픈 정책: allow | block | warn
  timeout-ms: 2000
 
notifications:
  in-game: false       # 스태프에게 컬러 게임 내 채팅 메시지 전송 (proxytracer.notify)
 
cache:
  enabled: true
  ttl-minutes: 1440    # IP 확인 결과를 24시간 동안 캐시
  max-entries: 10000
 
discord:
  enabled: false
  webhook-url: ""
  notify-blocked: true

명령어 및 권한

모든 명령어는 /proxytracer 접두사를 사용합니다:

/proxytracer notify <on|off|toggle> — 관리자용 인게임 채팅 알림을 켜거나 끕니다.
/proxytracer notify add|remove|list [player] — 인게임 알림을 받을 관리자를 추가/제거/조회합니다(config.yml에 자동 저장).
/proxytracer set <api_key> — API 키를 직접 설정하고 config.yml에 저장 후 다시 로드합니다.
/proxytracer status — 구성 상태, API 인증 정보 및 인게임 알림 상태를 확인합니다.
/proxytracer check <ip> — IP 주소를 수동으로 조회합니다.
/proxytracer cache clear — 로컬 IP 캐시를 초기화합니다.
/proxytracer reload — 구성 파일을 다시 로드합니다.
/proxytracer whitelist name add|remove|list [player] — 특정 플레이어를 검사에서 제외합니다.
/proxytracer whitelist ip add|remove|list [ip] — 특정 네트워크 IP를 검사에서 제외합니다.

권한:

proxytracer.admin — 다시 로드, 상태 및 관리 명령에 대한 액세스입니다.
proxytracer.bypass — 이 권한이 있는 플레이어는 사전 로그인 중 요구 사항을 우회합니다.
proxytracer.notify — VPN 사용자가 로그인하거나 경고를 받으면 직원은 게임 내 경고를 받습니다.

(참고: 기본적으로 이러한 권한은 서버 운영자(OP)에게만 할당됩니다. 다른 플레이어나 직원 그룹에 이러한 권한을 부여하려면 LuckPerms와 같은 권한 관리자 플러그인을 사용하세요.)

호환성 및 요구 사항

Java 버전: Java 17 이상(Java 17, 21, 22에서 완전히 테스트됨) 플러그인은 Java 17을 대상으로 컴파일되었습니다.
서버 소프트웨어 지원: Paper / Spigot / Purpur(1.13~1.21.x), Velocity(3.x) 및 BungeeCord / Waterfall(최신 빌드).
API 액세스: proxytracer.com에 등록된 무료 또는 유료 API 키입니다.

문제 해결: 실제 IP 주소 문제 (`127.0.0.1`로 표시됨)

로그에 127.0.0.1에서 연결하는 모든 참여 플레이어가 표시되면 ProxyTracer API는 이를 스캔할 수 없습니다. 이는 호스팅 네트워크 레이아웃이나 프런트엔드 프록시가 수신 플레이어 IP를 마스킹하고 있음을 나타냅니다.

해결 방법:

프록시 네트워크(Velocity/Bungee)의 경우: ProxyTracer를 게이트웨이 프록시에만(Velocity/Bungee) 배포합니다. 백엔드 게임 노드가 실제 IP를 받을 수 있도록 플레이어 정보 전달이 활성화되어 있는지 확인하세요(velocity.toml의 player-info-forwarding-mode = "modern" 또는 Bungee의 config.yml의 ip_forward: true).
공유 호스트(예: TickHosting 패널 프록시)의 경우: 호스트가 프록시 프로토콜을 통해 연결 헤더를 전달하는 경우 Paper 구성(config/paper-global.yml의 proxies.proxy-protocol: true) 내에서 이를 활성화하고 다시 시작하세요. 경고: 호스트가 명시적으로 지원하지 않는 한 이 기능을 켜지 마십시오. 잘못 구성하면 모든 플레이어가 참가할 수 없습니다.

요금제 및 API 한도

ProxyTracer Minecraft 플러그인은 100% 무료입니다. 감지하려면 ProxyTracer API에 대한 연결이 필요합니다.

- 무료 등급: 소규모 SMP 및 개발의 경우 월 100회 확인.
- 스타터(€3/월): 공용 서버 성장에 적합합니다.
- Pro(€9/월) / Scale(€39/월): 기존 네트워크용입니다.

키 생성 및 계획 선택: ProxyTracer