Eaglercraft 서버 만들기
로컬 Paper 서버에서 브라우저가 접속할 수 있는 WSS 주소까지 구성하는 최신 절차입니다.
1. 목적에 맞는 구성 선택
공유 월드는 플레이어 한 명이 여는 짧은 세션에 적합합니다. 지속 월드, 플러그인, 운영 도구가 필요하면 독립 실행되는 전용 서버가 맞습니다.
초보자는 공식 Paper 템플릿이 가장 간단합니다. 기존 Java 서버 운영자는 현재 월드와 플러그인을 유지하고 EaglerXServer를 추가합니다.
| 목표 | 경로 | 이유 |
|---|---|---|
| 비공개 테스트 | 공식 Paper 템플릿 | 호환 가능한 기본 구성 |
| 기존 Spigot | EaglerXServer 플러그인 | 현재 월드와 플러그인 구성을 유지합니다. |
| 서버 네트워크 | BungeeCord 또는 Velocity | 여러 백엔드로 라우팅 |
| 짧은 세션 | 공유 월드 | 전용 서버 관리 불필요 |
2. 설치 전 최신 버전 확인
2026년 7월 25일 공식 GitHub 확인 결과, 최신 EaglerXServer v1.1.0은 2026년 5월 7일 공개되었습니다. 공식 JAR은 8,774,817바이트이며 Java 17 이상이 필요합니다.
브라우저 클라이언트 u53과 게이트웨이 v1.1.0은 서로 다른 버전입니다. 공식 release 페이지나 공식 템플릿만 사용하세요.
3. 연결 구조 이해
브라우저는 일반 Minecraft TCP 소켓에 직접 접속하지 못합니다. EaglerXServer가 WebSocket을 받고 Java 서버나 프록시로 전달합니다. HTTPS 페이지에서는 WSS가 필요합니다.
Java 백엔드는 비공개로 두고 신뢰할 수 있는 리버스 프록시에서 TLS를 종료하세요. 실제 IP가 필요할 때만 inject_address를 설정합니다.
4. 단계별 서버 설정
기존 월드를 먼저 백업하세요. 새 폴더에서 작업하고 변경한 모든 설정의 사본을 보관하세요.
- Java 17 이상 설치
java -version으로 지원되는 64비트 Java를 확인합니다. - 공식 경로 선택
공식 Paper 템플릿이나 공식 EaglerXServer v1.1.0 JAR을 사용합니다. - 설정 파일 생성
한 번 실행하고 EULA를 검토한 뒤 생성된 파일을 편집합니다. - 리스너 설정
WebSocket, 제한, 호환성과 필요 시 inject_address를 구성합니다. - 안전한 WSS 추가
리버스 프록시에서 TLS를 종료하고 WebSocket을 전달합니다. - 테스트와 백업
외부 네트워크에서 WSS를 시험하고 복원 가능한 백업을 만듭니다.
5. 안전한 WSS 주소 설정
브라우저는 HTTPS 페이지의 ws:// 연결을 차단합니다. 유효한 인증서가 있는 도메인을 사용하고 Upgrade와 Connection 헤더를 전달하세요.
가정용 연결은 라우터 포트 포워딩이 필요할 수 있고 통신사급 NAT 뒤에 있을 수 있습니다. 외부 인바운드 연결이 어렵다면 영속적인 WebSocket을 지원하는 호스트를 사용하세요.
모바일 데이터처럼 외부 네트워크에서 공개 주소를 테스트하세요. localhost 성공만으로 DNS, TLS, 방화벽을 확인할 수 없습니다.
6. 계층별 테스트와 문제 해결
한 번에 한 계층만 변경하고 리버스 프록시와 서버 로그를 확인하세요. 브라우저 콘솔을 사용하면 TLS 및 WebSocket 오류와 Minecraft 프로토콜 오류를 구분할 수 있습니다.
| 증상 | 계층 | 확인 |
|---|---|---|
| 연결 거부 | Listener | 프로세스가 설정된 비공개 포트에서 수신 대기하는지 확인하세요. |
| 혼합 콘텐츠 | TLS | ws://를 wss://로 바꾸고 인증서를 확인하세요. |
| 502 / 업그레이드 실패 | Proxy | WebSocket 헤더 전달 |
| 버전 오류 | Protocol | ViaVersion 호환성 확인 |
| 로컬에서만 작동 | NAT / DNS | 외부에서 테스트 |
| 잘못된 플레이어 IP | Proxy | inject_address 확인 |
7. 공유 전 보안과 백업
공개 게이트웨이에는 자동화된 트래픽이 들어옵니다. 인증, 운영 권한, 업데이트, 복원 가능한 백업을 먼저 준비하세요.
- 비공개 커뮤니티에는 허용 목록이나 인증 플러그인을 사용하세요.
- 관리자 권한이 없는 계정으로 서비스를 실행하고 필요한 포트만 공개하세요.
- 공개 게이트웨이의 요청 속도를 제한하고 관리 패널은 비공개로 유지하세요.
- 월드, 플러그인, 설정을 백업하고 복원 테스트를 진행하세요.
- 업데이트 전에 공식 릴리스를 확인하고 롤백용 사본을 보관하세요.
자주 묻는 질문
공식 출처
- EaglerXServer — 요구 사항과 설정
- EaglerXServer v1.1.0 — 확인된 릴리스
- 공식 Paper 템플릿 — 초보자용 기본 구성