소개

소개

MSPB란?

**MSPB(Minecraft Server Port Bridge)**는 복잡한 공유기 설정 없이 프로그램 실행 하나로 로컬 마인크래프트 서버를 외부 플레이어에게 개방하는 서비스입니다.

포트 포워딩이나 방화벽 설정 없이, 클라이언트 프로그램만 실행하면 외부에서 접속 가능한 주소를 자동으로 할당받습니다.

주요 기능

기능	설명
원클릭 개방	프로그램 실행만으로 서버 개방 완료
MC 패킷 검증	마인크래프트 프로토콜만 허용하여 비정상 트래픽 차단
동적 포트 할당	접속 시 자동으로 외부 포트 할당, 종료 시 자동 회수
하트비트 모니터링	15초 간격 Ping/Pong으로 연결 상태 확인, 45초 이상 응답 없으면 자동 회수
자동 재연결	연결 끊김 시 5초 후 자동 재접속
실시간 대시보드	접속 플레이어, 트래픽 등 실시간 모니터링
멀티플렉싱	단일 연결로 여러 플레이어 동시 접속 지원 (클라이언트당 최대 8명)

동작 방식

외부 플레이어 → MSPB 중앙 서버 → 클라이언트 → 로컬 MC 서버

1. 클라이언트가 중앙 서버에 TCP 연결
2. yamux 세션 생성 (단일 연결 내 멀티플렉싱)
3. 서버가 외부 접속용 포트를 자동 할당 (25500~25599)
4. 외부 플레이어가 할당된 포트로 접속
5. 서버가 첫 패킷을 분석하여 마인크래프트 프로토콜 검증
6. 검증 통과 시 클라이언트와 데이터 스트림 연결
7. 양방향 트래픽 포워딩 (외부 플레이어 ↔ 로컬 MC 서버)
8. 15초마다 하트비트 Ping/Pong 전송으로 연결 유지
9. 연결 종료 시 포트 자동 회수

시스템 요구사항

• 운영체제: Windows 10/11 (64-bit)
• 네트워크: 인터넷 연결
• 마인크래프트 서버: 로컬에서 실행 중인 서버

라이선스

Mozilla Public License 2.0 (MPL 2.0)