시놀로지 마인크래프트 모바일 서버 설치 (Nukkit)

🎮 가족이나 친구와 마인크래프트 PE를 함께 하고 싶으신가요?
시놀로지 NAS에 나만의 서버를 만들어보세요!

Nukkit으로 마인크래프트 PE 서버 구축하기

도커를 활용해 안정적인 서버를 만들어봅시다

🏗️

24시간 안정적인 서버

NAS가 켜져있는 동안 언제든지 접속할 수 있는 개인 서버를 운영할 수 있습니다

🎯

Docker로 간편하게

복잡한 설정 없이 Docker 컨테이너로 쉽게 설치하고 관리할 수 있습니다

🔧

플러그인으로 확장 가능

다양한 Nukkit 플러그인을 설치해 더 재미있는 서버를 만들 수 있습니다

💡 Nukkit이란?
Java로 구동되는 마인크래프트 PE(Pocket Edition) 서버입니다.
모바일 버전 마인크래프트를 위한 서버로, 안드로이드나 iOS에서 접속할 수 있어요!
1

필요한 패키지 설치하기

먼저 시놀로지 패키지 센터에서 필요한 프로그램들을 설치해야 합니다.

Docker

Docker

컨테이너로 서버를 실행하기 위해 필요합니다

Java 8

Java 8

Nukkit이 Java로 만들어져서 꼭 필요합니다

📍 설치 방법:
패키지 센터 → 검색창에 “Docker”와 “Java8” 검색 → 설치
2

마인크래프트 데이터 저장 폴더 만들기

서버를 껐다 켜도 맵이 사라지지 않도록 저장 폴더를 만들어야 합니다!

폴더 생성

File Station에서 원하는 위치에 폴더 생성

💡 추천 경로:
/volume1/docker/mcpe
다른 도커 컨테이너와 구분하기 쉽도록 docker 폴더 안에 만드는 것을 추천합니다!
3

폴더 권한 설정하기

Docker가 폴더에 접근할 수 있도록 권한을 설정해야 합니다.

⚠️ 중요: SSH 접속과 root 권한이 필요합니다!
모르시는 분은 시놀로지 나스 SSH로 접속하기 포스팅을 참고하세요.
Terminal

$ sudo -i

# root 권한 획득

# chmod -R 775 /volume1/docker/mcpe

# chown -R 여러분의NAS아이디:administrators /volume1/docker/mcpe

권한 설정

SSH에서 권한 설정 명령어 실행

4

Docker로 Nukkit 서버 설치하기

이제 본격적으로 서버를 설치해봅시다!

Docker Hub Nukkit

Docker Hub에서 ixilon/nukkit 이미지 확인

Terminal

# docker run -it -p 19132:19132/udp ixilon/nukkit

# 도커 이미지를 다운로드하고 컨테이너 실행

💡 명령어 설명:
run: 새 컨테이너 생성 및 실행
-it: 대화형 터미널 모드
-p 19132:19132/udp: 마인크래프트 PE 포트 연결
서버 실행

서버가 실행되고 언어 선택 화면이 나타납니다

5

컨테이너와 폴더 연결하기

서버 데이터가 저장되도록 폴더를 연결해야 합니다.

📍 순서:
1. 시놀로지 웹 → Docker 패키지 실행
2. 컨테이너 탭 → 생성된 컨테이너 정지
3. 편집 버튼 클릭
Docker 컨테이너

Docker에서 컨테이너 확인 및 편집

컨테이너 설정

자동 재시작 활성화 및 이름 변경

볼륨 마운트

볼륨 탭에서 폴더 추가: 로컬 경로 → /srv/nukkit

이제 컨테이너를 다시 시작하고, SSH에서 컨테이너에 접속합니다:

Terminal

# docker attach mcpe

# 실행 중인 컨테이너에 접속

Language: kor

# 한국어 선택

언어 선택

한국어로 서버 시작 완료!

6

플러그인 설치하기

서버를 더 재미있게 만들어줄 플러그인을 설치해봅시다!

🎮 EssentialsNK 플러그인
다양한 명령어를 추가해주는 필수 플러그인입니다.
다운로드 링크 →
플러그인 설치

다운받은 .jar 파일을 Plugins 폴더에 넣기

플러그인을 넣은 후 서버를 재시작하면 적용됩니다:

Terminal

# docker restart mcpe

# 서버 재시작

# docker attach mcpe

> help

# 추가된 명령어 확인

플러그인 적용

플러그인 적용 후 더 많은 명령어 사용 가능!

7

외부 접속을 위한 포트포워딩

