征途游戏网站管理系统

dede998

# 征途游戏管理系统 (ZTGame Manager)
如果不会安装群里问我1085399137   我个人是安装成功了 这个方便 可以直接在网站启动游戏 有一些功能我没有开放在测试出来完整就开放
一个功能完善的征途游戏私服管理后台系统，支持玩家管理、充值系统、装备创造、文件管理、聊天系统、服务器管理等核心功能。
## 功能特性
### 核心功能
- **文件管理系统**
  - 支持 `/home/ztgame` 目录下的文件管理
  - 文件上传/下载/编辑/删除
  - 热更新支持（上传后秒生效，无需重启）
  - 目录浏览和文件搜索
- **玩家管理系统**
  - 连接 FLServerDB 账号数据库
  - 连接 ZtGameDB 角色数据库
  - 玩家信息查询和编辑
  - 封号/解封功能
  - 在线玩家实时监控
- **充值系统**
  - 支付宝扫码支付
  - 微信支付
  - 充值记录查询
  - 手动充值（GM功能）
  - 订单管理
- **装备创造系统**
  - 装备模板管理
  - 装备属性编辑
  - 强化系统
  - 宝石镶嵌
  - 装备品质设置（白/蓝/黄/绿/紫/橙）
- **TBL文件工具**
  - TBL文件读取和解析
  - TBL转JSON/CSV
  - 批量转换
  - 数据搜索
- **聊天系统**
  - 网站与游戏内聊天互通
  - 世界/私聊/帮派/系统频道
  - 禁言/解禁功能
  - 系统公告发布
  - 敏感词过滤
- **服务器管理**
  - BillServer、FLServer、GatewayServer等管理
  - 服务器启动/停止/重启
  - 服务器状态监控
  - 系统资源监控（CPU/内存/磁盘）
  - 批量操作
- **PAK文件工具**
  - PAK资源包提取
  - 文件浏览
  - 批量处理
- **GM命令系统**
  - 游戏内GM命令执行
  - 命令日志记录
  - 权限控制
