Krak Server

6단계로 설정하기

Minecraft 서버가 실행되는 컴퓨터(VPS, 전용 서버 또는 집 PC)와 휴대폰이나 PC의 Krak Multiplayer가 필요해요. 컴퓨터에서는 명령 하나만 입력하고, 나머지는 모두 앱에서 해요.

1. 그 컴퓨터에서 평소처럼 Minecraft 서버를 시작하세요: Bedrock Dedicated Server, Java 서버, 또는 Geyser가 있는 Java.
2. 그 컴퓨터에서 관리자 권한으로 터미널을 여세요. Windows: 시작 버튼을 마우스 오른쪽 버튼으로 클릭하고 터미널(관리자) 또는 Windows PowerShell(관리자)을 고르세요. Linux: 터미널을 열거나 SSH로 접속하세요.
3. 아래에서 내 시스템용 설치 명령을 복사하고(복사 버튼) 터미널에 붙여 넣은 다음 Enter를 누르세요. Linux에서는 sudo가 물어보면 비밀번호를 입력하세요.
4. 1분 정도 기다리세요. 명령이 Krak Server를 다운로드하고, 확인하고, 설치한 다음 7Q4M-X2PA 같은 큰 페어링 코드와 링크를 보여 줘요. 거기서 더 입력할 건 없어요.
5. 휴대폰이나 PC에서 Krak Multiplayer를 열고 + 버튼을 탭한 다음 ‘원격 서버 호스트’를 탭하고 코드를 입력하세요(또는 링크를 여세요). 서버 이름을 확인하고 승인하세요.
6. 컴퓨터의 어떤 Minecraft 서버를 어떤 월드로 공유할지 고르고 저장하세요. 컴퓨터가 켜져 있는 동안 내 월드는 언제나 친구들에게 온라인으로 보여요.

Linux에 설치

이것을 터미널에 붙여 넣고 Enter를 누르세요(sudo가 비밀번호를 물어볼 수 있어요):

curl -fsSL https://krak-mp.cc/download/server/install.sh | sudo sh

스크립트가 내 프로세서에 맞는 빌드를 고르고, SHA-256을 확인하고, Krak Server를 시스템 서비스 krak-server로 설치해 시작한 다음 페어링 코드를 보여 줘요. 나중에 sudo krak-server status로 다시 볼 수 있어요. 직접 하려면: 다운로드 페이지에서 내 프로세서용 압축 파일을 받고, SHA-256을 비교하고, tar xzf로 풀고, sudo ./krak-server install을 실행하세요. 설치 프로그램을 다시 실행하면 Krak Server가 업데이트돼요.

Windows에 설치

관리자 권한으로 PowerShell을 열고(시작 버튼을 마우스 오른쪽 버튼으로 클릭, 터미널(관리자)) 이것을 붙여 넣은 다음 Enter를 누르세요:

irm https://krak-mp.cc/download/server/install.ps1 | iex

Windows와 함께 시작되고 오류가 나면 다시 시작되는 Windows 서비스 Krak Server를 설치하고, krak-server.exe를 PATH에 추가하고, 페어링 코드를 보여 줘요. 나중에 새 관리자 터미널에서 krak-server.exe status를 실행하면 다시 볼 수 있어요. 프로그램은 C:\Program Files\Krak Server에 있어요.

설치하지 않고 먼저 써 보려면: zip을 다운로드해서 풀고 콘솔에서 krak-server.exe를 실행하세요. 닫을 때까지 페어링하고 호스트해요.

무엇을 하나요

Krak Server는 비밀번호가 아니라 페어링 코드로 로그인해요. 같은 컴퓨터의 Bedrock과 Java 서버를 찾고, 앱에서 고른 서버를 Krak 월드로 공유해요. 플레이어는 다른 월드처럼 Krak Multiplayer에서 참여하고, 서버는 Minecraft 자체의 LAN 목록에 나타나요.

게임 트래픽은 Krak의 릴레이를 거쳐요. 플레이어는 서버의 IP 주소를 볼 수 없고, 서버도 플레이어의 주소를 볼 수 없어요. Krak Server는 포트를 열지 않고 포트 포워딩도 필요 없어요. krak-mp.cc로 나가는 연결만 해요.

서버는 앱에서 관리해요: +를 탭한 다음 ‘원격 서버 호스트’를 탭하거나, 내 서버가 표시되는 내 월드를 여세요. 거기서 호스트할 것을 고르고, 시작하고 멈추고, 플레이어, 참여 요청, 내보내기와 밴, 서버 상태를 볼 수 있어요. 그 화면에는 ‘원격 제어’라고 표시되어서 내 기기에서 호스트하는 것과 헷갈리지 않아요.

필요한 것

