Synology NAS 에서 마인크래프트 베드락 서버 구축

이번 글은 제가 사용중인 NAS 인 Synology 사의 DS920+ 에서 마인크래프트 베드락 서버를 운용하는 방법에 대해 소개시켜 드릴까합니다. NAS 가 아니라도, Docker 패키지 설치 가능한 곳이라면 전부 적용 가능하구요.

설치에 앞서, 베드락 에디션 대해 가볍게 말씀드릴께요.

베드락 에디션(이하 BE)이란?

여러 플랫폼들에서 C++ 개발되던 에디션들, 데스크탑의 윈도우 10 에디션, 모바일의 포켓 에디션, 여러 콘솔 기기들의 콘솔 에디션들을 통합한 버전입니다. C++ 로 작성된 만큼 초기 버전인 자바 에디션 대비 최적화가 매우 좋다고 하며, 보다 자세한 내용은 위키 백과(여기)에 기술 되어 있습니다.

멀티 플랫폼 통합, 좋은 최적화... 좋네요. 몇년전 꽤 괜찮은 성능의 데스크탑에서 자바 에디션(이하 JE) 서버를 운용해본 적 있는데, 생각보다 리소스를 잡아먹었던 기억이 있습니다. 이번엔 별도 플러그인이나 모드 없이 바닐라 BE 서버를 운용할꺼라 당연히 리소스를 덜 소모하겠지만, 어느 정도일지 궁금하네요.

가족, 지인들과 데스크탑, 모바일, 플스 등 플랫폼 구분 없이 함께 즐기려는데 DS920+ 에서 잘 돌릴 수 있었으면 좋겠습니다. 설치 방법은 다음과 같습니다.

Docker 로 베드락 서버 설치 및 구동 하기

Synology 에서 제공하는 Docker 패키지는 Docker 관련된 기능들을 사용할 수 있는 별도의 UI 를 제공합니다만, CLI 를 사용하는게 편합니다. 따라서 설치는 CLI 로 진행할예정입니다.  CLI 로 다운 받은 이미지나 생성된 컨테이너들은 UI 로 작업한 것과 동일하며, 따라서 추후 UI 에서 관리할 수도 있습니다.

서버로 사용할 이미지는 Docker Hub 에서 minecraft, bedrock 등의 키워드로 검색 후 가장 별점이 높았던 이미지인 itzg/minecraft-bedrock-server 입니다.

다음은 이미지 다운부터, 컨테이너 생성 및 수행까지 한번에 수행하는 명령입니다. 또한 환경 변수로 BE 서버 설정값들을 전달해주고 있고, 이미지의 엔트리포인트 스크립트에 서버 구동까지 포함되어 있어, 설정한 서버 설정값대로 서버 구동까지 자동으로 수행됩니다.

여기서 수정이 필요하거나 가능한 옵션들은 빨간색 글씨로 표시했고, 아래 설명에 따라 목적에 맞게 수정 또는 삭제 해주시면 됩니다. 보기편하게 \ 으로 개행했고, 수행시에는 이대로 또는 \ 지우고 한줄로 수행하셔도 됩니다.

Docker 호스트(여기선 NAS)의 터미널에 접속한 후 다음과 같이 수행합니다. 단, 저와 같이 DS920+ 등의 Synology NAS 에서 수행하는 경우, sudo 로 root 권한 일시 획득이 아닌 root 계정으로 스위칭한 후 수행해야 DSM 의 Docker UI 에서도 생성된 컨테이너를 확인할 수 있습니다.

$ sudo su -
Password:
# docker run -d -it \
 -p 19132:19132/udp \
 -v /volume1/docker/minecraft_server:/data \
 -e EULA=TRUE \
 -e SERVER_NAME="이룸's 세상" \
 -e GAMEMODE=survival \
 -e DIFFICULTY=normal \
 -e LEVEL_TYPE=DEFAULT \
 -e ALLOW_CHEATS=false \
 -e VIEW_DISTANCE=24 \
 -e TICK_DISTANCE=8 \
 -e MAX_THREADS=0 \
 -e LEVEL_SEED=-27149278 \
 -e DEFAULT_PLAYER_PERMISSION_LEVEL=member \
 itzg/minecraft-bedrock-server

각 옵션별 의미는 다음과 같습니다.

• -p 19132:19132/udp - Docker 호스트(여기선 NAS)와 컨테이너간 포트 맵핑 설정. BE 서버는 19132 포트를 디폴트로 사용하므로(필요 시 변경은 가능함), 빨간색 필드의 값만 목적에 따라 수정. 마인크래프트 클라이언트에서 서버 접속 시 사용할 포트임.
• -v /volume1/docker/minecraft_server:/data - Docker 호스트(여기선 NAS)와 컨테이너 간 월드 등의 데이터 공유를 위한 볼륨 맵핑 설정. 컨테이너 내 /data 경로에 서버 프로그램과 월드가 저장되므로, 해당 경로와 맵핑될 Docker 호스트의 경로를 빨간색 필드의 값으로 설정. 이때, 존재하는 경로를 설정해야 함.
• -e {필드명}:{필드값} - 본 옵션들은 BE 서버의 server.properties 내의 설정 항목들에 대응하는 옵션들임. 위 명령의 설정값들은 예시이고, 목적에 따라 본 이미지의 매뉴얼(링크)을 참고하여 추가 및 변경.

