雪舞：维护配置文件知识库：完整字段、读取范围、手工修改实例与核对状态

2026-09-09T14:10:11Z

维护配置文件知识库：完整字段、读取范围、手工修改实例与核对状态

新页面

{{DISPLAYTITLE:<span style="font-size:24px;line-height:1.4;overflow-wrap:anywhere;">工程参考/配置文件/Server/IPRegionTable.txt</span>}}
__NOTOC__
<div class="config-file-reference" style="max-width:1200px;margin:0 auto;line-height:1.8;color:#29343a;font-family:Arial,'Microsoft YaHei',sans-serif;letter-spacing:0;overflow-wrap:anywhere;">
[[首页|首页]] · [[工程参考/配置文件索引|配置文件索引]] · [[工程参考/配置文件修改约定|修改约定]]

Login 用这张表把一个 IPv4 来源地址匹配到地区编号，保存到角色的 IPRegion。它不是访问允许名单，不决定玩家能否连接，也不会把玩家转发到某个 IP。

[[#文件位置与生效|位置与生效]] · [[#文件格式|文件格式]] · [[#字段详解|字段详解]] · [[#常用修改实例|修改实例]]

== 文件位置与生效 ==
{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="width:24%;text-align:left;background:#edf3f2;padding:8px;" | 项目
! scope="col" style="width:76%;text-align:left;background:#edf3f2;padding:8px;" | 说明
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 运行文件
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">./Config/IPRegionTable.txt</code>，相对于读取程序的工作目录。源码 resources/Server/Config 是样本位置，实际部署可能另有副本。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 读取程序
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Login
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 生效方法
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 正常保存并停服后，重启读取此文件的 Login。多份运行目录分别核对。当前检索未发现单独重载本文件的可用入口；不需要把本文件复制到玩家客户端。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 样本格式
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">GB18030-compatible</code>，<code style="white-space:normal;overflow-wrap:anywhere;">CRLF</code>。保留原编码；源码读取器不会自动把中文转为 UTF-8。
|}

四列依次为记录索引、地区编号、起始 IPv4、结束 IPv4。范围含两端；按文件数据行顺序寻找第一条匹配，重叠时后面的条目不会覆盖前面的匹配。

== 文件格式 ==
首行是类型行：<code style="white-space:normal;overflow-wrap:anywhere;">INT INT STRING STRING</code>；第二行是列名行，程序跳过其内容；从第三行开始读取数据。各列用真实 Tab 分隔，保留首列、空列及行尾，不用空格代替。数据行行首 # 表示注释，分号不是此表的注释规则。首列为空的行被跳过；不足的尾列补为空值，多余列不参与本页字段读取。空整数和非数字经 atoi 可能成为 0，空字符串仍为空，不把解析成功当作业务合法。第一列须唯一，重复会触发读取器错误。

== 字段详解 ==
列号从 1 开始，源码列下标从 0 开始。

{| class="wikitable" style="width:100%;table-layout:fixed;border-collapse:collapse;font-size:13px;"
! scope="col" style="width:34%;text-align:left;background:#edf3f2;padding:8px;" | 字段与类型
! scope="col" style="width:42%;text-align:left;background:#edf3f2;padding:8px;" | 含义与修改要点
! scope="col" style="width:24%;text-align:left;background:#edf3f2;padding:8px;" | 缺项或特殊值
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 1 列</code><br>INT：Index
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | DBC 记录索引，须唯一。地区匹配按行遍历，不拿这一列当地区编号或优先级数值。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 非空；重复索引触发错误。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 2 列</code><br>INT：同城频道编号
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 匹配后写入角色 IPRegion 的整数标识。可按已经使用的地区编号建立新网段；不能凭数字猜城市名，也不是区服 ID 或场景 ID。样本编号不等于枚举的完整定义。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 没有匹配返回 -1。频道名称、界面显示及其他使用端的映射需要另行核对与实测。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 3 列</code><br>STRING：起始IP
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 范围下界，IPv4 点分十进制。用 inet_addr 转换后再转为主机序整数比较，不是字符串排序。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 必须有效；不得为空、带端口或写 CIDR。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">第 4 列</code><br>STRING：结束IP
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 范围上界，包含该 IP。应不小于起始地址；单个 IP 的起止值相同。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 未发现对反向范围的自动修正；反向范围无法匹配。
|}

== 常用修改实例 ==
示例为局部教学片段，先备份原运行文件，再修改对应行并保留其余配置。教学值不是程序默认值。以下代码块保留真实 Tab；本地示例文件为 ASCII/CRLF，列名用英文便于核对分隔符。

=== 为测试网段扩大已存在的地区匹配范围 ===
修改前：
<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">INT INT STRING STRING
Index Region BeginIP EndIP
900001 1 192.168.50.10 192.168.50.10</pre>

修改后：
<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">INT INT STRING STRING
Index Region BeginIP EndIP
900001 1 192.168.50.0 192.168.50.255</pre>

教学行把单地址匹配扩大为整个 /24 范围，仍返回地区编号 1。1 是样本中存在的编号，但本例不承诺某个城市名称。保留自己目标行的索引和已核实的地区编号，先排除更靠前的重叠范围，再改两列边界；不能把四行示例覆盖整张表。900001 是教学索引，新增时必须换为未占用编号。

== 验证与排查 ==
用尚未记录地区编号的测试角色登录，核对 Login 日志的 Set IPRegion 值，并测试范围边界与不命中地址。预期首先是记录字段改变；同城频道的可见效果需要单独实测。恢复时还原文件并重启 Login，但这不会自动回滚已经写入角色的地区字段。

当前登录代码只在角色原 IPRegion 等于 -1 时查表赋值。因此已保存地区编号的老角色不会仅靠改表、重启或重新登录自动重新定位。没有匹配仍为 -1；不要为了试验直接清空角色数据。登录来源取 Login 套接字看到的来源地址，经代理时可能是代理地址。

== 关联与依据 ==
[[工程参考/配置文件/Server/IPRange.ini|Server/IPRange.ini]] · [[工程参考/配置文件/Server/LoginInfo.ini|Server/LoginInfo.ini]]

[[工程参考/配置文件索引|其他配置及整理状态]] · [[工程参考/服务端外网设置|服务端外网设置]] · [[Lua接口/服务端函数索引|Lua 接口索引]]

* <code style="white-space:normal;overflow-wrap:anywhere;">Common/DataBase/TLBB_DBC.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/DataBase/TLBB_DBC.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/LoginServer/Login/Main/IpTable.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/LoginServer/Login/Main/IpTable.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/LoginServer/Login/Main/Login.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/LoginServer/Login/Packets/WLRetCharLoginHandler.cpp</code>：实际加载、解析、字段使用或示例关联依据

本页核对源码读取、字段使用与样本格式，未启动游戏、服务端或数据库。解析验证不等于游戏实测；广播、权限、客户端交互等运行结果需要实测。
</div>
[[Category:工程参考]]

工程参考/配置文件/Server/IPRegionTable.txt - 版本历史

雪舞：​维护配置文件知识库：完整字段、读取范围、手工修改实例与核对状态

雪舞：维护配置文件知识库：完整字段、读取范围、手工修改实例与核对状态