功能特性
1. 服务器管理
- 多服务器统一管理
- 服务器状态监控
- 实时在线玩家查看
- RCON 远程控制
- 服务器指令管理
- 在线Web终端
2. 白名单管理
- 白名单申请与审核
- 在线/离线账号支持
- 自动验证正版账号
- 邮件通知功能
- IP 限流保护
3. 玩家管理
- 玩家信息统计
- 游戏时长记录
- 历史名称记录
- 玩家行为追踪
- 地理位置统计
- 封禁管理
4. 管理员功能
- OP 权限管理
- 封禁系统
- 指令执行记录
- 操作日志记录
- 数据统计报表
5. 定时指令
- 定时指令执行
- 定时指令记录
- 定时指令统计
功能特性
后端技术
- Spring Boot
- MyBatis
- Redis
- MySQL
- JWT
前端技术
- Vue.js
- Element UI
- Axios
- Vue Router
- Vuex
快速开始
环境要求
- JDK 1.8+
- Maven 3.0+
- MySQL 5.7+
- Redis 5.0+
- Node.js 12+
开发环境部署
1. 克隆项目
代码:
git clone https://github.com/pilgrimage233/Minecraft-Rcon-Manage.git
2. 初始化数据库
代码:
# 创建数据库并执行SQL脚本
create database minecraft_manager character set utf8mb4 collate utf8mb4_general_ci;
然后导入项目根目录下的
sql
文件夹中的脚本3. 修改配置
代码:
# 修改 ruoyi-admin/src/main/resources/application.yml 中的项目配置
ruoyi:
# 文件路径 示例(Windows配置D:/ruoyi/uploadPath,Linux配置 /home/ruoyi/uploadPath)
profile: D:/ruoyi/uploadPath
# 修改 ruoyi-admin/src/main/resources/application-druid.yml 中的数据库连接信息
spring:
datasource:
druid:
master:
url: jdbc:mysql://localhost:3306/minecraft_manager?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=Asia/Shanghai
username: your_username
password: your_password
# 修改 Redis 配置
spring:
redis:
host: 127.0.0.1
port: 6379
password:
修改前端配置文件:
代码:
// 修改 ruoyi-ui/vue.config.js 中的target API接口地址
proxy: {
// detail: https://cli.vuejs.org/config/#devserver-proxy
[process.env.VUE_APP_BASE_API]
:
{
// target: `http://localhost:8081`,
changeOrigin: true,
pathRewrite
:
{
['^' + process.env.VUE_APP_BASE_API]
:
''
}
}
}
4. 启动服务
后端服务:
代码:
# 进入项目根目录
cd 项目根目录
# Windows环境使用
ry.bat
# Linux环境使用
./ry.sh
代码:
# 进入前端项目目录
cd ruoyi-ui
# 安装依赖
npm install
# 建议不要直接使用 cnpm 安装依赖,会有各种诡异的 bug。可以通过如下操作解决 npm 下载速度慢的问题
npm install --registry=https://registry.npmmirror.com
# 启动服务
npm run dev
生产环境部署
1. 打包项目
后端打包:
代码:
# 在项目根目录执行
mvn clean package
前端打包:
代码:
# 在 ruoyi-ui 目录下执行
npm run build:prod
2. 部署项目
后端部署:
代码:
# 将打包好的jar包上传到服务器
java -jar ruoyi-admin.jar
前端部署:
代码:
# 将打包好的dist目录上传到Nginx的html目录下
# 配置Nginx
server {
listen 80;
server_name localhost;
location / {
root /usr/share/nginx/html/dist;
try_files $uri $uri/ /index.html;
index index.html index.htm;
}
location /prod-api/ {
proxy_pass http://localhost:8080/;
}
}
代码:
// 此前端需要切换到Node.js 18版本
// 修改接口地址 whitelist/.env
VITE_API_URL = http
://localhost:8081
系统使用指南
1. 系统登录
- 默认管理员账号:admin
- 默认密码:admin123
- 首次登录建议修改默认密码
2. 服务器配置
- 进入【系统管理】-【服务器管理】
- 点击【新增】按钮添加Minecraft服务器
- 填写服务器信息:
- 服务器名称
- 服务器IP
- 服务器端口
- RCON端口
- RCON密码
3. 白名单管理
- 进入【白名单管理】-【申请列表】
- 可以查看所有白名单申请
- 点击【审核】按钮进行审核
- 审核通过后,系统会自动将玩家添加到服务器白名单
4. 玩家管理
- 进入【玩家管理】-【玩家列表】
- 可以查看所有玩家信息
- 点击【详情】按钮查看玩家详细信息
- 可以进行封禁、解封等操作
5. 定时任务
- 进入【系统管理】-【定时任务】
- 可以添加定时执行的Minecraft指令
- 支持cron表达式配置执行时间
常见问题
1. 无法连接到数据库
- 检查数据库连接配置是否正确
- 确保MySQL服务已启动
- 检查数据库用户权限
2. Redis连接失败
- 检查Redis服务是否启动
- 确认Redis连接配置是否正确
- 检查Redis密码是否正确
3. RCON连接失败
- 确保Minecraft服务器已开启RCON功能
- 检查RCON端口是否正确
- 验证RCON密码是否正确
4. 前端页面无法访问
- 检查前端服务是否启动
- 确认API接口地址配置是否正确
- 检查浏览器控制台是否有错误信息
相关地址
Github仓库地址: Minecraft-Rcon-Manage@pilgrimage233作者Github: [Github] Pilgrimage233