명령 수행 후 컨테이너가 잘 구동되었는지 다음 명령으로 확인이 가능합니다. STATUS 컬럼의 값이 Up 인 경우 정상적으로 구동 중이라는 뜻입니다.

$ sudo docker ps
 CONTAINER ID        IMAGE                           COMMAND                  CREATED             STATUS                   PORTS                      NAMES
...
 999a451405f2        itzg/minecraft-bedrock-server   "/usr/local/bin/entr…"   6 minutes ago       Up 6 minutes (healthy)   0.0.0.0:19132->19132/udp   youthful_kepler
...

서버 커맨드 수행

특정 유저의 롤 변경(op 권한 부여 등) 같은 서버 명령을 수행하고 싶은 경우 docker attach 명령으로 컨테이너에 접속 후 수행하면 됩니다. 명령 중 빨간색 필드는 docker ps 로 확인한 컨테이너의 ID 또는 NAME 을 입력하면 되고, 구분만 된다면 각 값의 일부분만 입력하셔도 됩니다. 종료는 Ctrl + p, Ctrl + q 를 순서대로 눌러서 컨테이너를 detach 시키면 됩니다.

다음은 docker attach 로 서버 컨테이너에 접속하여 'help 1' 이라는 명령을 수행한 결과입니다.

$ sudo docker attach 999a451405f2
 DEBU[0585] Forwarding signal                             signal="window changed"
 DEBU[0585] Forwarding signal                             signal="window changed"
 help 1
 §2--- Showing help page 1 of 3 (/help ) ---
 /? [command: CommandName]
 /? 
 /deop 
 /gamerule
 /gamerule  [value: Boolean]
 /gamerule  [value: int]
 /help [command: CommandName]
 §2Tip: Use the  key while typing a command to auto-complete the command or its arguments
 …

서버 버전 업데이트

이번 글에서 사용하는 BE 서버 이미지(itzg/minecraft-bedrock-server)는 특정 서버 버전으로 운용할 수도 있지만(GitHub 의 매뉴얼 참조), 저처럼 바닐라 서버로만 운용하는 경우는 항상 최신 버전으로 운용하는게 일반적일꺼예요. 해당 이미지는 컨테이너 구동 시마다 매번 서버 업데이트를 시도하기 때문에, 다음 명령으로 컨테이너만 재구동 시켜주면 됩니다. 명령 중 빨간색 필드는 서버 컨테이너의 ID 또는 NAME 을 입력해주시면 됩니다.

$ sudo docker restart 999a451405f2

포트 포워딩 설정

대부분 아시겠지만 혹시몰라 내용 추가합니다. BE 서버를 구동중인 망 외부에서 접근하는 경우, 포트 포워딩 설정이 필요할 수 있습니다. 포트 포워딩 설정은 공유기마다 다르기에 자세히는 기술하지 않겠지만 설정되어야 하는 값은 다음과 같습니다.

• IP      : Docker 호스트(여기선 NAS)의 IP.
• 포트    : 서버 구동 시 설정했던 포트 옵션 중 빨간색 필드의 값으로 설정했던 포트를 지정.
• 프로토콜: UDP.

구동 확인

마인크래프트 클라이언트에서 확인해보면 잘 동작하는것을 알 수 있습니다.

성능 확인

운용중인 서버의 설정 중 성능에 많은 영향을 미치는 항목들은(VIEW, TICK_DISTANCE, MAX_THREADS) 전부 최고로 설정해둔 상태에서, 클라이언트 하나만 붙여서 DSM 에서 성능 측정을 해보았습니다. (제 DS920+ 의 상세 스펙은 아래 * Environment 참고 부탁드립니다.)

CPU 의 경우, 붙이기 전후의 IDLE 상태 비교 시 2~3% -> 16~20% 으로 약 15% 정도 상승했고, 메모리의 경우는 15% -> 16% 으로 약 1% 정도 상능했습니다.

측정 결과로 보면 이 서버 설정에서의 동시 접속 인원은 대여섯명 정도가 한계일 것 같습니다. 제 경우 동시 접속 인원은 많아야 세명이라 충분할 것 같습니다만... 생각보다는 적은 수치네요.

* Environment

- HW: DS920+ (Synology NAS)
   - CPU: Intel Celeron J4125
   - RAM: 12 GB

* References

- 위키 백과: 마인크래프트 베드락 에디션
- Docker Hub: itzg/minecraft-bedrock-server
- GitHib: itzg/docker-minecraft-bedrock-server