mirror/MCSManager
2
0
Fork 1
mirror of https://github.com/MCSManager/MCSManager.git synced 2024-11-21 03:12:10 +08:00
Code Issues Packages Projects Releases Wiki Activity
1,185 Commits 5 Branches 74 Tags 69 MiB
TypeScript 55.9%
Vue 40.8%
SCSS 2.2%
JavaScript 0.3%
HTML 0.3%
Other 0.5%
f39396e5ce
Go to file
Suwings f39396e5ce 新增 readme
2022-02-04 14:27:24 +08:00
.github 新增 readme 2022-02-04 14:27:24 +08:00
docs 发布 MCSM9 源代码 2022-02-02 13:36:08 +08:00
src 新增 直接 clone 运行报错 2022-02-04 13:31:11 +08:00
.eslintrc.js 发布 MCSM9 源代码 2022-02-02 13:36:08 +08:00
.gitignore 新增 文件忽略 2022-02-04 13:33:35 +08:00
.prettierignore 发布 MCSM9 源代码 2022-02-02 13:36:08 +08:00
.prettierrc.json 发布 MCSM9 源代码 2022-02-02 13:36:08 +08:00
app.js 新增 兼容旧版的启动方式 2022-02-04 13:41:59 +08:00
LICENSE 发布 MCSM9 源代码 2022-02-02 13:36:08 +08:00
package-lock.json 更新 版本号 2022-02-04 13:56:07 +08:00
package.json 更新 package.json 2022-02-04 13:52:33 +08:00
README.md 修改 统一格式 2022-02-02 19:40:53 +08:00
tsconfig.json 发布 MCSM9 源代码 2022-02-02 13:36:08 +08:00

README.md

MCSManager 图标.png

Status Status Status

官方网站 | 使用文档 | 团队主页 | 面板端项目 | 网页前端项目 | 守护进程项目


软件简介

分布式，稳定可靠，开箱即用，高扩展性，支持 Minecraft 和其他少数游戏的控制面板。

MCSManager 面板（简称：MCSM 面板）是一款全中文，轻量级，开箱即用，多实例和支持 Docker 的 Minecraft 服务端管理面板。

此软件在 Minecraft 和其他游戏社区内中已有一定的流行程度，它可以帮助你集中管理多个物理服务器，动态在任何主机上创建游戏服务端，并且提供安全可靠的多用户权限系统，可以很轻松的帮助你管理多个服务器。

截图.png


运行环境

控制面板可运行在 Windows 与 Linux 平台，无需数据库与任何系统配置，只需安装 node 环境即可快速运行，属于轻量级的 Minecraft 服务端控制面板。

必须 Node 14.17.0 以上，无需数据库和更改任何系统配置，开箱即可运行。


配置/数据文件

配置文件： data/SystemConfig/config.json

用户数据文件：data/User/*.json

远程守护进程配置：data/RemoteServiceConfig/*.json

面板默认访问账号：root 123456


软件使用文档

地址：https://docs.mcsmanager.com/

官方文档正在不断完善，里面的内容还有瑕疵，暂且仅供参考。


在 Windows 运行

对于 Windows 系统，已整合成直接运行版本，下载即可运行（使用管理员权限运行）:

前往：https://mcsmanager.com/


在 Linux 运行

一行命令快速安装

wget -qO- https://cdn.jsdelivr.net/gh/MCSManager/Script/setup.sh | bash
  • 脚本仅适用于 AMD64 架构 Ubuntu/Centos/Debian/Archlinux）
  • 执行完成后，使用 systemctl start mcsm-{web,daemon} 即可启动面板服务。
  • 面板代码与运行环境自动安装在 /opt/mcsmanager/ 目录下。

Linux 手动安装

  • 若一键安装不起作用，则可以尝试此步骤手动安装。
# 切换到安装目录，没有此目录请执行 mkdir /opt/
cd /opt/
# 下载运行环境（已有 Node 14+ 可忽略）
wget https://npm.taobao.org/mirrors/node/v14.17.6/node-v14.17.6-linux-x64.tar.gz
# 解压文件
tar -zxvf node-v14.17.6-linux-x64.tar.gz
# 链接程序到环境变量中
ln -s /opt/node-v14.17.6-linux-x64/bin/node /usr/bin/node
ln -s /opt/node-v14.17.6-linux-x64/bin/npm /usr/bin/npm

# 准备安装目录
mkdir /opt/mcsmanager/
cd /opt/mcsmanager/

# 下载面板端（Web）程序
git clone https://github.com/MCSManager/MCSManager-Web-Production.git
# 重命名文件夹并进入
mv MCSManager-Web-Production web
cd web
# 安装依赖库
npm install --registry=https://registry.npm.taobao.org

# 下载守护进程（Daemon）程序
git clone https://github.com/MCSManager/MCSManager-Daemon-Production.git
# 重命名文件夹并进入
mv MCSManager-Daemon-Production daemon
cd daemon
# 安装依赖库
npm install --registry=https://registry.npm.taobao.org


# 打开两个终端或两个 Screen 软件的终端窗口
# 先启动守护进程
cd /opt/mcsmanager/daemon
# 启动
node app.js

# 然后启动面板端进程
cd /opt/mcsmanager/web
# 启动
node app.js

# 访问 http://localhost:23333/ 即可进入面板。
# 默认情况下，面板端会自动扫描 daemon 文件夹并且自动连接到守护进程。
  • 注意，这种安装方式不会自动注册面板到系统服务（Service），所以必须使用 screen 软件来管理。

更新版本

如果您想从 8.X 版本更新到 9.X 版本，这是不支持的，只能手动一个个导入实例配置和文件。

如果您是 9.X 升级到更高版本，在 Linux 系统下，请分别前往 /opt/mcsmanager/web，/opt/mcsmanager/daemon 目录中执行 git pull 进行更新。

在 Windows 系统下更新请前往官方下载最新安装包，覆盖所有文件即可生效。

注意，建议更新前备份一次 data 目录。


搭建开发环境

本仓库源代码为 Node 运行时不可直接运行的 Typescript 代码，必须经过编译之后才可供直接使用。

程序需要还需要 UI，Daemon 另外两个项目才可开发预览和运行。

git clone https://github.com/MCSManager/MCSManager.git
npm install
npm run start

浏览器兼容性

  • 支持 Chrome Firefox Safari Opera 等现代主流浏览器。
  • 已放弃支持 IE 浏览器。

面板权限

控制面板在运行时会检测用户是否为空，若为空会自动创建一个默认的管理员账号。

如果您忘记了管理员账号，您只能备份现有的用户配置文件夹，并且重新生成一个新的管理员账号以覆盖。


问题报告

欢迎发现的任何问题进行反馈，必当及时修复。

若发现严重安全漏洞又不便公开发布，请发送邮件至: Suwings@outlook.com，安全问题修复后将在代码中附加漏洞发现者姓名。


版权约束

此开源项目使用 GPL 协议 作为开源协议，未经过官方闭源开发授权，您如果对代码有任何修改，则必须要公开您修改后的源代码，具体约束如下。

准许

  • 对软件源代码进行修改，复制，分发。
  • 利用软件进行商业使用，赚取利润。

必须

  • 公开提供您修改后的完整源代码。
  • 在代码文件、界面中保留版权声明。

禁止

  • 禁止售卖此软件，申请专利，著作权等。

更多授权与版权约束详情，请前往官方网站界面了解更多。