📋 项目简介
本系统是一个基于PHP+MySQL的游戏服务器账号封禁公示平台,专门用于展示和管理服务器中的违规账号信息。系统采用现代化科技感设计,具有前后台分离架构,既方便玩家查看封禁信息,也便于管理员高效管理。
🏗️ 系统架构
技术栈
- 后端: PHP 8.x
- 前端: HTML5 + CSS3 + JavaScript
- 数据库: MySQL/MariaDB
- 服务器: Apache/Nginx
- 设计风格: Cyberpunk科技感
目录结构
├── index.php # 前端展示主页
├── admin/
│ ├── index.php # 后台登录页
│ ├── dashboard.php # 管理主页
│ ├── add.php # 添加记录
│ ├── edit.php # 编辑记录
│ ├── delete.php # 删除处理
│ └── logout.php # 退出登录
├── assets/
│ ├── css/
│ │ ├── style.css # 前端样式
│ │ └── admin.css # 后台样式
│ ├── js/
│ │ ├── main.js # 前端交互
│ │ └── admin.js # 后台交互
│ └── images/ # 图片资源
├── includes/
│ ├── config.php # 数据库配置
│ ├── functions.php # 公共函数
│ └── auth.php # 权限验证
└── install.php # 安装脚本
📊 数据库设计
bans表结构
| 字段名 | 类型 | 说明 |
|---|---|---|
| id | INT AUTO_INCREMENT | 主键 |
| username | VARCHAR(50) | 玩家用户名 |
| ban_time | DATETIME | 封禁时间 |
| unban_time | DATETIME | 解封时间 |
| punishment | VARCHAR(100) | 违规惩罚类型 |
| reason | TEXT | 违规行为描述 |
| created_at | TIMESTAMP | 记录创建时间 |
🚀 安装教程
步骤1:环境准备
- 安装Web服务器:
- Nginx 1.28.1+
- PHP 8.x
- MySQL 5.7+
- 启用PHP扩展:
- PDO_MySQL
- session
- mysqli
步骤2:部署项目
- 将项目文件复制到Web目录:
/www/wwwroot/域名
步骤3:运行安装向导
- 访问安装页面:
http://localhost/install.php
- 填写数据库配置:
数据库主机: localhost
数据库名: minecraft_bans
用户名: root
密码: (您的数据库密码)
表前缀: bans_
- 管理员账户:
管理员默认账号: admin
管理员默认密码: admin123
先后完成之后一定要在管理页面更改默认密码[http://localhost/admin/admins.php]
- 点击"一键安装",等待安装完成
步骤4:删除安装文件
rm install.php # Linux/Mac
# 或删除 install.php 文件(Windows)
🖥️ 前端使用教程
1. 查看封禁列表
- 访问首页:
http://localhost/
- 浏览数据:
- 表格默认显示最新的封禁记录
- 每页显示10-15条记录
- 支持上下翻页
2. 使用搜索功能
- 在顶部搜索框输入玩家用户名
- 实时显示搜索结果
- 搜索结果支持分页
3. 表格功能介绍
| 功能 | 操作方法 |
|---|---|
| 查看详情 | 鼠标悬停在"违规行为"单元格查看完整描述 |
| 排序 | 点击表头可对当前列排序 |
| 分页 | 使用底部页码或箭头按钮 |
| 自适应 | 系统自动适配手机/平板/PC |
🔧 后台管理教程
1. 管理员登录
- 访问后台地址:
http://localhost/admin/index.php
- 输入管理员账号密码
- 成功登录后进入管理面板
2. 添加封禁记录
- 点击"添加记录"按钮
- 填写表单:
玩家用户名: Steve
封禁时间: 2024-03-20 14:30:00
解封时间: 2024-03-27 14:30:00
违规惩罚: 封禁7天
违规行为: 使用外挂程序
- 点击"提交"保存记录
3. 编辑封禁记录
- 在记录列表点击"编辑"按钮
- 修改需要更新的字段
- 点击"保存修改"
4. 删除记录
- 单个删除:点击记录旁的删除按钮
- 批量删除:
- 勾选多个记录前的复选框
- 点击顶部"批量删除"按钮
- 确认删除操作
5. 数据导出
- 支持导出为CSV格式
- 可选择导出全部或筛选后的数据
- 导出文件可直接用Excel打开
⚙️ 系统配置
1. 修改配置文件
编辑 includes/config.php:
<?php
// 数据库配置
define('DB_HOST', 'localhost');
define('DB_NAME', 'minecraft_bans');
define('DB_USER', 'root');
define('DB_PASS', 'your_password');
// 网站配置
define('SITE_NAME', '封禁公示系统');
define('TIMEZONE', 'Asia/Shanghai');
define('ITEMS_PER_PAGE', 10); // 每页显示数量
2. 主题自定义
修改 assets/css/style.css:
/* 主题颜色 */
:root {
--primary-color: #00ffff; /* 霓虹青色 */
--secondary-color: #ff00ff; /* 霓虹粉色 */
--bg-color: #0a0a0a; /* 深色背景 */
--text-color: #ffffff; /* 文字颜色 */
}
🛡️ 安全配置
1. 权限设置
# 限制config文件访问
chmod 644 includes/config.php
# 防止目录浏览
echo "Options -Indexes" > .htaccess
2. 管理员安全
- 修改默认管理员密码
- 定期更换管理员密码
- 限制登录尝试次数
3. 数据库安全
- 使用强密码
- 定期备份数据库
- 限制数据库用户权限
🔍 常见问题解答
Q1:安装时报错"无法连接数据库"
解决方案:
- 检查MySQL服务是否启动
- 确认数据库用户密码正确
- 检查防火墙设置
Q2:搜索功能不工作
解决方案:
- 检查JavaScript是否启用
- 查看浏览器控制台错误信息
- 确保数据库索引已创建
Q3:分页显示错误
解决方案:
- 检查ITEMS_PER_PAGE配置
- 清理浏览器缓存
- 检查数据库记录数量
Q4:后台登录失败
解决方案:
- 确认管理员账号密码
- 检查session配置
- 查看服务器错误日志
🚨 故障排除
1. 数据库连接问题
// 检查连接
$conn = new mysqli(DB_HOST, DB_USER, DB_PASS, DB_NAME);
if ($conn->connect_error) {
die("连接失败: " . $conn->connect_error);
}
2. 性能优化
- 启用缓存:使用Redis或Memcached
- 数据库索引:为常用查询字段创建索引
- CDN加速:静态资源使用CDN分发
3. 日志查看
# Apache错误日志
tail -f /var/log/apache2/error.log
# PHP错误日志
tail -f /var/log/php_error.log
📱 移动端适配
响应式设计
- 手机端:单列显示,简化操作
- 平板端:双列显示,优化触摸
- 桌面端:完整功能,键盘操作友好
移动端专属功能
- 下拉刷新:更新最新数据
- 手势操作:左滑查看更多选项
- 离线缓存:网络恢复后自动同步
🔄 更新与维护
定期维护任务
- 每周:清理临时文件,备份数据库
- 每月:更新系统日志,安全检查
- 每季度:性能优化,安全补丁更新
版本升级
- 备份当前数据和配置文件
- 下载新版本文件
- 按照升级说明逐步更新
- 测试所有功能是否正常
💡 使用技巧
高效操作技巧
- 批量操作:
- 支持使用模板导入大量数据
- 支持定时任务自动更新状态
- 支持一键导出统计报告
数据管理技巧
- 分类管理:为不同违规类型设置标签
- 数据清理:定期清理过期记录
📞 技术支持
获取帮助
- 文档查询:查阅本文档相关章节
- 社区支持:访问项目GitHub页面
- 联系开发:通过issue反馈问题
问题反馈
请提供以下信息:
- 系统版本号
- 错误截图或日志
- 操作步骤描述
- 环境配置信息
🎯 总结
本系统为《我的世界》服务器提供了一套完整的账号封禁管理解决方案,具有以下特点:
✅ 核心优势
- 界面美观:现代化科技感设计
- 操作简便:前后台分离,职责明确
- 安全稳定:多重安全防护机制
- 扩展性强:模块化设计,便于二次开发
✅ 适用场景
- 中小型MC服务器
- 多服务器联合管理
- 第三方管理插件集成
- 封禁数据统计分析
✅ 开源建议
推荐使用 MIT 许可证,允许:
- 商业使用
- 自由修改
- 二次分发
- 私有部署
开始使用前建议:
- 仔细阅读本文档
- 按照安装教程逐步操作
- 首次使用先在测试环境验证
- 定期备份重要数据
如有任何问题,请随时查阅相关章节或寻求技术支持。祝您使用愉快!🎮

Comments NOTHING