工程参考/配置文件/Server/IPRegionTable.txt
Login 用这张表把一个 IPv4 来源地址匹配到地区编号，保存到角色的 IPRegion。它不是访问允许名单，不决定玩家能否连接，也不会把玩家转发到某个 IP。
文件位置与生效
| 项目 | 说明 |
|---|---|
| 运行文件 | ./Config/IPRegionTable.txt，相对于读取程序的工作目录。源码 resources/Server/Config 是样本位置，实际部署可能另有副本。
|
| 读取程序 | Login |
| 生效方法 | 正常保存并停服后，重启读取此文件的 Login。多份运行目录分别核对。当前检索未发现单独重载本文件的可用入口；不需要把本文件复制到玩家客户端。 |
| 样本格式 | GB18030-compatible，CRLF。保留原编码；源码读取器不会自动把中文转为 UTF-8。
|
四列依次为记录索引、地区编号、起始 IPv4、结束 IPv4。范围含两端；按文件数据行顺序寻找第一条匹配，重叠时后面的条目不会覆盖前面的匹配。
文件格式
首行是类型行：INT INT STRING STRING；第二行是列名行，程序跳过其内容；从第三行开始读取数据。各列用真实 Tab 分隔，保留首列、空列及行尾，不用空格代替。数据行行首 # 表示注释，分号不是此表的注释规则。首列为空的行被跳过；不足的尾列补为空值，多余列不参与本页字段读取。空整数和非数字经 atoi 可能成为 0，空字符串仍为空，不把解析成功当作业务合法。第一列须唯一，重复会触发读取器错误。
字段详解
列号从 1 开始，源码列下标从 0 开始。
| 字段与类型 | 含义与修改要点 | 缺项或特殊值 |
|---|---|---|
第 1 列INT：Index |
DBC 记录索引，须唯一。地区匹配按行遍历，不拿这一列当地区编号或优先级数值。 | 非空；重复索引触发错误。 |
第 2 列INT：同城频道编号 |
匹配后写入角色 IPRegion 的整数标识。可按已经使用的地区编号建立新网段；不能凭数字猜城市名，也不是区服 ID 或场景 ID。样本编号不等于枚举的完整定义。 | 没有匹配返回 -1。频道名称、界面显示及其他使用端的映射需要另行核对与实测。 |
第 3 列STRING：起始IP |
范围下界，IPv4 点分十进制。用 inet_addr 转换后再转为主机序整数比较，不是字符串排序。 | 必须有效；不得为空、带端口或写 CIDR。 |
第 4 列STRING：结束IP |
范围上界，包含该 IP。应不小于起始地址；单个 IP 的起止值相同。 | 未发现对反向范围的自动修正；反向范围无法匹配。 |
常用修改实例
示例为局部教学片段，先备份原运行文件，再修改对应行并保留其余配置。教学值不是程序默认值。 以下代码块保留真实 Tab；本地示例文件为 ASCII/CRLF，列名用英文便于核对分隔符。
为测试网段扩大已存在的地区匹配范围
修改前：
INT INT STRING STRING Index Region BeginIP EndIP 900001 1 192.168.50.10 192.168.50.10
修改后：
INT INT STRING STRING Index Region BeginIP EndIP 900001 1 192.168.50.0 192.168.50.255
教学行把单地址匹配扩大为整个 /24 范围，仍返回地区编号 1。1 是样本中存在的编号，但本例不承诺某个城市名称。保留自己目标行的索引和已核实的地区编号，先排除更靠前的重叠范围，再改两列边界；不能把四行示例覆盖整张表。900001 是教学索引，新增时必须换为未占用编号。
验证与排查
用尚未记录地区编号的测试角色登录，核对 Login 日志的 Set IPRegion 值，并测试范围边界与不命中地址。预期首先是记录字段改变；同城频道的可见效果需要单独实测。恢复时还原文件并重启 Login，但这不会自动回滚已经写入角色的地区字段。
当前登录代码只在角色原 IPRegion 等于 -1 时查表赋值。因此已保存地区编号的老角色不会仅靠改表、重启或重新登录自动重新定位。没有匹配仍为 -1；不要为了试验直接清空角色数据。登录来源取 Login 套接字看到的来源地址，经代理时可能是代理地址。
关联与依据
Server/IPRange.ini · Server/LoginInfo.ini
其他配置及整理状态 · 服务端外网设置 · Lua 接口索引
Common/DataBase/TLBB_DBC.cpp：实际加载、解析、字段使用或示例关联依据Common/DataBase/TLBB_DBC.h：实际加载、解析、字段使用或示例关联依据Server/Server/LoginServer/Login/Main/IpTable.cpp：实际加载、解析、字段使用或示例关联依据Server/Server/LoginServer/Login/Main/IpTable.h：实际加载、解析、字段使用或示例关联依据Server/Server/LoginServer/Login/Main/Login.cpp：实际加载、解析、字段使用或示例关联依据Server/Server/LoginServer/Login/Packets/WLRetCharLoginHandler.cpp：实际加载、解析、字段使用或示例关联依据
本页核对源码读取、字段使用与样本格式，未启动游戏、服务端或数据库。解析验证不等于游戏实测；广播、权限、客户端交互等运行结果需要实测。
