IP-forwarding과 “Unable to authenticate”
프록시가 플레이어 주소를 백엔드로 전달하는 이유, 포워딩 모드, 키 설정 방법, 인증 오류 분석을 다룹니다.
업데이트 2026년 8월 13일
IP 포워딩이 없으면 백엔드 서버는 모든 플레이어를 하나의 주소, 즉 프록시의 주소로 인식해요. IP에 의존하는 모든 기능이 깨져요: 밴, 제한, 안티봇, 통계 등이요.
Velocity 모드
| 모드 | 사용 시점 |
|---|---|
modern | Paper 1.13+ — 권장해요 |
legacy | 구버전 BungeeCord와의 호환 |
bungeeguard | 보호 플러그인을 사용하는 Bungee |
none | 테스트 전용 |
modern 구성하기
프록시에서:
player-info-forwarding-mode = "modern"
forwarding-secret-file = "forwarding.secret"
각 백엔드(Paper)의 config/paper-global.yml에서:
proxies:
velocity:
enabled: true
online-mode: true
secret: "same_key"
그리고 백엔드의 server.properties에서 online-mode=false로 설정해요.
인증할 수 없음 오류
키나 모드가 일치하지 않을 때 나타나요:
- 프록시와 백엔드의 키가 달라요(공백, 줄바꿈).
- 백엔드에서
proxies.velocity.enabled가 활성화되지 않았어요. - 프록시 모드는
legacy인데 백엔드는modern을 기대해요. - 백엔드가 modern 포워딩과 함께
online-mode=true로 설정되어 있어요.
보안
백엔드의 online-mode=false는 직접 접속이 차단된 경우에만 안전해요. 그렇지 않으면 누구나 다른 사람의 닉네임으로 직접 접속할 수 있어요. Millida에서는 네트워크의 백엔드에 외부에서 접근할 수 없어요 — 서버 네트워크.
Minecraft 호스팅오프라인일 때도 서버가 실행돼요서버 만들기