집 밖에서도 접속할 수 있도록 공유기 설정을 해야 합니다.

🌐 포트포워딩 설정:
• 외부 포트: 19132 UDP
• 내부 포트: 19132 UDP
• 내부 IP: NAS의 IP 주소
📌 참고: 공유기마다 설정 방법이 다릅니다.
자세한 방법은 공유기 포트포워딩 하는 법을 참고하세요.
8

마인크래프트 PE에서 접속하기

이제 모든 준비가 끝났습니다! 서버에 접속해봅시다.

⚠️ Xbox 계정 필요!
마인크래프트 PE 멀티플레이를 위해서는 Xbox 계정이 필요합니다.
만 19세 미만은 미국 계정으로 만드는 것을 추천합니다.

서버 추가 방법

서버 추가

마인크래프트 PE에서 서버 추가 버튼 클릭

  • 서버 이름: 원하는 이름 (예: 우리집 서버)
  • 서버 주소: 외부 IP 또는 DDNS 주소
  • 포트: 19132
  • 서버 정보 입력

    서버 정보 입력 후 저장

    💡 외부 IP 확인 방법:
    네이버에서 “내 아이피”를 검색하면 바로 확인할 수 있습니다!
    서버 접속

    추가된 서버에 접속 성공!

    9

    접속 시 서버가 꺼지는 문제 해결

    Java 보안 설정 때문에 발생하는 문제를 해결해봅시다.

    Terminal

    # vi /volume1/@appstore/Java8/j2sdk-image/jre/lib/security/java.security

    # Java 보안 설정 파일 편집

    파일을 열어서 아래로 스크롤하다 보면 security.provider.9까지 있을 겁니다.

    Java 설정

    security.provider.10 추가하기

    추가할 내용

    security.provider.10=sun.security.ec.SunEC

    # 이 줄을 추가한 후 :wq로 저장하고 나가기

    💡 Vi 편집기 사용법:
    i: 편집 모드 진입
    ESC: 편집 모드 종료
    :wq: 저장하고 나가기

    🎉 서버 구축 완료!

    이제 친구들과 함께 마인크래프트 PE를 즐길 수 있습니다!
    더 많은 플러그인을 설치해서 나만의 특별한 서버를 만들어보세요.

    코멘트

    1. rx999

      잘설치해서 구동까지되는데 어째서인지 모든 몹스폰이 안됩니다 서바모드에 보통난이도에 서버명령어까지전부해봐도 안되네요…

      1. chelly

        저도 초보라서 잘 모르지만 익스텐션같은걸로 해결해보시는게 어떨까요?

      2. YEE

        https://nukkitx.com/resources/mobplugin.3/
        이거 사용하시면 됩니다

    2. 인간

      도커 안쓰고는 안되나요…

      1. chelly

        해볼수는 있져. 저는 근데 도커가 관리하기 편한거 같아서 도커로 했습니다. 잘못되면 지우기도 쉽고.

    3. 박상연

      설명해주시는데로 잘 설치해서 제대로 작동하는것까지 확인했습니다.
      추가로 질문 하나 더 부탁드리겠습니다.

      우리집 아이들이 pixelmon을 좋아하는데 nukkit 로 구동된 서버에은 pixelmon을 어떻게 설치 할수 있나요?
      mods 폴더에 pixelmon 파일을 올려도 아무런 변화가 없더군요,,,

      1. chelly

        제가 플러그인에 대해 잘 몰라서 거기까지는 ㅠ

      2. NOPE

        pixelmon 는 자바버전 즉, PC버전 마인크래프트에 모드중 하나입니다
        그래서 지금 Chelly님의 PE버전 서버로는 열수가 없습니다

      3. 익명

        만약 컴퓨터 마인크래프트가 되신다면 minecraft forge server 라는걸 이용하셔야 해요

    4. phantom

      어떻게 까나요?

    5. 손나훈

      마인크래프트 하겠습니다 서버 드러가게 해주세요

    6. u jpop78u

      u\][]-06r07-p
      704-7-=0-6]3-p7=-[[p]uj[p;yp54o7pop6o

    7. 9

      etr54
      \ro329829850[3259
      5095899po4i5op9q340
      0=59i095
      to35985i09349q9040p-940

    8. 익명

      이거 사진활용해도될까요도토리

      1. 네 활용하셔도 됩니다.

    9. 이 블로그에있는사진 활용하겠습니다

    10. 김형우

      덕분에 잘 설치 했습니다.
      그런데 버젼 업데이트는 어떻게 해야 할까요? ^^;;
      여기 저기 찾아보는데 잘 안 나오네요^^

    답글 남기기

    이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다