1. x86_64 또는 ARM64의 Linux(항상 실행되는 서비스에는 systemd), 또는 x64의 Windows 10, 11, Server 2019 이상.
2. 같은 컴퓨터의 Bedrock Dedicated Server, Java 서버(Paper, Fabric 등) 또는 Geyser가 있는 Java 서버.
3. 이메일이 인증되었거나 Google 로그인을 쓰는 Krak Multiplayer 계정, 그리고 서버를 페어링하고 관리할 앱 0.8.5 이상(+ 버튼은 0.8.6부터).
4. 디스크 약 15 MB, 메모리 약 40 MB. 게임 서버 옆에서 Krak Server는 CPU를 아주 조금만 써요.

내 계정과 페어링

1. 설치 명령이 끝날 때 페어링 코드가 표시돼요. 나중에 보거나 코드가 만료되었다면 컴퓨터에서 sudo krak-server status를 실행하세요(Windows에서는: 관리자 터미널에서 krak-server.exe status).
2. Krak Multiplayer에서 +를 탭한 다음 ‘원격 서버 호스트’를 탭하고 코드를 입력하거나, 휴대폰에서 링크를 여세요. 앱 0.8.5에서는: 프로필, 내 서버, 서버 추가.
3. 서버의 이름, 시스템, 네트워크를 확인한 다음 승인하세요. 코드는 10분 동안 유효하고, 그 뒤에는 서버가 새 코드를 보여 줘요.

내가 관리하는 서버에 표시된 코드만 승인하세요. 코드를 달라고 하는 사람은 내 이름으로 호스트하려는 거예요.

호스트할 것 고르기

서버를 열고(내 월드에서, 또는 +에서 ‘원격 서버 호스트’) ‘이 서버에서 호스트’를 탭하세요. 컴퓨터에서 찾은 서버를 고른 다음 내 로컬 월드 하나나 새 월드를 고르세요. 이름, 설명, 아이콘, 접근 권한 등 월드 설정은 평소처럼 앱에서 편집해요.

계정 하나는 Krak Plus가 있든 없든 한 번에 한 월드만 호스트해요: 휴대폰이나 PC의 월드, 앱으로 호스트하는 서버, Krak Server의 월드 중 하나예요. 크로스플레이 서버(Geyser가 있는 Paper)는 두 에디션이 함께하는 월드 하나예요. 서버는 최대 2대(Krak Plus로는 7대)까지 페어링하고 각각 월드를 둘 수 있어요. 지금 원하는 것의 호스트를 켜세요. Krak Plus가 있으면 같은 서버가 아닌 한 그동안 외부 서버를 계속 등록해 둘 수 있어요.

참여 승인은 동작하지만 요청은 2분 후 만료돼요. 내가 자는 동안에도 실행되는 서버라면 승인을 끄고 월드의 접근 설정과 밴을 대신 사용하세요.

Bedrock Dedicated Server 설정

Krak 플레이어는 LAN 목록으로 참여하므로 서버가 LAN 플레이어를 받아들여야 해요. server.properties에서 다음과 같이 설정하세요:

enable-lan-visibility=true
online-mode=false
allow-list=false

online-mode=false로 하면 서버가 Xbox 로그인을 확인하지 않아요. 서버 자체의 포트도 인터넷에 열려 있으면, 직접 접속한 플레이어가 어떤 이름으로든(관리자 이름으로도) 참여할 수 있어요. Bedrock 포트는 인터넷에 닫아 두거나, 확인되지 않은 직접 접속 플레이어를 받아들이세요.

LAN에 표시될 수 있는 Bedrock 서버는 컴퓨터 한 대에 하나뿐이에요(UDP 포트 7551을 써요). Minecraft 1.26.52 이상은 그 방법으로만 Krak 플레이어를 들여보내서, 같은 컴퓨터의 두 번째 Bedrock 서버는 공유할 수 없어요. Krak Server는 그 서버를 호스트하지 않고 앱이 이유를 알려 줘요. 다른 서버를 멈추거나 두 번째 서버에서 RakNet을 켜세요. 이 설정을 바꾼 뒤에는 서버를 재시작하세요.

Java 서버

Java 서버에는 특별한 설정이 필요 없어요. Krak Server가 같은 컴퓨터의 서버 포트에 연결해요. online-mode 서버에서는 플레이어에게 평소처럼 Minecraft: Java Edition이 필요해요.

Geyser: Java 서버의 Bedrock 플레이어

Paper, Spigot 또는 프록시의 Geyser에서는 Bedrock 플레이어가 Geyser의 Bedrock 포트로 들어오고, Krak Server는 그 포트를 Bedrock 서버처럼 공유해요. 기본 설정의 Geyser는 Krak으로 오는 모든 Bedrock 플레이어를 돌려보내요. 플레이어에게는 ‘Please log into Xbox’가 보이는데, LAN 게임으로 참여해서 Geyser가 기대하는 Xbox 로그인 확인이 없기 때문이에요. Krak Server는 이 거부를 볼 수 없어서 앱이 알려 줄 수도 없어요. Geyser의 config.yml(Paper와 Spigot에서는 plugins/Geyser-Spigot/config.yml)에서 다음과 같이 설정하세요:

validate-bedrock-login: false

