跳至内容
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

面板通过挂载的套接字驱动主机的 Docker 守护进程,这在主机上相当于 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 注意事项

来打个招呼

报告 Bug、提出功能建议、获得真人帮助,并展示你的服务器。