mirror of
https://github.com/MCSManager/MCSManager.git
synced 2024-12-03 07:20:16 +08:00
248 lines
11 KiB
Markdown
248 lines
11 KiB
Markdown
|
||
|
||
[](https://www.npmjs.com/)
|
||
[](https://nodejs.org/en/download/)
|
||
[](https://travis-ci.org/Suwings/MCSManager)
|
||
[](https://github.com/Suwings/MCSManager)
|
||
|
||
|
||
简单，易用，多实例，轻量级的 Minecraft Server 控制面板
|
||
|
||
|
||
|
||
[中文简体](https://github.com/Suwings/MCSManager) | [中文繁體](README-traditional.md)
|
||
|
||
<br />
|
||
|
||
**本项目 [赞助者名单](https://docs.qq.com/sheet/DYWJNVXhib0dtamh2?c=B3A0A0)**
|
||
<br />
|
||
|
||
简介
|
||
-----------
|
||
这是一款可以管理多个 Minecraft 服务端（支持群组端）的 Web 管理面板，并且可以分配多个子账号来分别管理不同的 Minecraft 服务端，支持绝大部分主流的服务端，甚至是其他非 Minecraft 的程序。
|
||
|
||
控制面板可运行在 Windows 与 Linux 平台，无需数据库与任何系统配置，只需安装 node 环境即可快速运行，属于轻量级的 Minecraft 服务端控制面板。
|
||
|
||
|
||
|
||
<br />
|
||
|
||
运行环境
|
||
-----------
|
||
|
||
推荐 `Node 10.16.0` 以上，无需数据库和更改任何系统配置，开箱即可运行。
|
||
|
||
|
||
<br />
|
||
|
||
|
||
配置文件
|
||
-----------
|
||
配置文件是程序目录下的 `property.js` 文件，它会在你第一次运行的时候，自动生成。
|
||
|
||
> 此文件不会与 github 版本冲突，git pull 更新时也不会自动覆盖。
|
||
|
||
<br />
|
||
|
||
|
||
常见问题
|
||
-----------
|
||
| 问题 | 详情 |
|
||
| ------------------------ | --------------------------------------------------------------------------------------------- |
|
||
无法正常安装面板？| [参考教程](https://github.com/Suwings/MCSManager/wiki/Linux-%E4%B8%8B%E5%AE%89%E8%A3%85%E4%B8%8E%E4%BD%BF%E7%94%A8%E8%AF%A6%E8%A7%A3)
|
||
Linux 下面板如何后台运行？ | [参考方法](https://github.com/Suwings/MCSManager/wiki/Linux-%E4%B8%8B%E5%AE%89%E8%A3%85%E4%B8%8E%E4%BD%BF%E7%94%A8%E8%AF%A6%E8%A7%A3#%E4%BF%9D%E6%8C%81%E5%90%8E%E5%8F%B0%E8%BF%90%E8%A1%8C)
|
||
使用面板开启 `Bedrock Server` 端 | [参考教程](https://github.com/Suwings/MCSManager/wiki/%E4%BD%BF%E7%94%A8%E9%9D%A2%E6%9D%BF%E5%BC%80%E5%90%AF-Bedrock_server-%E6%9C%8D%E5%8A%A1%E7%AB%AF)
|
||
面板管理员的默认账号和密码是什么？ | 账号 `#master` 密码 `123456`
|
||
面板如何正确关闭？ | `Ctrl+C`
|
||
配置文件是什么？ | `property.js` 文件
|
||
如何修改面板默认端口？ | `property.js` 文件
|
||
如何配置反向代理？ | [Apache 配置参考教程](https://github.com/Suwings/MCSManager/wiki/%E4%BD%BF%E7%94%A8-Apache2.4-%E8%BF%9B%E8%A1%8C%E5%8F%8D%E5%90%91%E4%BB%A3%E7%90%86)
|
||
配好反向代理却无法使用？ | [Apache](https://github.com/Suwings/MCSManager/issues/34) [Nginx](https://github.com/Suwings/MCSManager/issues/22) [宝塔上的Nginx](https://github.com/Suwings/MCSManager/wiki/%E5%85%B3%E4%BA%8E%E5%AE%9D%E5%A1%94%E9%9D%A2%E6%9D%BF%E7%9A%84-Nginx-%E5%8F%8D%E5%90%91%E4%BB%A3%E7%90%86%E4%BB%A5%E5%8F%8ASSL%E8%AF%81%E4%B9%A6%E9%83%A8%E7%BD%B2)
|
||
FTP 无法使用？ | [跳转](https://github.com/Suwings/MCSManager#ftp-%E6%9C%8D%E5%8A%A1)
|
||
反代后文件管理偶尔失效? | 请检查反代机器的防火墙是否拦截
|
||
我能修改登录页面吗？| [修改教程](https://github.com/Suwings/MCSManager/wiki/%E8%87%AA%E5%AE%9A%E4%B9%89%E4%BF%AE%E6%94%B9%E7%99%BB%E5%BD%95%E9%A1%B5%E9%9D%A2)
|
||
其他常见问题 | [查看 Wiki](https://github.com/Suwings/MCSManager/wiki)
|
||
关于HTTP跳转HTTPS的帮助 | [查看 Nginx 301永久重定向 范例](https://github.com/Suwings/MCSManager/wiki/Nginx%E5%85%A8%E5%B1%80301%E6%B0%B8%E4%B9%85%E9%87%8D%E5%AE%9A%E5%90%91)
|
||
|
||
|
||
<br />
|
||
|
||
|
||
|
||
|
||
运行在 Windows
|
||
-----------
|
||
对于 Windows 系统，已整合成直接运行版本，下载即可运行(建议使用管理员权限运行):
|
||
|
||
|
||
|
||
http://mcsm.suwings.top/ (官方站点)
|
||
|
||
**注意:** 这里提供的下载是打包集成好的，小版本更新我们不会打包，也就是意味着，这里不能实时跟随最新版本。
|
||
|
||
<br />
|
||
|
||
|
||
运行在 Linux
|
||
-----------
|
||
**提示:** 请给予 root 权限运行，如无法给予 root 权限，请编辑好文件目录权限。
|
||
|
||
```bash
|
||
# 安装 Node 版本控制工具(若没有 wget,请安装它)
|
||
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.2/install.sh | bash
|
||
# 关闭终端重新打开再执行以下命令
|
||
# 项目支持 10.0 版本以上，这里使用11版本
|
||
nvm install 11.0.0
|
||
nvm use 11.0.0
|
||
# 克隆仓库
|
||
git clone https://github.com/suwings/mcsmanager.git
|
||
# 进入目录
|
||
cd mcsmanager/
|
||
# 安装依赖库
|
||
npm install
|
||
# 启动面板
|
||
npm start
|
||
# 或者 node app.js
|
||
|
||
```
|
||
|
||
> 详细安装以及使用教程，请 [单击这里](https://github.com/Suwings/MCSManager/wiki/Linux-%E4%B8%8B%E5%AE%89%E8%A3%85%E4%B8%8E%E4%BD%BF%E7%94%A8%E8%AF%A6%E8%A7%A3)
|
||
- 项目属于**开箱即用**的面板，如果不使用 **screen** 进行后台常驻.当你断开了SSH后,面板也会随之关闭.
|
||
- **screen** 需要单独安装,执行安装指令"yum -y install screen"或"apt -y install screen"
|
||
|
||
<br />
|
||
|
||
通过 Docker 启动 MC 服务端
|
||
-----------
|
||
|
||
我们支持面板在 Linux 系统下，配合 Docker 以命令的形式，来创建 Minecraft 服务端所需 Java 环境镜像，并且在容器中启动和关闭你的 Minecraft 服务端。
|
||
|
||
如果你不会使用，请点击`具体使用方法` 链接，如果你还未安装 Docker 请点击 `安装Docker` 的链接。
|
||
|
||
**具体使用方法:** [单击跳转](https://github.com/Suwings/MCSManager/blob/gh-pages/Question_1.md)
|
||
|
||
**安装 Docker:** [单击跳转](https://github.com/Suwings/MCSManager/blob/gh-pages/Question_2.md)
|
||
|
||
|
||
<br />
|
||
|
||
|
||
项目目录结构
|
||
-----------
|
||
**注意:** 并不是所有目录的文件我们都建议你进行更改！
|
||
|
||
| 目录名 | 详情/解释 |
|
||
| ------------------------ | --------------------------------------------------------------------------------------------- |
|
||
| **property.js** |控制面板配置文件|
|
||
| **core/logo.txt** |控制台输出 logo 文字|
|
||
| **public/** |前端所有代码，资源目录，前后端分离，使用 ws 和 ajax 通讯|
|
||
| **public/login/** |纯 UI 逻辑登陆页面|
|
||
| **public/template/** |前端业务模板，每个模板拥有着一个生命周期，开始与结束。|
|
||
| **public/onlinefs_public/** |文件在线管理模块前端所有代码|
|
||
| **public/common/js/meum.js** |控制面板左侧菜单列表|
|
||
| **public/common/js/login.js** |通用登录流程逻辑，可重复利用在各类 HTML 登录模板|
|
||
| **server/server_core** |Minecraft 服务端核心目录，包括服务端文件，配置，Mod，以及插件|
|
||
| **server/x.json** |Minecraft 服务器面板配置文件|
|
||
| **users/x.json** |控制面板用户配置文件|
|
||
| **route/** |控制器，HTTP 请求业务逻辑层（可二次扩展）|
|
||
| **route/websocket/** |控制器，Webscoket 请求业务逻辑层（可二次扩展）|
|
||
| **core/Process/** |Minecraft Server 类实现|
|
||
| **core/User/** |User 类实现|
|
||
| **core/DataModel.js** |数据持久化模型，几乎是所有的配置的 I/O 模型|
|
||
| **model/** |模型层，用于提供控制器与服务端，用户操作，也提供设计模式模型|
|
||
| **helper/** |业务逻辑辅助层，用于辅助和重复利用业务逻辑|
|
||
| **ftpd/** |FTP 独立模块，其中 ftpserver.js 已经实现了抽象 ftpServerInterface 接口|
|
||
| **onlinefs/** |文件管理独立模块 ([Suwings/IndependentFileManager](https://github.com/Suwings/IndependentFileManager))|
|
||
|
||
<br />
|
||
|
||
浏览器兼容性
|
||
-----------
|
||
- `ECMAScript 5` 标准
|
||
- `IE 10+` `Chrome` `Firefox` `Safari` `Opera` 等现代主流浏览器
|
||
|
||
**例外:** 文件在线管理界面需要 `IE 11+`
|
||
|
||
<br />
|
||
|
||
|
||
|
||
自定义设计
|
||
-----------
|
||
你可以对前端以及后端进行任何程度的修改，包括版权声明。
|
||
|
||
|
||
<br />
|
||
|
||
FTP 服务
|
||
-----------
|
||
|
||
FTP 模块默认为关闭状态.开启选项在 property.js 文件中 但不建议使用
|
||
|
||
采用被动传输模式，传输命令默认使用 `10022`(可更改) 端口；
|
||
|
||
传输数据需要一个端口段，默认是 `20010` - `20100`；
|
||
|
||
为确保 FTP 服务正常使用，请配置好您的防火墙设置，对这些端口范围进行开放。
|
||
|
||
> 此功能未来版本有可能会删除，使用已有的在线文件管理完全代替。
|
||
|
||
<br />
|
||
|
||
反向代理 与 SSL
|
||
-----------
|
||
|
||
尽管默认没有 Https ，您可能在公共网络下不太放心，但是我们不传递明文的密码，可以保证你的账号的密码是难以泄露的。
|
||
|
||
具体密码传递过程可参考 [单击这里跳转](https://github.com/Suwings/MCSManager/wiki/%E7%99%BB%E5%BD%95%E5%AF%86%E7%A0%81%E4%BC%A0%E9%80%92%E8%BF%87%E7%A8%8B%E5%9B%BE)
|
||
|
||
**Property 文件**
|
||
|
||
反向代理之前，建议你阅读 `property.js` 文件
|
||
|
||
> 里面有各类的设置，包括 gzip压缩，端口和ip绑定等等。
|
||
|
||
**实现 HTTPS 与 WSS**
|
||
|
||
打开前端 URL 定位文件 `public/common/URL.js`, 将 http 与 ws 改成 https 与 wss；
|
||
|
||
可保证前端所有请求均为 https 和 wss，但是后端方面还需要配置 SSL 与 反向代理。
|
||
|
||
**反向代理**
|
||
|
||
后端请通过反向代理完成，或自行修改 Express 初始化 App。
|
||
|
||
[Apache 反向代理教程](https://github.com/Suwings/MCSManager/wiki/%E4%BD%BF%E7%94%A8-Apache2.4-%E8%BF%9B%E8%A1%8C%E5%8F%8D%E5%90%91%E4%BB%A3%E7%90%86)
|
||
|
||
[SSL 功能实现示例](https://github.com/Suwings/MCSManager/issues/146)
|
||
|
||
**注意:** [Nginx 反向代理注意](https://github.com/Suwings/MCSManager/issues/22) | [Apache 反向代理注意](https://github.com/Suwings/MCSManager/issues/34) | [关于 Caddy 反向代理坑](https://github.com/Suwings/MCSManager/issues/122)
|
||
|
||
<br />
|
||
|
||
权限系统
|
||
-----------
|
||
尤其注意的是，为了更加简化面板权限系统，我们只分为两种账号。
|
||
|
||
`管理账号` 凡是以 # 字符开头的用户，均为管理账号，列如 `#master` `#admin` `#test`
|
||
|
||
`普通账号` 不以 # 字符开头的用户，列如 `test` `usernameww` `xxx`
|
||
|
||
普通账号能够管理的服务器只能由管理账号来进行设定，管理账号可以管理任何服务器，并且能管理所有用户。
|
||
|
||
具体使用，我想你只需要运行就知道，设计的十分简单。
|
||
|
||
<br />
|
||
|
||
问题报告
|
||
-----------
|
||
欢迎各位发现任何 BUG 及时反馈给我，必当及时修复。
|
||
|
||
<br />
|
||
|
||
开源协议
|
||
-----------
|
||
MIT License
|
||
|
||
<br />
|