工程参考/配置文件/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：实际加载、解析、字段使用或示例关联依据

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

检索自“https://www.waylee.net/index.php?title=工程参考/配置文件/Server/IPRegionTable.txt&oldid=1251”