三国SLG游戏服务器Demo使用指南

核心功能解析

多服务器架构设计

该项目采用微服务架构，将游戏功能拆解为五大核心服务。聊天服务器处理玩家实时消息，网关服务器负责数据转发，HTTP服务器提供API接口，登录服务器管理用户认证，游戏服务器承载核心战斗逻辑。各服务独立部署又协同工作，形成高效稳定的游戏运行环境。

自动化配置管理

系统配备完善的配置自动化机制，通过copydata.bat脚本可将data目录下的配置文件自动复制到运行目录。环境配置文件env.ini集中管理数据库连接、端口号等关键参数，配合config目录下的ORM映射配置，实现开发环境与生产环境的快速切换。

可视化游戏操作界面

提供直观的游戏操作界面，支持部队配置、城池管理等核心玩法。玩家可通过界面进行武将编队、资源调配等操作，系统实时计算部队战斗力、行军速度等关键指标，为策略决策提供数据支持。

环境准备

系统兼容性说明

本项目基于Go语言开发，支持Linux和Windows操作系统。在Linux环境下需确保GCC编译器版本不低于4.8，Windows环境建议使用Windows 10及以上版本，并安装Git Bash以支持Shell脚本运行。

依赖检查清单

首先检查Go环境是否安装，执行go version命令确认版本不低于1.16。接着安装MySQL数据库，推荐版本5.7或8.0。最后确认Docker环境是否就绪，执行docker --version验证Docker Engine是否正常运行。

[!TIP] 所有依赖项安装完成后，建议重启系统以确保环境变量生效。

快速启动

操作步骤	注意事项
🔧 克隆项目代码 git clone https://gitcode.com/gh_mirrors/sl/slgserver	确保网络通畅，克隆过程可能需要几分钟
🔧 配置数据库 1. 执行data/conf/db.sql创建数据库 2. 修改data/conf/env.ini中的数据库参数	数据库默认名为slgdb，需提前创建
🔧 启动服务 Windows: 双击shell/run.bat Linux: 执行bash shell/run.sh	首次启动会自动编译项目，可能需要较长时间

[!TIP] 启动成功后，可通过http://localhost:8080访问HTTP服务器测试接口。

深度配置

数据库连接优化

在env.ini中调整数据库连接参数：

[database]
max_open_conns = 200
max_idle_conns = 50
conn_max_lifetime = 300

max_open_conns控制最大打开连接数，建议根据服务器CPU核心数设置，一般为核心数的2-4倍。

网络性能调优

修改net/conn.go中的网络参数：

const (
    ReadBufferSize  = 4096  // 读缓冲区大小
    WriteBufferSize = 4096  // 写缓冲区大小
    MaxConnNum      = 10000 // 最大连接数
)

根据服务器内存大小调整缓冲区和最大连接数，内存4GB以上可将MaxConnNum设置为10000。

日志级别配置

在log/log.go中设置日志级别：

// 日志级别: Debug(0), Info(1), Warn(2), Error(3), Fatal(4)
var LogLevel = 1

开发环境建议设为0（Debug），生产环境设为1（Info）以减少日志开销。

常见启动故障排查

graph TD
    A[启动失败] --> B{检查数据库}
    B -->|连接失败| C[检查env.ini配置]
    B -->|表结构错误| D[重新执行db.sql]
    A --> E{服务端口冲突}
    E --> F[修改对应服务端口配置]
    A --> G{配置文件缺失}
    G --> H[执行copydata.bat复制配置]

知识拓展：了解更多Go语言网络编程知识，可参考官方文档中关于net包的详细说明。

如何根据服务器硬件配置调整连接池参数以获得最佳性能？下一章将介绍高级性能优化技巧。