MCSManager 面板(简称:MCSM 面板),是一个快速部署,支持分布式架构,支持多用户,简单易用和现代化的 Minecraft 和 Steam 游戏服务器 Web 管理面板。
MCSManager 在 Minecraft 和 Steam 游戏社区内中已有一定的流行程度,它可以帮助你集中管理多个物理服务器,实现在任何主机上创建游戏服务器,并且提供安全可靠的多用户权限系统,可以很轻松的帮助你管理多个服务器,一直在为 Minecraft,Terraria 和 Steam 游戏服务器的管理员,运维人员和个人开发者提供健康的软件支持。
它同样也适合任何商业性质的行为,比如 IDC 服务商用于私服出售等,现已有多家中小型企业使用此面板作为管理&销售软件,并且支持多个国家的语言。
- 使用应用市场一键轻松部署
Minecraft或Steam游戏服务器。 - 兼容大部分
Steam游戏服务器,列如幻兽帕鲁,战术小队,僵尸毁灭工程和泰拉瑞亚等。 - 网页支持拖拽式的小卡片布局,打造自己喜欢的界面布局。
- 支持
Docker Hub上的所有镜像,支持多用户,支持商业化的实例出售服务。 - 支持分布式,一个网页即可同时管理数台机器。
- 技术栈简单,仅需擅长 Typescript 即可完成整个 MCSManager 开发!
- 更多...
控制面板可运行在 Windows 与 Linux 平台,无需安装数据库,只需安装 Node.js 环境和几个用于解压缩的命令。
必须使用 Node.js 16.20.2 以上,推荐使用最新版本 LTS 版本。
对于 Windows 系统,已整合成直接运行版本,下载即可运行:
压缩包:https://download.mcsmanager.com/mcsmanager_windows_release.zip
启动面板:
start.bat一行命令快速安装
sudo su -c "wget -qO- https://script.mcsmanager.com/setup_cn.sh | bash"安装后的使用方法
systemctl start mcsm-{web,daemon} # 开启面板
systemctl stop mcsm-{web,daemon} # 关闭面板- 脚本仅适用于 Ubuntu/Centos/Debian/Archlinux
- 面板代码与运行环境自动安装在
/opt/mcsmanager/目录下。
Linux 手动安装
- 若一键安装不起作用,则可以尝试此步骤手动安装。
# 切换到安装目录。如果不存在,请提前用'mkdir /opt/'创建它。
cd /opt/
# 下载运行时环境(Node.js)。如果你已经安装了Node.js 16+,请忽略此步骤。
wget https://nodejs.org/dist/v20.11.0/node-v20.11.0-linux-x64.tar.xz
# 解压档案
tar -xvf node-v20.11.0-linux-x64.tar.xz
# 添加程序到系统环境变量。
ln -s /opt/node-v20.11.0-linux-x64/bin/node /usr/bin/node
ln -s /opt/node-v20.11.0-linux-x64/bin/npm /usr/bin/npm
# 准备好安装目录。
mkdir /opt/mcsmanager/
cd /opt/mcsmanager/
# 下载MCSManager。
wget https://github.com/MCSManager/MCSManager/releases/latest/download/mcsmanager_linux_release.tar.gz
tar -zxf mcsmanager_linux_release.tar.gz
# 安装依赖库。
chmod 775 install.sh
./install.sh
# 请打开两个终端或screen。
# 先启动节点程序。
./start-daemon.sh
# 启动网络服务(在第二个终端或screen)。
./start-web.sh
# 访问 http://<公网 IP>:23333/ 查看面板。
# 一般来说,网络应用会自动扫描并连接到本地守护进程。这种安装方式不会自动注册面板到系统服务(Service),所以必须使用 screen 软件来管理,如果你希望由系统服务来接管 MCSManager,请参考文档。
# 首先安装 Node.js,如果你已经安装可以忽略这个步骤。
# Node.js 推荐安装最新 LTS 版本。
brew install node
node -v
npm -v
# 使用 curl 下载文件
curl -L https://github.com/MCSManager/MCSManager/releases/latest/download/mcsmanager_linux_release.tar.gz -o mcsmanager_linux_release.tar.gz
# 解压文件(与原命令相同)
tar -zxf mcsmanager_linux_release.tar.gz
cd mcsmanager
# 安装依赖库。
chmod 775 install.sh
./install.sh
# 请打开两个终端或screen。
# 先启动节点程序。
./start-daemon.sh
# 启动网络服务(在第二个终端或screen)。
./start-web.sh
# 访问 http://localhost:23333/ 查看面板。
# 一般来说,网络应用会自动扫描并连接到本地守护进程。-
贡献代码前必读:MCSManager#599
-
代码需要保持现有格式,不得格式化多余代码。
-
所有代码必须符合国际化标准。
此段落面向开发人员,如果你想对 MCSManager 二次开发,或者提交代码贡献,请务必仔细的阅读这些内容:
我们使用 Visual Studio Code 开发 MCSManager,你必须安装这些插件:
- i18n 文案显示支持(I18n Ally)
- 代码格式化(Prettier)
- Vue - Offcial
- ESLint
你需要前往 PTY 和 Zip-Tools 两个项目下载适用于你的系统的二进制文件,将他们存放到 daemon/lib 目录下(不存在就手动创建),以确保 仿真终端 和 文件解压缩 的正常工作。
git clone https://github.com/MCSManager/MCSManager.git
# MacOS
./install-dependents.sh
./npm-dev-macos.sh
# Windows
./install-dependents.bat
./npm-dev-windows.bat由于项目适配多国语言,所以代码中的所有 字符串,注释 都只接受英文,所以请勿直接硬文本非英语在代码中。
比如你可能写了一行新的字符串,需要适配多国语言。
import { $t } from "../i18n";
if (!checkName) {
const errorMsg = "Check Name Failed!" // 不要这样做!
const errorMsg = $t("TXT_CODE_MY_ERROR"); // 正确做法
}.<script lang="ts" setup>
import { t } from "@/lang/i18n";
// ...
</script>
<template>
<!-- ... -->
<a-menu-item key="toNodesPage" @click="toNodesPage()">
<FormOutlined />
{{ t("TXT_CODE_NODE_INFO") }}
</a-menu-item>
</template>请在语言文件中新增这一行,比如:languages/en_US.json
其中,en_US.json 是必须添加的,它是所有国家语言的源文案,其他国家的语言可以由我们使用 AI 来自动翻译。
{
//...
"TXT_CODE_MY_ERROR": "Check Name Failed!",
"TXT_CODE_NODE_INFO": "Jump to Node Page"
}如果你安装了 I18n Ally 插件,你的 $t("TXT_CODE_MY_ERROR") 应该会浮现英文文案。
如果翻译文案还需要携带参数,这可能会有点复杂,因为前端,后端所用的 i18n 库并非同一个,所以格式可能不太一样,你需要翻阅一下文件找到类似的代码便可知晓。
所有的翻译文案 Key,不可有重复,所以请可能的取一个较长的名字!
./build.bat # Windows
./build.sh # MacOS构建完成后,你会在 production-code 目录下找到生产环境代码。
- 支持
ChromeFirefoxSafariOpera等现代主流浏览器。 - 已放弃支持
IE浏览器。
欢迎发现的任何问题进行反馈,必当及时修复。
若发现严重安全漏洞又不便公开发布,请发送邮件至: support@mcsmanager.com,安全问题修复后将在代码中附加漏洞发现者姓名。
源代码遵循 Apache-2.0 协议。
Copyright ©2025 MCSManager.