安装
选择与您的主机匹配的选项。所有路径都会提供相同的面板。
几分钟内即可运行
选择你的机器并粘贴命令。高级模式提供了运行面板的所有其他方式,命令已为你自己的文件夹和地址重写。
- 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 共享您的项目驱动器(设置 -> 资源 -> 文件共享),以便绑定挂载能够正常工作。
- Docker 镜像针对 Linux 主机;在 Windows 和 macOS 上,请从源码运行面板。

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