설치
호스트에 맞는 옵션을 선택하세요. 모든 경로는 동일한 패널을 제공합니다.
몇 분 안에 실행
머신을 선택하고 명령어를 붙여넣으세요. 고급 설정에는 패널을 실행하는 다른 모든 방법이 포함되어 있으며, 명령어는 자신만의 폴더와 주소에 맞게 다시 작성됩니다.
- 1
설치 프로그램 실행
VPS부터 Raspberry Pi 4 또는 5까지 64비트 OS가 설치된 모든 Linux 머신에서 작동합니다. Docker가 누락된 경우 설치하고, 패널을 /opt/msm에 설정하고 시작합니다. 나중에 다시 실행하여 업그레이드할 수 있습니다.
curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash - 2
패널 열기
설치 프로그램이 주소와 일회용 설정 PIN을 출력합니다. 브라우저에서 주소를 열고 PIN을 입력한 다음 관리자 계정을 만드세요.
http://your-server-ip:25564
- 1
Docker Desktop, Node.js, Git 및 pnpm 설치
PowerShell에서 각 줄마다 한 번씩 실행합니다. 설치가 완료되면 Docker Desktop을 시작하고 계속 실행하세요.
winget install Docker.DockerDesktop winget install OpenJS.NodeJS.LTS winget install Git.Git winget install pnpm.pnpm - 2
패널 가져오기 및 시작
방금 설치한 도구를 찾을 수 있도록 새 터미널을 엽니다.
git clone https://github.com/anefzaoui/minecraft-server-manager.git cd minecraft-server-manager pnpm install pnpm start - 3
패널 열기
첫 실행 시 시스템 확인, 시간대, 관리자 계정 생성 과정을 안내합니다.
http://localhost:25564
- 1
Docker Desktop, Node.js, Git 및 pnpm 설치
Homebrew를 사용합니다. 설치가 완료되면 Docker Desktop을 시작하고 계속 실행하세요.
brew install --cask docker-desktop brew install node git pnpm - 2
패널 가져오기 및 시작
설치 단계에서 패널도 빌드됩니다. 컴파일할 것이 없습니다.
git clone https://github.com/anefzaoui/minecraft-server-manager.git cd minecraft-server-manager pnpm install pnpm start - 3
패널 열기
첫 실행 시 시스템 확인, 시간대, 관리자 계정 생성 과정을 안내합니다.
http://localhost:25564
두 필드를 채우면 아래의 모든 명령어가 머신에 맞게 다시 작성됩니다.
- 1
데이터 폴더 생성
하나의 폴더에 패널 소유의 모든 것이 저장됩니다.
mkdir -p {{dataDir}} - 2
컴포즈 파일 다운로드 및 해당 폴더로 연결
DATA_DIR_HOST는 Docker가 호스트의 관점에서 마운트하므로 호스트의 절대 경로여야 합니다.
curl -fsSLO https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/docker-compose.yml echo "DATA_DIR_HOST={{dataDir}}" > .env - 3
패널 시작
이미지는 멀티 아키텍처(amd64 및 arm64)이며 모든 릴리스에서 업데이트됩니다.
docker compose up -d 그런 다음 패널 열기
http://{{host}}:25564첫 실행 시 시스템 확인, 시간대, 관리자 계정 생성 과정을 안내합니다.
- 1
호스트에 데이터 폴더 생성
동일한 폴더 규칙: 절대 경로, Docker가 실행되는 머신에 있어야 합니다.
mkdir -p {{dataDir}} - 2
컴포즈 파일에서 스택 추가
컴포즈 파일의 내용을 새 스택에 붙여넣습니다. 원본 파일은 여기에 있습니다:
https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/docker-compose.yml - 3
환경 변수 설정 및 배포
스택의 환경 섹션에 추가한 다음 배포합니다.
DATA_DIR_HOST={{dataDir}} 그런 다음 패널 열기
http://{{host}}:25564첫 실행 시 시스템 확인, 시간대, 관리자 계정 생성 과정을 안내합니다.
- 1
요구 사항 확인
Node.js 24 이상, pnpm, Docker 실행 중(Windows 및 macOS의 경우 Docker Desktop).
node --version # 24 or newer docker info # daemon reachable - 2
클론 및 설치
설치 단계에서 패널의 CSS도 빌드됩니다. 컴파일할 네이티브 모듈이 없습니다.
git clone https://github.com/anefzaoui/minecraft-server-manager.git cd minecraft-server-manager pnpm install - 3
패널 시작
기본적으로 localhost만 수신 대기합니다. 네트워크의 다른 머신에서 액세스하려면 PANEL_HOST=0.0.0.0을 설정하세요.
pnpm start 그런 다음 패널 열기
http://localhost:25564첫 실행 시 시스템 확인, 시간대, 관리자 계정 생성 과정을 안내합니다.
- 1
소스 설치에서 시작
클론된 폴더에서 실행합니다. PM2는 데몬을 시작한 Node 버전을 사용하여 앱을 실행하므로 인터프리터를 고정해야 합니다.
pm2 start src/server.js --name minecraft-server-manager --interpreter "$(nvm which 24)" - 2
프로세스 목록 저장 및 시작 활성화
pm2 startup은 sudo와 함께 실행할 명령어를 출력합니다. 한 번 실행하세요.
pm2 save pm2 startup - 3
systemd를 선호하시나요?
클론된 폴더에서 node src/server.js를 실행하고 WorkingDirectory를 설정한 유닛은 동일하게 작동합니다. 패널은 추가 플래그가 필요하지 않습니다.
그런 다음 패널 열기
http://{{host}}:25564첫 실행 시 시스템 확인, 시간대, 관리자 계정 생성 과정을 안내합니다.
옵션 1: Docker
설치 옵션
Linux 설치 프로그램은 bash -s -- 뒤에 옵션을 받으므로 파이프를 통해서도 작동합니다. 동일한 옵션으로 다시 실행하여 업그레이드하세요. 데이터 폴더, .env 및 compose 편집 내용은 유지됩니다.
--port 8080다른 포트에서 패널을 제공합니다.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --port 8080--bind 127.0.0.1TLS가 앞에 있는 리버스 프록시를 위해 127.0.0.1에서만 수신 대기합니다.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --bind 127.0.0.1--tag v0.14.1최신 릴리스를 따르는 대신 특정 릴리스를 고정합니다.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --tag v0.14.1--dir /srv/msm/opt/msm이 아닌 다른 곳에 설치합니다.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --dir /srv/msm--uninstall --yes패널을 제거하고 데이터를 유지합니다. 파이프를 통해 답변할 키보드가 없으므로 --yes를 추가하세요. 데이터 폴더를 삭제하려면 --purge도 추가하세요.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --uninstall --yes--help모든 옵션과 기본값.curl -fsSL https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/deploy/install.sh | sudo bash -s -- --help
요구 사항
- Docker Engine (Linux) 또는 Docker Desktop (Windows, macOS).
- Docker
- Linux
Windows- macOS
- 소스에서 설치하려면 Node.js 24 이상이 필요합니다. Docker 이미지는 자체적으로 포함합니다.
- Node.js 24+
- 서버 이미지와 월드를 위한 몇 기가바이트의 디스크 공간.
Windows 참고 사항
- Docker Desktop은 서버를 시작하거나 생성하기 전에 실행되어야 합니다.
- 바인드 마운트(bind mount)가 작동하도록 프로젝트 드라이브를 Docker Desktop과 공유하세요 (설정, 리소스, 파일 공유).
- Docker 이미지는 Linux 호스트를 대상으로 합니다. Windows 및 macOS에서는 소스에서 패널을 실행하세요.

인사하러 오세요
버그를 신고하고, 기능을 제안하고, 실제 사용자에게 도움을 받고, 서버를 자랑하세요.
