搬运工 发表于 2026-2-21 20:46:52

征途游戏网站管理系统


# 征途游戏管理系统 (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 文件。

## 免责声明

本系统仅供学习和研究使用,请勿用于商业用途。使用本系统产生的任何后果由使用者自行承担。

---

**征途游戏管理系统** - 让游戏管理更简单!


页: [1]
查看完整版本: 征途游戏网站管理系统