Skip to content

h5mcbox/MCSManager-plus-Worker

Repository files navigation

doc_logo.png

Status Status

一套简单,易用,多实例,轻量级,分布式的 Minecraft Server 控制面板 ,基于MCSManager 8 修改而来

注意:这是Worker项目,还需搭配Backend端方可运行

中文简体 | 中文繁體 | API 文档 | 二次开发参考文档

简介

这是一款可以管理多个 Minecraft 服务端(支持群组端)的 Web 管理面板,并且可以分配多个子账号来分别管理不同的 Minecraft 服务端,支持绝大部分主流的服务端,甚至是其他非 Minecraft 的程序。

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

main_theme.png


运行环境

推荐 Node 14 以上,无需数据库和更改任何系统配置,开箱即可运行。


配置文件

配置文件是程序目录下的 property.js 文件,它会在你第一次运行的时候,自动生成。

此文件不会与 github 版本冲突,git pull 更新时也不会自动覆盖。


常见问题

问题 详情
无法正常安装面板? 参考教程
Linux 下面板如何后台运行? 参考方法
使用面板开启 Bedrock Server 参考教程
面板管理员的默认账号和密码是什么? 账号 #master 密码会随机生成并显示在屏幕上(仅当#master密码不可用时)
面板如何正确关闭? Ctrl+C
配置文件是什么? property.js 文件
如何修改面板默认端口? property.js 文件
如何配置反向代理? Apache 配置参考教程
配好反向代理却无法使用? Apache Nginx 宝塔上的Nginx
反代后文件管理偶尔失效? 请检查反代机器的防火墙是否拦截
我能修改登录页面吗? 修改教程
其他常见问题 查看 Wiki
关于HTTP跳转HTTPS的帮助 查看 Nginx 301永久重定向 范例

在 Windows 运行

对于 Windows 系统,你可以直接运行:node app.js来开启面板


Linux 发行版安装

# 切换到安装目录,没有此目录请执行 mkdir /opt/
cd /opt/
# 下载运行环境
wget https://npm.taobao.org/mirrors/node/v12.16.1/node-v12.16.1-linux-x64.tar.gz
# 解压文件
tar -zxvf node-v12.16.1-linux-x64.tar.gz
# 链接程序到环境变量中
ln -s /opt/node-v12.16.1-linux-x64/bin/node /usr/bin/node
ln -s /opt/node-v12.16.1-linux-x64/bin/npm /usr/bin/npm
#创建目录
mkdir mcsmanager
cd mcsmanager
# 下载程序(将[latest]换成最新的release tag)
curl https://github.com/h5mcbox/MCSManager-plus-Backend/releases/download/[latest]/app.apkg >app.apkg
curl https://github.com/h5mcbox/MCSManager-plus-Backend/releases/download/[latest]/app.js >app.js
# 启动面板
node app
# 关闭面板使用 Ctrl+C 快捷键即可
  • 注意,这种安装方式不会自动注册面板到系统服务(Service),所以必须使用 screen 软件来管理。
  • 或者您可以 点击这里 来手动配置面板到系统

关于更多的安装说明,请 单击这里


项目目录结构

注意: 并不是所有目录的文件我们都建议你进行更改!

目录名 详情/解释
property.js 控制面板配置文件
core/logo.txt               控制台输出 logo 文字
public/404.html 404页面
public/onlinefs_public/       文件在线管理模块前端所有代码
public/common/URL.js URL定位器
server/server_core           Minecraft 服务端核心目录,包括服务端文件,配置,Mod,以及插件
server/x.json               Minecraft 服务器面板配置文件
route/                     控制器,HTTP 请求业务逻辑层(可二次扩展)
route/websocket/             控制器,Webscoket 请求业务逻辑层(可二次扩展)
core/Process/               Minecraft Server 类实现
core/CryptoMine.js             HASH实现
core/DataModel.js             数据持久化模型,几乎是所有的配置的 I/O 模型
model/                     模型层,用于提供控制器与服务端,用户操作,也提供设计模式模型
helper/                     业务逻辑辅助层,用于辅助和重复利用业务逻辑
onlinefs/                     文件管理独立模块 (Suwings/IndependentFileManager)

浏览器兼容性

  • ECMAScript 6 标准
  • Chrome Firefox Safari Opera 等现代主流浏览器

自定义设计

你可以对前端以及后端进行任何程度的修改,包括版权声明。


反向代理 与 SSL

尽管默认没有 Https ,您可能在公共网络下不太放心,但是我们不传递明文的密码,可以保证你的账号的密码是难以泄露的。

具体密码传递过程可参考 单击这里跳转

Property 文件

反向代理之前,建议你阅读 property.js 文件

里面有各类的设置,包括 gzip压缩,端口和ip绑定等等。

实现 HTTPS 与 WSS

请在property.js文件里找到MCSERVER.localProperty.listen_type,按照提示修改。

反向代理

后端请通过反向代理完成,或自行修改 Express 初始化 App。

Apache 反向代理教程

SSL 功能实现示例

注意: Nginx 反向代理注意 | Apache 反向代理注意 | 关于 Caddy 反向代理坑


开源协议

MIT License


Original Author: Suwings

Original Repository: Suwings/MCSManager