그다음 서버를 재시작하세요. Geyser가 더 이상 Bedrock 플레이어의 Xbox 로그인을 확인하지 않으니, Bedrock 포트(기본값 19132)는 인터넷에 닫아 두세요. 그렇지 않으면 직접 접속한 플레이어가 어떤 Bedrock 이름으로든 참여할 수 있어요. Krak에는 열린 포트가 필요 없어요.

Java 플레이어는 영향을 받지 않고, Java 서버는 online-mode=true를 유지해도 돼요. Floodgate가 있으면 Bedrock 플레이어가 Java 계정 없이 참여해요. Floodgate가 없으면 Geyser가 모든 Bedrock 플레이어에게 Java 계정으로 로그인하라고 해요.

Krak은 RakNet으로 Geyser에 연결해요. Minecraft 26.60부터 RakNet 참여가 끝날 예정이라, Geyser가 26.60을 지원할 때까지 26.60의 Bedrock 플레이어는 Krak으로 들어오지 못할 수 있어요.

Docker

호스트에 설치한 Krak Server가 LAN 검색과 포트를 볼 수 있도록 게임 서버 컨테이너를 호스트 네트워크(--network host)로 실행하세요.

설정

Krak Server는 Linux에서는 /etc/krak-server/config.json을, Windows에서는 %ProgramData%\Krak Server\config.json을 읽어요. 모든 키는 선택 사항이고 알 수 없는 키는 거부돼요. krak-server config check로 파일을 확인하고, 바꾼 뒤에는 서비스를 재시작하세요.

name

앱에 표시되는 이름. 기본값: 컴퓨터의 호스트 이름.

allow

앱이 공유할 수 있는 포트: bedrockPorts와 javaPorts. 기본값: 일반적인 범위(Bedrock 19132~19140, Java 25565~25570). 다른 포트의 서버는 컴퓨터에서 직접 여기에 그 포트를 추가해야만 공유돼요.

updates

mode: auto(기본값), notify 또는 off. window: 자동 업데이트가 Krak Server를 재시작할 수 있는 현지 시간(기본값 04:00-06:00).

relay

preferred: 항상 쓸 릴레이. null이면 가장 좋은 것을 골라요.

publicAddress

월드의 공개 주소를 켤 때 앱이 제안하는 주소.

logLevel, logFormat

debug, info, warn 또는 error. text 또는 json.

limits

memoryMB: Krak Server의 메모리 한도(기본값 128).

업데이트

Krak Server는 6시간마다 서명된 업데이트를 확인하고 직접 설치해요. 업데이트 시간대에, 또는 아무도 플레이하지 않거나 필수 업데이트일 때는 바로 설치해요. 호스팅 중인 월드는 다시 시작되고 플레이어는 LAN 목록에서 다시 참여해요. 앱에서 ‘지금 업데이트’를 누르면 업데이트를 바로 설치해요.

Linux에서는 서비스가 다시 시작할 때 몇 초 만에 업데이트를 설치해요. Windows에서는 예약된 작업 Krak Server\Apply update가 15분 안에 설치해요. 이 작업은 SYSTEM으로 실행되어 서비스를 멈추고 프로그램을 바꾼 뒤 다시 시작하고, 새 버전이 실행되는지 확인해요. 새 버전이 시작되지 않으면 이전 버전으로 돌아가요. krak-server status에서 기다리는 업데이트와 작업이 마지막으로 실행된 시간을 볼 수 있어요.

Linux에서 업데이트를 바로 설치하려면:

sudo krak-server update

Windows에서는 관리자 권한 PowerShell에서(전체 경로를 쓰면 어느 창에서나 돼요):

& "C:\Program Files\Krak Server\krak-server.exe" update

설치 명령을 다시 실행해도 Krak Server가 업데이트돼요. 페어링과 설정은 그대로 두고 Windows 업데이트 작업도 다시 만들어요. 예를 들어 --no-auto-update로 설치한 뒤에 쓰면 돼요.

상태와 로그

krak-server status는 서버가 페어링된 계정, 대기 중인 페어링 코드, 연결 상태, 호스트 중인 각 월드와 플레이어를 보여 줘요. Linux에서는 로그가 저널에 있어요:

sudo krak-server status
journalctl -u krak-server -f

Windows에서는 %ProgramData%\Krak Server\logs에 있어요. 로그에는 토큰, 키, 플레이어의 주소가 절대 들어가지 않아요.

서버 삭제

앱에서: 서버(내 월드)를 열고 메뉴에서 ‘서버 삭제’. 서버는 즉시 호스트를 중지하고 다시 로그인할 수 없어요. 그 뒤 이 계정이나 다른 계정용으로 서버가 알아서 새 페어링 코드를 보여 줘요.

컴퓨터에서: sudo krak-server unpair로 페어링을 해제하고, sudo krak-server uninstall로 서비스를 삭제해요. --purge를 붙이면 설정과 데이터도 삭제돼요.

비밀번호를 바꾸거나 재설정하거나, 모든 곳에서 로그아웃하거나, 밴되면 계정의 모든 서버도 로그아웃돼요.