시놀로지 도커로 마인크래프트 포지 서버 열기 – DSM 6·모드 목록

시놀로지 NAS에서 마인크래프트 서버를 여는 가장 쉬운 방법은 도커에 itzg/minecraft-server 이미지를 받아서 컨테이너를 만드는 겁니다.

2024년 8월에 DSM 6 도커로 마인크래프트 1.20.1 포지(Forge) 서버를 열어서 친구들과 했는데, 그때 노션에 정리해 둔 과정과 모드 목록을 블로그로 옮겼습니다.

한눈에 보기

• 서버: 시놀로지 DSM 6(헤놀로지) 도커 + itzg/minecraft-server 이미지
• 버전: 마인크래프트 자바 에디션 1.20.1, 포지 47.3.0
• 핵심 설정: EULA=TRUE, TYPE=FORGE, VERSION=1.20.1, FORGE_VERSION=47.3.0, 포트 25565, /data 폴더 연결
• 외부 접속: 공유기에서 25565 포트 포워딩, 도메인 하나를 NAS로 연결
• 친구들 접속: 마인크래프트 런처 → 포지 설치 → 서버 추가 → 모드 파일 복사
• 모드: 편의성·최적화·콘텐츠·쉐이더까지 40개 넘게 넣었고, 8월 한 달 동안 다섯 번 업데이트

마인크래프트 서버를 NAS에서 돌린 이유

집에 있는 NAS는 인텔 NUC에 헤놀로지(Xpenology)를 올려서 쓰고 있습니다. (NAS로 옮긴 이유는 이 글에 적어 뒀습니다.) 블로그만 돌리기에는 남는 자원이 많아서, 친구들과 같이 놀 마인크래프트 서버를 하나 열어 봤습니다.

서버 사양은 이 정도였습니다.

항목	내용
CPU	인텔 i7
그래픽	AMD 라데온
메모리	16GB
회선	KT 1Gbps
운영	24시간 (가끔 점검)

친구들에게 보낸 서버 소개 글은 제가 받았던 스팸 문자를 패러디해서 “형님들 재미나게 놀 수 있는 놀이터 만들어 보려고 며칠 잠도 미루면서 개장 준비 했습니다” 같은 말투로 썼습니다.

시놀로지 DSM 6 도커로 마인크래프트 서버 만들기

DSM 6 기준 순서입니다. DSM 7.2부터는 Docker 패키지가 Container Manager로 바뀌었지만 설정 항목은 거의 같습니다.

1. 도커 설치와 이미지 받기

1. 패키지 센터에서 Docker를 설치합니다.
2. Docker → 레지스트리에서 itzg/minecraft-server를 검색해서 다운로드합니다.
3. 태그를 고르라고 나오면 java17을 고르는 게 좋습니다. 기본 태그는 최신 자바라서, 1.20.1 포지 모드 중에는 자바 17이 아니면 오류가 나는 것들이 있습니다.

2. 컨테이너 만들기

이미지 탭에서 받은 이미지를 고르고 실행 → 고급 설정으로 들어갑니다.

• 자동 재시작: 켭니다. NAS가 재부팅돼도 서버가 다시 올라옵니다.
• 볼륨: docker/minecraft 같은 폴더를 하나 만들어서 컨테이너의 /data에 연결합니다. 월드, 설정 파일, mods 폴더가 전부 여기에 생깁니다.
• 포트 설정: 로컬 포트 25565 → 컨테이너 포트 25565 (TCP)
• 환경 변수:

변수	값	설명
EULA	TRUE	마인크래프트 이용약관 동의. 없으면 서버가 안 켜집니다
TYPE	FORGE	포지 서버
VERSION	1.20.1	마인크래프트 버전
FORGE_VERSION	47.3.0	포지 버전
MEMORY	예: 6G	서버에 줄 메모리. NAS 메모리에 맞게 정합니다

컨테이너를 실행하면 처음 한 번은 포지 서버 파일을 내려받느라 시간이 좀 걸립니다. 로그에 Done이 뜨면 서버가 올라온 겁니다.

3. 서버 모드 넣기

서버용 모드 .jar 파일은 연결한 폴더의 mods 폴더에 넣고 컨테이너를 다시 시작하면 됩니다. 포지는 서버와 클라이언트 모드가 맞아야 접속되는 경우가 많아서, 아래 모드 목록에 (서버) / (클라이언트) / (둘 다)를 같이 적어 뒀습니다.

4. 외부에서 접속할 수 있게 하기

• 공유기 설정에서 TCP 25565 포트를 NAS 내부 IP로 포워딩합니다.
• 친구들이 IP 대신 주소로 들어올 수 있게 블로그 도메인의 서브도메인 하나를 NAS로 연결했습니다.
• DSM 방화벽을 쓰고 있다면 25565 포트를 열어 둡니다.

친구들 접속 방법 (클라이언트 설정)

친구들에게는 이렇게 안내했습니다. (윈도우 기준)

1. 마인크래프트 런처 설치

Microsoft Store에서 Minecraft Launcher를 설치하고 로그인합니다.

