工程参考/配置文件/Server/IPRange.ini
IPRange.ini 检查连接游戏端口的来源 IP。已经能登录账号、但进入游戏连接失败时，这份名单是排查项之一；它不会设置服务器公网地址或路由器端口转发。
文件位置与生效
| 项目 | 说明 |
|---|---|
| 运行文件 | ./Config/IPRange.ini，相对于读取程序的工作目录。源码 resources/Server/Config 是样本位置，实际部署可能另有副本。
|
| 读取程序 | Server 游戏进程 |
| 生效方法 | 正常保存并停服后，重启读取此文件的 Server。多份运行目录分别核对。当前检索未发现单独重载本文件的可用入口；不需要把本文件复制到玩家客户端。 |
| 样本格式 | GB18030-compatible，CRLF。保留原编码；源码读取器不会自动把中文转为 UTF-8。
|
[enableip] 是允许列表，[disableip] 是拒绝列表，每组各自有 count、ip0/mask0 等条目。实际判断先检查拒绝列表，再检查允许列表；都没命中也拒绝。
文件格式
使用 [节名] 与 Key=Value，节名和键名区分大小写，保持节标题位于行首。用单独一行分号写注释，保留原编码及 CRLF 换行；重复节或键取先匹配项，不依赖后写覆盖。缺项、空值与 0 分别按下表处理。
字段详解
模板 [n] 表示从 0 开始的序号，写入时应展开为实际数字；不是字面键名。
[enableip]
| 字段与类型 | 含义与修改要点 | 缺项或特殊值 |
|---|---|---|
count整数，0 到 256 |
本组读取的网段条目数，序号 n 从 0 到 count-1，必须连续。两组各有 256 条容量，源码未对循环提供可靠上限防护。 | 必填。0 会使所有连接都无法通过允许检查，不代表开放全部 IP。 |
ip[n]IPv4 点分十进制 |
与 mask[n] 配对。按 (来源IP & 掩码) == (配置IP & 掩码) 匹配网段；填写网段地址便于核对。这里是连接来源地址，不是下发给客户端的入口地址。 | 启用序号范围内必填；缺项会触发读取错误，不使用教学值作为默认值。 |
mask[n]IPv4 子网掩码 |
255.255.255.255 只匹配一个 IP；255.255.255.0 匹配 /24 网段；0.0.0.0 匹配所有 IPv4。因此拒绝列表里使用全零掩码会拒绝全部连接。不能填写 /24、CIDR 或星号。 | 启用序号范围内必填；缺项会触发读取错误，不使用教学值作为默认值。 |
[disableip]
| 字段与类型 | 含义与修改要点 | 缺项或特殊值 |
|---|---|---|
count整数，0 到 256 |
本组读取的网段条目数，序号 n 从 0 到 count-1，必须连续。两组各有 256 条容量，源码未对循环提供可靠上限防护。 | 必填。0 表示没有拒绝网段，仍需命中允许列表。 |
ip[n]IPv4 点分十进制 |
与 mask[n] 配对。按 (来源IP & 掩码) == (配置IP & 掩码) 匹配网段；填写网段地址便于核对。这里是连接来源地址，不是下发给客户端的入口地址。 | 启用序号范围内必填；缺项会触发读取错误，不使用教学值作为默认值。 |
mask[n]IPv4 子网掩码 |
255.255.255.255 只匹配一个 IP；255.255.255.0 匹配 /24 网段；0.0.0.0 匹配所有 IPv4。因此拒绝列表里使用全零掩码会拒绝全部连接。不能填写 /24、CIDR 或星号。 | 启用序号范围内必填；缺项会触发读取错误，不使用教学值作为默认值。 |
常用修改实例
示例为局部教学片段，先备份原运行文件，再修改对应行并保留其余配置。教学值不是程序默认值。
只允许本机与一个局域网网段连接游戏
修改前：
[enableip] count=1 ip0=0.0.0.0 mask0=0.0.0.0 [disableip] count=0
修改后：
[enableip] count=2 ip0=127.0.0.1 mask0=255.255.255.255 ip1=192.168.50.0 mask1=255.255.255.0 [disableip] count=0
教学原状态允许所有 IPv4，修改后只允许本机回环及 192.168.50.0/24。将网段替换为实际客户端来源网段。若原环境有其他有效允许项或拒绝项，应保留并重新计算 count；不能照例清空自己的拒绝列表。经路由器或代理连接时以 Server 实际看到的来源 IP 为准。这个局域网例子会挡住其他公网来源，不适合作为公网开放配置。
验证与排查
检查两组数量和每一对掩码，再从允许网段、拒绝网段分别测试游戏连接。Server 日志中 CGConnect::Not active ip address 表示此检查没有通过。登录成功只说明登录阶段可达，仍需进入场景验证；失败后恢复备份并重启 Server。
公网开放时仍需先命中允许列表；允许列表的一条 ip=0.0.0.0、mask=0.0.0.0 表示允许所有 IPv4，但拒绝列表仍优先。该做法不会自动打开 Windows 防火墙或路由器。不要填域名、IPv6、端口或空字符串；inet_addr 转换失败不会替你创建合法规则。
关联与依据
Server/ServerInfo.ini · Server/BillingInfo.ini
其他配置及整理状态 · 服务端外网设置 · Lua 接口索引
Common/ServerBase/Ini.cpp：实际加载、解析、字段使用或示例关联依据Common/ServerBase/Ini.h：实际加载、解析、字段使用或示例关联依据Common/ServerBase/FileDef.h：实际加载、解析、字段使用或示例关联依据Server/Server/GameServer/Server/Main/GameTable.cpp：实际加载、解析、字段使用或示例关联依据Server/Server/GameServer/Server/Main/GameTable.h：实际加载、解析、字段使用或示例关联依据Server/Server/GameServer/Server/Packets/CGConnectHandler.cpp：实际加载、解析、字段使用或示例关联依据
本页核对源码读取、字段使用与样本格式，未启动游戏、服务端或数据库。解析验证不等于游戏实测；广播、权限、客户端交互等运行结果需要实测。
