Skip to content
호스팅 · 서버 네트워크 및 도메인

IP-forwarding과 “Unable to authenticate”

프록시가 플레이어 주소를 백엔드로 전달하는 이유, 포워딩 모드, 키 설정 방법, 인증 오류 분석을 다룹니다.

업데이트 2026년 8월 13일

IP 포워딩이 없으면 백엔드 서버는 모든 플레이어를 하나의 주소, 즉 프록시의 주소로 인식해요. IP에 의존하는 모든 기능이 깨져요: 밴, 제한, 안티봇, 통계 등이요.

Velocity 모드

모드사용 시점
modernPaper 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로 설정해요.

인증할 수 없음 오류

키나 모드가 일치하지 않을 때 나타나요:

  1. 프록시와 백엔드의 키가 달라요(공백, 줄바꿈).
  2. 백엔드에서 proxies.velocity.enabled가 활성화되지 않았어요.
  3. 프록시 모드는 legacy인데 백엔드는 modern을 기대해요.
  4. 백엔드가 modern 포워딩과 함께 online-mode=true로 설정되어 있어요.

보안

백엔드의 online-mode=false는 직접 접속이 차단된 경우에만 안전해요. 그렇지 않으면 누구나 다른 사람의 닉네임으로 직접 접속할 수 있어요. Millida에서는 네트워크의 백엔드에 외부에서 접근할 수 없어요 — 서버 네트워크.

Minecraft 호스팅오프라인일 때도 서버가 실행돼요서버 만들기