BungeeCord

BungeeCord는 마인크래프트 자바 에디션용 프록시 서버 소프트웨어이다. SpigotMC에서 개발했으며, 여러 서버를 하나의 접속 주소로 묶는 구성을 대중화시켰다.

호환 정보
최신 버전	개발 유지 보수 단계
지원 MC	광범위한 하위 호환
Java	서버 코어와 동일 계열
서버 코어	하위 서버로 Spigot, Paper 계열
선행 플러그인	없음
확인일	2026-08-06

오랫동안 사실상 표준이었으나, 현재 새로 구성하는 서버에서는 Velocity가 더 널리 권장된다. Paper 진영이 유지하던 BungeeCord 포크 Waterfall은 개발이 종료되었다.

구조

프록시는 월드를 갖지 않으며, 이용자의 연결을 받아 하위 서버로 전달한다. 이용자는 서버를 이동할 때 재접속 과정을 거치지 않는다. 로비, 생존, 창작 서버를 분리해 운영하면서도 하나의 주소로 안내할 수 있다.

IP 전달과 보안

BungeeCord는 접속자의 실제 IP와 계정 정보를 하위 서버로 넘기기 위해 이른바 legacy 전달 방식을 사용한다. 이 방식에는 전달 내용을 검증하는 수단이 없다. 하위 서버가 외부에 열려 있으면 임의의 이용자가 프록시를 거치지 않고 원하는 닉네임으로 직접 접속할 수 있다.

따라서 다음이 필수다.

• 하위 서버는 online-mode=false, spigot.yml의 settings.bungeecord: true
• 하위 서버 포트를 방화벽으로 차단해 프록시에서만 접근 가능하게 구성
• 가능하면 BungeeGuard 플러그인으로 토큰 검증을 추가

이 구조적 한계 때문에 Velocity의 modern 전달 방식이 더 안전한 선택으로 평가된다.

Velocity로 옮길 때

1. Velocity를 설치하고 velocity.toml에서 player-info-forwarding-mode = "modern"으로 지정한다.
2. 생성된 forwarding.secret 값을 확인한다.
3. 하위 서버의 spigot.yml에서 settings.bungeecord를 false로 되돌린다.
4. config/paper-global.yml에서 proxies.velocity 항목을 설정한다.
5. 플러그인 중 BungeeCord 전용 API에 의존하는 것이 있는지 확인한다.

같이 보기

• 마인크래프트/서버 코어
• Velocity
• Failed to verify username