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

2026-09-09T14:10:10Z

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

新页面

{{DISPLAYTITLE:<span style="font-size:24px;line-height:1.4;overflow-wrap:anywhere;">工程参考/配置文件/Server/IPRange.ini</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;">
[[首页|首页]] · [[工程参考/配置文件索引|配置文件索引]] · [[工程参考/配置文件修改约定|修改约定]]

IPRange.ini 检查连接游戏端口的来源 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/IPRange.ini</code>，相对于读取程序的工作目录。源码 resources/Server/Config 是样本位置，实际部署可能另有副本。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 读取程序
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | Server 游戏进程
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 生效方法
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 正常保存并停服后，重启读取此文件的 Server。多份运行目录分别核对。当前检索未发现单独重载本文件的可用入口；不需要把本文件复制到玩家客户端。
|-
| 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。
|}

[enableip] 是允许列表，[disableip] 是拒绝列表，每组各自有 count、ip0/mask0 等条目。实际判断先检查拒绝列表，再检查允许列表；都没命中也拒绝。

== 文件格式 ==
使用 [节名] 与 Key=Value，节名和键名区分大小写，保持节标题位于行首。用单独一行分号写注释，保留原编码及 CRLF 换行；重复节或键取先匹配项，不依赖后写覆盖。缺项、空值与 0 分别按下表处理。

== 字段详解 ==
模板 [n] 表示从 0 开始的序号，写入时应展开为实际数字；不是字面键名。

=== [enableip] ===
{| 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;">count</code><br>整数，0 到 256
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 本组读取的网段条目数，序号 n 从 0 到 count-1，必须连续。两组各有 256 条容量，源码未对循环提供可靠上限防护。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 必填。0 会使所有连接都无法通过允许检查，不代表开放全部 IP。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">ip[n]</code><br>IPv4 点分十进制
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 与 mask[n] 配对。按 (来源IP & 掩码) == (配置IP & 掩码) 匹配网段；填写网段地址便于核对。这里是连接来源地址，不是下发给客户端的入口地址。
| 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;">mask[n]</code><br>IPv4 子网掩码
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 255.255.255.255 只匹配一个 IP；255.255.255.0 匹配 /24 网段；0.0.0.0 匹配所有 IPv4。因此拒绝列表里使用全零掩码会拒绝全部连接。不能填写 /24、CIDR 或星号。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 启用序号范围内必填；缺项会触发读取错误，不使用教学值作为默认值。
|}

=== [disableip] ===
{| 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;">count</code><br>整数，0 到 256
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 本组读取的网段条目数，序号 n 从 0 到 count-1，必须连续。两组各有 256 条容量，源码未对循环提供可靠上限防护。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 必填。0 表示没有拒绝网段，仍需命中允许列表。
|-
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | <code style="white-space:normal;overflow-wrap:anywhere;">ip[n]</code><br>IPv4 点分十进制
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 与 mask[n] 配对。按 (来源IP & 掩码) == (配置IP & 掩码) 匹配网段；填写网段地址便于核对。这里是连接来源地址，不是下发给客户端的入口地址。
| 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;">mask[n]</code><br>IPv4 子网掩码
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 255.255.255.255 只匹配一个 IP；255.255.255.0 匹配 /24 网段；0.0.0.0 匹配所有 IPv4。因此拒绝列表里使用全零掩码会拒绝全部连接。不能填写 /24、CIDR 或星号。
| style="padding:8px;vertical-align:top;overflow-wrap:anywhere;" | 启用序号范围内必填；缺项会触发读取错误，不使用教学值作为默认值。
|}

== 常用修改实例 ==
示例为局部教学片段，先备份原运行文件，再修改对应行并保留其余配置。教学值不是程序默认值。

=== 只允许本机与一个局域网网段连接游戏 ===
修改前：
<pre style="white-space:pre-wrap;overflow-wrap:anywhere;font-size:13px;line-height:1.7;padding:12px;background:#f5f7f8;border:1px solid #dbe3e6;">[enableip]
count=1
ip0=0.0.0.0
mask0=0.0.0.0
[disableip]
count=0</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;">[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</pre>

教学原状态允许所有 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/ServerInfo.ini]] · [[工程参考/配置文件/Server/BillingInfo.ini|Server/BillingInfo.ini]]

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

* <code style="white-space:normal;overflow-wrap:anywhere;">Common/ServerBase/Ini.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/ServerBase/Ini.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Common/ServerBase/FileDef.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Main/GameTable.cpp</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Main/GameTable.h</code>：实际加载、解析、字段使用或示例关联依据
* <code style="white-space:normal;overflow-wrap:anywhere;">Server/Server/GameServer/Server/Packets/CGConnectHandler.cpp</code>：实际加载、解析、字段使用或示例关联依据

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

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

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

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