本篇文章将详细讲解“网狐系列嘻游电玩组件”服务端的完整搭建过程,适合平台研发人员、二次开发工程师及学习者参考。文中将附带关键配置文件、数据库结构SQL片段及调试技巧,确保每一步均可复现,适配 Windows Server 环境及 Win10 系统。
一、服务端文件结构总览
下载解压后的服务端文件通常包括如下目录:
/xiyou_server
├── bin/ # 主程序执行文件目录
├── conf/ # 核心配置文件目录
├── db_script/ # 数据库建表脚本
├── log/ # 运行时日志
├── tools/ # 解密工具、打包工具
└── start.bat # 启动脚本
文件说明:
-
bin/
下包含GameServer.exe
、LoginServer.exe
等核心服务端进程。 -
conf/
内含config.ini
,roomlist.json
等系统配置。 -
db_script/
提供.sql
文件,用于初始化数据库。
二、数据库导入与结构说明
推荐使用 SQL Server 2014 及以上版本。
1. 创建数据库实例
打开 SQL Server Management Studio,新建数据库名:xiyou_game
。
2. 导入脚本
使用脚本管理器运行 db_script/init.sql
文件:
CREATE TABLE [dbo].[Accounts] (
[UserID] INT IDENTITY(1001,1) PRIMARY KEY,
[Username] VARCHAR(32) NOT NULL,
[Password] VARCHAR(32) NOT NULL,
[RegisterDate] DATETIME DEFAULT GETDATE()
);
CREATE TABLE [dbo].[GameScore] (
[UserID] INT,
[Score] BIGINT DEFAULT 0,
[WinCount] INT DEFAULT 0,
[LostCount] INT DEFAULT 0
);
3. 注意事项
-
所有表结构字段需与服务端代码匹配,否则登录时报错。
-
部分字段如
MachineID
,LastLoginIP
属于行为监控项,可手动追加字段兼容未来更新。
三、服务端配置详解(config.ini)
配置文件路径:/conf/config.ini
示例内容:
[Database]
Server=127.0.0.1
Port=1433
DBName=xiyou_game
User=sa
Password=yourpass
[Server]
GamePort=8600
LoginPort=8700
MaxOnline=1000
[Log]
EnableLog=true
LogLevel=3
参数解释:
-
Server
与Port
:SQL数据库连接地址与端口 -
MaxOnline
:可承载的最大在线人数,建议在测试阶段设为 100 -
LogLevel
:日志级别(1~5,建议设置为3以记录调试信息)
四、启动流程与日志排查
1. 启动服务端
运行根目录下 start.bat
,依次启动 LoginServer 与 GameServer。
2. 检查端口占用
使用命令行:
netstat -ano | findstr ":8600"
若被占用,可修改 config.ini
中端口号。
3. 日志分析路径
查看 /log/login.log
和 /log/game.log
获取详细调试信息。 常见错误如下:
错误日志 | 原因 |
---|---|
数据库连接失败 | 用户名密码错误或 SQL 服务未启动 |
GameServer 未启动成功 | 配置端口冲突,或缺少数据库表结构 |
五、常见问题总结
-
数据库连接失败:检查账号权限、TCP协议是否启用、1433端口是否放行。
-
服务端无法启动:优先查看
log/
目录中的日志文件,确认是否为缺表、缺字段或配置错误。 -
客户端连接不上:请确认服务端已开放端口,客户端 IP 是否指向正确。
-
数据初始化报错:部分
NOT NULL
字段若无默认值,插入数据时需显式提供。
六、进阶建议
-
可使用 PowerShell 脚本自动部署数据库与服务端。
-
若项目需跨设备部署,建议搭建远程 SQL 数据源并做 IP 白名单配置。
-
服务端若需对接代理分发系统,可额外加入用户绑定表、层级表、行为记录表等拓展字段。