런처 왼쪽에서 Minecraft: Java Edition을 누르고, 최신 릴리스를 고른 뒤 플레이를 눌러 한 번 설치합니다.

2. 포지(Forge) 설치

포지 1.20.1 다운로드 페이지에서 47.3.0 설치 파일을 받습니다.

설치 파일을 더블클릭해서 Install client를 고르고 확인을 누릅니다.

런처를 다시 열면 실행 항목에 Forge가 생깁니다.

3. 서버 추가와 모드 넣기

1. 런처에서 Forge로 실행 → 멀티플레이 → 서버 추가에서 서버 이름은 마음대로, 서버 주소를 넣습니다.
2. 모드 파일(.jar)은 C:\Users\계정명\AppData\Roaming\.minecraft\mods에, 쉐이더 파일(.zip)은 같은 위치의 shaderpacks에 압축을 풀지 않고 그대로 넣습니다.
3. 모드를 넣기 전에는 접속해도 제대로 플레이가 안 되니, 꼭 모드부터 넣고 들어갑니다.

4. 쉐이더 켜기

게임 안에서 설정 → 비디오 설정 → 왼쪽 Oculus/셰이더 팩 설정을 누르고, 원하는 쉐이더를 골라 적용하면 끝입니다.

맥은 런처를 설치한 뒤 같은 포지 설치 파일로 하면 된다고는 했는데, 직접 해 보진 않았습니다.

모드 파일은 NAS File Station에 폴더를 하나 만들어서 친구들이 받아 가게 했습니다. 업데이트할 때는 버전별 폴더(V1.0.1, V1.0.3…)에 새로 추가된 모드만 따로 올려 뒀습니다.

넣었던 마인크래프트 모드 정리

편의성 모드

모드	적용	하는 일
AppleSkin	클라이언트	음식을 들면 회복되는 배고픔·체력 수치 표시
Jade	클라이언트	보고 있는 블록·몹 이름, 체력 같은 정보를 화면 위에 표시
Just Enough Items (JEI)	클라이언트	모든 아이템 제작법 표시
Just Enough Resources (JER)	클라이언트	JEI에 던전 전리품, 몹 드롭, 주민 거래, 광물 분포 추가
Mouse Tweaks	클라이언트	드래그로 같은 아이템만 줍기, Shift+드래그로 옮기기
Xaero’s World Map + Minimap	둘 다	미니맵과 전체 지도
Elytra Slot (+ Curios API, Caelus)	둘 다	흉갑과 겉날개를 같이 착용
Polymorph	둘 다	제작법이 겹칠 때 원하는 결과물 고르기
Traveler’s Backpack	둘 다	가방 아이템으로 인벤토리 늘리기
Legendary Tooltips	클라이언트	밋밋한 아이템 툴팁 꾸미기
CaramelChat	클라이언트	채팅에서 한글 입력이 꼬이지 않게 해 줌
Shulker Box Tooltip	클라이언트	셜커 상자를 열지 않고 내용물 확인
Double Doors	서버	붙어 있는 문 두 개가 같이 열림
Waystones	둘 다	웨이포인트로 순간이동
Carry On	둘 다	빈손으로 Shift+우클릭해서 상자를 통째로 들고 옮기기
GUI Clock	클라이언트	시계를 가지고 있으면 화면에 시간 표시

한글로 채팅한다면 CaramelChat이 특히 유용합니다. 마인크래프트 자바 에디션은 채팅에서 한글을 칠 때 글자가 꼬이는 문제가 있는데, 이 모드가 그걸 고쳐 줍니다.

재미·생활 모드

모드	적용	하는 일
Sound Physics Remastered	클라이언트	동굴 울림 같은 현실적인 소리
Presence Footsteps	클라이언트	밟는 블록에 따라 다른 발소리
Falling Leaves	클라이언트	나뭇잎이 떨어지는 효과
Blossom	클라이언트	나무 근처에 벌이 있으면 사과가 열림
Current Game Music Track	클라이언트	지금 나오는 배경음악 이름 표시
Cycle Paintings	서버	그림을 우클릭해서 다른 그림으로 바꾸기
Snowballs Freeze Mobs	서버	눈덩이를 맞은 몹이 잠깐 기절
Your Items Are Safe	서버	죽을 때 상자·갑옷 거치대가 있으면 아이템을 거기에 정리
Bottled Air	서버	물속에서 빈 병을 우클릭하면 산소 회복
Bottle Your Xp	서버	웅크리고 빈 병을 우클릭하면 경험치 병 (약간의 체력 소모)
Harvest with ease	서버	작물을 우클릭하면 수확하고 다시 심기
Companion	서버	반려동물 AI 개선
Torch Hit, Soul Fire’d	서버	횃불·영혼 불로 때리면 불 데미지
Fish On The Line	서버	물고기가 물면 소리로 알려 줌
Healing Campfire	서버	모닥불 근처에 있으면 체력 회복
Aquaculture 2	둘 다	물고기 종류 추가
Farmer’s Delight	둘 다	요리 레시피와 농사·요리 도구 추가
Aquaculture Delight	둘 다	생선 요리 레시피 추가
Charm of Undying	둘 다	불사의 토템을 목걸이로 걸기
Diagonal Fences · Windows · Walls	둘 다	울타리·유리·벽을 대각선으로 세우기

