安裝
選擇符合您主機的選項。所有路徑都會提供相同的面板。
幾分鐘內即可上線
選擇您的機器並貼上指令。進階模式提供其他所有運行面板的方式,指令會針對您自己的資料夾和位址進行重寫。
- 1
運行安裝程式
適用於任何具有 64 位元作業系統的 Linux 機器,從 VPS 到 Raspberry Pi 4 或 5。它會安裝 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
下載 compose 檔案並指向該資料夾
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
從 compose 檔案新增堆疊
將 compose 檔案的內容貼到新的堆疊中。原始檔案在此處:
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.1僅監聽 127.0.0.1,用於在前方使用 TLS 的反向代理。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+
- 幾 GB 的磁碟空間用於存放伺服器映像檔和世界。
Windows 注意事項
- 在啟動或建立伺服器之前,必須執行 Docker Desktop。
- 與 Docker Desktop 共用您的專案磁碟機 (設定、資源、檔案共用),以便 bind mounts 能正常運作。
- Docker 映像檔以 Linux 主機為目標;在 Windows 和 macOS 上,請從原始碼執行面板。

來打個招呼
回報錯誤、建議功能、尋求真人協助,並展示您的伺服器。