## 技术栈
- **后端**: Node.js   Express
- **数据库**: MySQL (mysql2)
- **实时通信**: Socket.IO
- **前端**: HTML5   CSS3   JavaScript
- **身份验证**: JWT
- **文件上传**: Multer
## 安装部署
### 环境要求
- Node.js 14.0
- MySQL 5.7
- Linux操作系统（推荐CentOS 7 或Ubuntu 18 ）
### 安装步骤
1. **克隆或下载项目**
```bash
cd /opt
git clone https://github.com/your-repo/ZTGameManager.git
cd ZTGameManager
```
2. **运行安装脚本**
```bash
chmod  x start.sh
./start.sh install
```
3. **配置数据库**
复制并编辑配置文件：
```bash
cp server/.env.example server/.env
vim server/.env
```
配置数据库连接信息：
```env
# 数据库配置
DB_HOST=localhost
DB_PORT=3306
DB_USER=root
DB_PASSWORD=your_password
FL_SERVER_DB=FLServerDB
ZT_GAME_DB=ZtGameDB
# JWT密钥（请修改为随机字符串）
JWT_SECRET=your_random_secret_key_here
# 服务器端口
PORT=3000
# 文件上传路径
FILE_UPDATE_PATH=/home/ztgame
# 支付宝配置
ALIPAY_APP_ID=your_alipay_app_id
ALIPAY_PRIVATE_KEY=your_alipay_private_key
ALIPAY_PUBLIC_KEY=your_alipay_public_key
# 微信支付配置
WECHAT_APP_ID=your_wechat_app_id
WECHAT_MCH_ID=your_wechat_mch_id
WECHAT_API_KEY=your_wechat_api_key
```
4. **初始化数据库**
```bash
cd server/database
mysql -u root -p < init.sql
```
5. **启动服务器**
```bash
./start.sh start
```
6. **访问系统**
打开浏览器访问: `http://your-server-ip:3000`
默认管理员账号: `admin`
默认管理员密码: `admin123`
**注意**: 首次登录后请立即修改默认密码！
## 使用说明
### 常用命令
```bash
# 启动服务器
./start.sh start
# 停止服务器
./start.sh stop
# 重启服务器
./start.sh restart
# 查看状态
./start.sh status
# 查看日志
./start.sh logs
```
### 文件热更新
1. 进入"文件管理"页面
2. 选择要更新的文件或上传新文件
3. 文件将自动同步到 `/home/ztgame` 目录
4. 游戏服务器会自动检测文件变化并热加载
### 充值系统配置
#### 支付宝配置
1. 登录支付宝开放平台
2. 创建应用并获取 AppID
3. 生成应用私钥和公钥
4. 将配置信息填入 `.env` 文件
#### 微信支付配置
1. 登录微信支付商户平台
2. 获取 AppID、商户号(MCH_ID)和 API密钥
3. 将配置信息填入 `.env` 文件
### 装备创造
1. 进入"装备系统"页面
2. 选择目标角色
3. 选择装备模板
4. 设置品质、强化等级等属性
5. 点击"创建装备"
### 聊天系统
1. 进入"聊天系统"页面
2. 选择聊天频道（世界/私聊/帮派/系统）
3. 输入消息内容
4. 点击发送或按回车键
网站发送的消息会实时同步到游戏内，游戏内消息也会显示在网站上。
### 服务器管理
1. 进入"服务器管理"页面
2. 查看各服务器运行状态
3. 点击对应按钮启动/停止/重启服务器
4. 可以批量操作所有服务器
## 目录结构
```
ZTGameManager/
├── server/                 # 后端代码
│   ├── app.js             # 主入口
│   ├── package.json       # 依赖配置
│   ├── .env               # 环境变量
│   ├── models/            # 数据模型
│   │   └── database.js    # 数据库连接
│   ├── routes/            # 路由
│   │   ├── player.js      # 玩家管理
│   │   ├── recharge.js    # 充值系统
│   │   ├── equipment.js   # 装备系统
│   │   ├── filemanager.js # 文件管理
│   │   ├── chat.js        # 聊天系统
│   │   ├── servermanager.js # 服务器管理
│   │   └── admin.js       # 管理员管理
│   ├── middleware/        # 中间件
│   │   └── auth.js        # 身份验证
│   ├── services/          # 服务层
│   │   └── chatService.js # 聊天服务
│   ├── utils/             # 工具函数
│   │   ├── tblReader.js   # TBL读取工具
│   │   └── pakReader.js   # PAK读取工具
│   └── database/          # 数据库脚本
│       └── init.sql       # 初始化脚本
├── public/                # 前端代码
│   ├── index.html         # 主页面
│   ├── css/
│   │   └── style.css      # 样式表
│   └── js/
│       └── app.js         # 前端脚本
├── logs/                  # 日志目录
├── uploads/               # 上传文件目录
├── start.sh               # 启动脚本
└── README.md              # 说明文档
```
## API接口文档
### 玩家管理
- `GET /api/players/accounts` - 获取账号列表
- `GET /api/players/account/:id` - 获取账号详情
- `GET /api/players/characters` - 获取角色列表
- `PUT /api/players/character/:id` - 修改角色信息
- `POST /api/players/ban` - 封号
- `POST /api/players/unban` - 解封
### 充值系统
- `POST /api/recharge/alipay/create` - 创建支付宝订单
- `POST /api/recharge/wechat/create` - 创建微信订单
- `POST /api/recharge/alipay/callback` - 支付宝回调
- `POST /api/recharge/wechat/callback` - 微信回调
- `GET /api/recharge/history` - 充值记录
### 装备系统
- `GET /api/equipment/templates` - 获取装备模板
- `POST /api/equipment/create` - 创建装备
- `GET /api/equipment/character/:characterId` - 获取角色装备
- `POST /api/equipment/enhance` - 装备强化
- `POST /api/equipment/embed-gem` - 宝石镶嵌
### 文件管理
- `GET /api/files/list` - 获取文件列表
- `POST /api/files/upload` - 上传文件
- `POST /api/files/edit` - 编辑文件
- `DELETE /api/files/delete` - 删除文件
### 聊天系统
- `GET /api/chat/history` - 获取聊天记录
- `POST /api/chat/send` - 发送消息
- `POST /api/chat/announcement` - 发送公告
- `POST /api/chat/mute` - 禁言玩家
- `POST /api/chat/unmute` - 解除禁言
### 服务器管理
- `GET /api/servers/status` - 获取服务器状态
- `POST /api/servers/start/:server` - 启动服务器
- `POST /api/servers/stop/:server` - 停止服务器
- `POST /api/servers/restart/:server` - 重启服务器
### 管理员管理
- `POST /api/admin/login` - 管理员登录
- `GET /api/admin/me` - 获取当前用户信息
- `GET /api/admin/list` - 获取管理员列表
- `POST /api/admin/create` - 创建管理员
- `PUT /api/admin/:id` - 更新管理员
- `DELETE /api/admin/:id` - 删除管理员
## 安全建议
1. **修改默认密码**: 首次登录后立即修改默认管理员密码
2. **使用HTTPS**: 生产环境建议使用HTTPS加密通信
3. **配置防火墙**: 仅开放必要的端口（如80/443/3000）
4. **定期备份**: 定期备份数据库和重要文件
5. **日志监控**: 定期检查系统日志，发现异常及时处理
6. **权限控制**: 合理分配管理员权限，遵循最小权限原则
## 常见问题
### Q: 如何修改服务器端口？
A: 编辑 `server/.env` 文件，修改 `PORT` 配置项，然后重启服务器。
### Q: 如何添加新的管理员？
A: 使用超级管理员账号登录，进入"管理员管理"页面，点击"添加管理员"。
### Q: 文件上传大小限制是多少？
A: 默认限制为100MB，可以在 `server/routes/filemanager.js` 中修改。
### Q: 如何查看错误日志？
A: 运行 `./start.sh logs` 查看实时日志，或查看 `logs/server.log` 文件。
### Q: 数据库连接失败怎么办？
A: 检查 `.env` 文件中的数据库配置是否正确，确保MySQL服务已启动。
## Docker部署
### 使用Docker Compose（推荐）
```bash
# 1. 克隆项目
git clone https://github.com/your-repo/ZTGameManager.git
cd ZTGameManager
# 2. 配置环境变量
cp server/.env.example server/.env
vim server/.env
# 3. 启动服务
docker-compose up -d
# 4. 查看日志
docker-compose logs -f
# 5. 停止服务
docker-compose down
```
### 使用Docker
```bash
# 构建镜像
docker build -t ztgame-manager .
# 运行容器
docker run -d
  -p 3000:3000
  -v $(pwd)/logs:/app/logs
  -v $(pwd)/uploads:/app/uploads
  -v /home/ztgame:/home/ztgame
  --name ztgame-manager
  ztgame-manager
```
## PM2部署
```bash
# 安装PM2
npm install -g pm2
# 使用PM2启动
pm2 start ecosystem.config.js
# 查看状态
pm2 status
# 查看日志
pm2 logs ztgame-manager
# 重启
pm2 restart ztgame-manager
# 停止
pm2 stop ztgame-manager
```
## Systemd部署
```bash
# 创建systemd服务
sudo ./install.sh
# 启动服务
sudo systemctl start ztgame-manager
# 开机自启
sudo systemctl enable ztgame-manager
# 查看状态
sudo systemctl status ztgame-manager
# 查看日志
sudo journalctl -u ztgame-manager -f
```
## 更新日志
### v1.0.0 (2024-01-01)
- 初始版本发布
- 实现文件管理系统
- 实现玩家管理系统
- 实现充值系统
- 实现装备创造系统
- 实现聊天系统
- 实现服务器管理系统
- 实现TBL/PAK文件工具
## 技术支持
如有问题或建议，请联系：
## 许可证
本项目采用 MIT 许可证，详见 LICENSE 文件。
## 免责声明
本系统仅供学习和研究使用，请勿用于商业用途。使用本系统产生的任何后果由使用者自行承担。
---
**征途游戏管理系统** - 让游戏管理更简单！