월드·구조물 모드

모드	적용	하는 일
ChoiceTheorem’s Overhauled Village	서버	지형·생물 군계별 새 마을 23개, 약탈자 전초기지 14개
Towns and Towers	서버	마을·전초기지·배 50여 종 추가

최적화 모드

모드	적용	하는 일
Clumps	둘 다	경험치 구슬을 뭉쳐서 렉 감소
Get It Together, Drops!	서버	떨어진 아이템 뭉치기 개선
Structure Essentials	서버	구조물 생성 오류·던전 상자 렉 개선
Saturn	둘 다	메모리 누수 수정
Embeddium	클라이언트	클라이언트 최적화

쉐이더

쉐이더를 쓰려면 Oculus 모드가 필요합니다. 쉐이더 팩은 취향대로 고르라고 Sildur’s Vibrant, BSL, Complementary Unbound, Bliss, Photon, Kappa를 넣어 뒀습니다.

모드 중에는 Collective, Cloth Config API, Puzzles Lib, Cobweb, Lithostitched, Cristel Lib처럼 다른 모드가 돌아가려면 같이 있어야 하는 라이브러리 모드도 있습니다. 모드 페이지에서 필요한 라이브러리(Dependencies)를 꼭 같이 받아야 합니다.

서버 운영하면서 있었던 일

• 8월 한 달에 업데이트 다섯 번: 8월 9일(V1.0.1, V1.0.2), 12일(V1.0.3), 13일(V1.0.4), 27일(V1.0.5)에 모드를 추가했습니다. 친구가 추천해 준 모드(Presence Footsteps, Carry On)도 같이 넣었습니다.
• 낙상 사고: 높은 곳에서 떨어지던 친구가 “이 서버에서는 비행이 허용되지 않습니다”라며 서버에서 튕기는 일이 있었습니다. 서버 설정 문제였다는 걸 확인하고 바로 고쳤습니다. 모드 서버에서 이 메시지가 뜨면 보통 server.properties의 allow-flight를 true로 바꾸면 됩니다. (itzg 이미지라면 환경 변수 ALLOW_FLIGHT=TRUE)
• NAS IP 차단: 친구 한 명이 모드 받으러 NAS에 로그인하다가 비밀번호를 여러 번 틀려서 DSM 자동 차단에 걸렸습니다. 제어판 → 보안 → 계정 → 자동 차단의 차단 목록에서 그 IP를 빼서 해결했습니다.
• 인게임 보이스 챗: Simple Voice Chat 모드도 넣을까 고민했습니다.

모드 공유용으로 친구들에게 NAS 계정을 만들어 줄 때는 꼭 읽기 전용 권한만 주고, 비밀번호는 길게, 자동 차단은 켜 두는 게 좋습니다. DSM 로그인 화면이 외부에 열리는 거라 보안에 신경 써야 합니다.

PC 말고 닌텐도 스위치로 마인크래프트를 즐긴다면 아래 타이틀도 있습니다. 스위치판은 베드락 에디션이라, 이 글에서 다룬 자바 에디션 포지 서버에는 접속할 수 없습니다.

자주 묻는 질문

시놀로지 NAS로 마인크래프트 서버를 돌릴 수 있나요?

네. 도커(DSM 7은 Container Manager)를 지원하는 모델이면 itzg/minecraft-server 이미지로 서버를 열 수 있습니다. 모드를 많이 넣으면 메모리를 많이 쓰니 NAS 메모리가 넉넉해야 합니다.

itzg 마인크래프트 서버에서 포지는 어떻게 설정하나요?

환경 변수에 TYPE=FORGE, VERSION=1.20.1, FORGE_VERSION=47.3.0처럼 넣으면 됩니다. EULA=TRUE도 꼭 넣어야 하고, 1.20.1 포지 모드에서 오류가 나면 이미지 태그를 java17로 바꿔 보세요.

모드는 서버와 클라이언트 둘 다 넣어야 하나요?

모드마다 다릅니다. 미니맵이나 쉐이더처럼 클라이언트에만 넣는 모드, 마을 추가처럼 서버에만 넣는 모드, 둘 다 넣어야 접속되는 모드가 있습니다. 위 표의 ‘적용’ 칸을 참고하세요.

마인크래프트 채팅에서 한글이 꼬여요.

CaramelChat 모드를 넣으면 해결됩니다. 자바 에디션에서 한글 입력이 꼬이는 문제를 고쳐 주는 모드입니다.

참고 자료: itzg/docker-minecraft-server (GitHub), Docker Minecraft Server 문서 – Forge, Synology NAS 도커로 마인크래프트 서버 구축하기 (나노콛), 마인크래프트 서버 만들기 (Y코더), 마인크래프트 서버 제작 후기 (서버포럼)