跳至內容
MSM

安裝

選擇符合您主機的選項。所有路徑都會提供相同的面板。

幾分鐘內即可上線

選擇您的機器並貼上指令。進階模式提供其他所有運行面板的方式,指令會針對您自己的資料夾和位址進行重寫。

  1. 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. 2

    開啟面板

    安裝程式會印出位址和一次性的設定 PIN 碼。在瀏覽器中開啟該位址,輸入 PIN 碼,然後建立您的管理員帳戶。

    http://your-server-ip:25564
  1. 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. 2

    取得面板並啟動它

    開啟一個新的終端機,以便它能找到您剛安裝的工具。

    git clone https://github.com/anefzaoui/minecraft-server-manager.git
    cd minecraft-server-manager
    pnpm install
    pnpm start
  3. 3

    開啟面板

    首次運行會引導您完成系統檢查、時區設定,以及建立管理員帳戶。

    http://localhost:25564
  1. 1

    安裝 Docker Desktop、Node.js、Git 和 pnpm

    使用 Homebrew。安裝完成後啟動 Docker Desktop 並保持運行。

    brew install --cask docker-desktop
    brew install node git pnpm
  2. 2

    取得面板並啟動它

    安裝步驟也會建置面板。無需編譯任何原生模組。

    git clone https://github.com/anefzaoui/minecraft-server-manager.git
    cd minecraft-server-manager
    pnpm install
    pnpm start
  3. 3

    開啟面板

    首次運行會引導您完成系統檢查、時區設定,以及建立管理員帳戶。

    http://localhost:25564

填寫兩個欄位,下方所有指令都會針對您的機器進行重寫。

  1. 1

    建立資料夾

    一個資料夾包含面板擁有的所有內容。

    mkdir -p {{dataDir}}
  2. 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. 3

    啟動面板

    該映像檔是多架構的(amd64 和 arm64),並在每次發佈時更新。

    docker compose up -d
  4. 然後開啟面板

    http://{{host}}:25564

    首次運行會引導您完成系統檢查、時區設定,以及建立管理員帳戶。

  1. 1

    在主機上建立資料夾

    相同的資料夾規則:絕對路徑,位於運行 Docker 的機器上。

    mkdir -p {{dataDir}}
  2. 2

    從 compose 檔案新增堆疊

    將 compose 檔案的內容貼到新的堆疊中。原始檔案在此處:

    https://raw.githubusercontent.com/anefzaoui/minecraft-server-manager/main/docker-compose.yml
  3. 3

    設定環境變數並部署

    在堆疊的環境區段中新增它,然後部署。

    DATA_DIR_HOST={{dataDir}}
  4. 然後開啟面板

    http://{{host}}:25564

    首次運行會引導您完成系統檢查、時區設定,以及建立管理員帳戶。

  1. 1

    檢查需求

    Node.js 24 或更新版本、pnpm,以及運行的 Docker(Windows 和 macOS 上的 Docker Desktop)。

    node --version   # 24 or newer
    docker info      # daemon reachable
  2. 2

    複製並安裝

    安裝步驟也會建置面板的 CSS。無需編譯任何原生模組。

    git clone https://github.com/anefzaoui/minecraft-server-manager.git
    cd minecraft-server-manager
    pnpm install
  3. 3

    啟動面板

    預設情況下,它只監聽 localhost。設定 PANEL_HOST=0.0.0.0 以便從您網路上的其他機器存取。

    pnpm start
  4. 然後開啟面板

    http://localhost:25564

    首次運行會引導您完成系統檢查、時區設定,以及建立管理員帳戶。

  1. 1

    從原始碼安裝啟動

    從複製的資料夾中運行此指令。PM2 會使用啟動其守護程式的 Node 版本來啟動應用程式,因此請固定解釋器。

    pm2 start src/server.js --name minecraft-server-manager --interpreter "$(nvm which 24)"
  2. 2

    儲存程序列表並啟用啟動

    pm2 startup 會印出一個需要用 sudo 運行的指令;請運行一次。

    pm2 save
    pm2 startup
  3. 3

    偏好 systemd?

    一個從複製的資料夾運行 node src/server.js 並設定 WorkingDirectory 的單元,其運作方式相同。面板不需要額外的旗標。

  4. 然後開啟面板

    http://{{host}}:25564

    首次運行會引導您完成系統檢查、時區設定,以及建立管理員帳戶。

選項 1:Docker

面板透過掛載的 socket 驅動主機的 Docker daemon,這在主機上相當於 root 權限。請妥善處理管理員登入,切勿將面板直接暴露於網際網路。

下載 docker-compose.yml閱讀入門指南

安裝程式選項

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

需求

Windows 注意事項

來打個招呼

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