Eaglercraft 서버 만들기
로컬 Paper 서버에서 브라우저가 접속할 수 있는 WSS 주소까지 구성하는 최신 절차입니다.
1. 목적에 맞는 구성 선택
Shared World는 플레이어 한 명이 여는 짧은 세션에 적합합니다. 지속 월드, 플러그인, 운영 도구가 필요하면 독립 실행되는 전용 서버가 맞습니다.
초보자는 공식 Paper 템플릿이 가장 간단합니다. 기존 Java 서버 운영자는 현재 월드와 플러그인을 유지하고 EaglerXServer를 추가합니다.
| Goal | Route | Reason |
|---|---|---|
| Private test | 공식 Paper 템플릿 | Compatible baseline |
| Existing Spigot | EaglerXServer plugin | Keep world and plugins |
| Server network | BungeeCord or Velocity | Route several backends |
| Short session | Shared World | No dedicated administration |
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. 단계별 서버 설정
Back up the world and configuration before changing the server.
- 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 헤더를 전달하세요.
Home connections may require router forwarding and may be behind carrier-grade NAT. Use a host that supports persistent WebSockets when inbound access is unavailable.
모바일 데이터처럼 외부 네트워크에서 공개 주소를 테스트하세요. localhost 성공만으로 DNS, TLS, 방화벽을 확인할 수 없습니다.
6. 계층별 테스트와 문제 해결
Change one layer at a time and inspect browser, reverse-proxy, and server logs.
| Symptom | Layer | Check |
|---|---|---|
| Connection refused | Listener | Confirm the private port |
| Mixed content | TLS | Use wss:// and a valid certificate |
| 502 / upgrade failed | Proxy | Forward WebSocket headers |
| Version error | Protocol | Check ViaVersion compatibility |
| Local only | NAT / DNS | Test externally |
| Wrong player IP | Proxy | Review inject_address |
7. 공유 전 보안과 백업
공개 게이트웨이에는 자동화된 트래픽이 들어옵니다. 인증, 운영 권한, 업데이트, 복원 가능한 백업을 먼저 준비하세요.
- Use authentication or a whitelist.
- Run as a non-administrator and expose only required ports.
- Rate-limit the gateway and keep admin panels private.
- Back up worlds, plugins, and configuration, then test restoration.
- Use official releases and keep a rollback copy.
자주 묻는 질문
Official sources
- EaglerXServer — 요구 사항과 설정
- EaglerXServer v1.1.0 — verified release
- 공식 Paper 템플릿 — beginner baseline