GeoIP 与 GeoSite 数据库更新教程:路由规则不生效的排查思路

GeoIP 与 GeoSite 分别处理什么

在 v2rayN 中更新 Geo 文件

1. 确认内核类型

   打开「设置」→「参数设置」→「Core 类型」，确认当前配置实际使用 Xray 内核还是 V2Fly 内核。订阅名称里出现 VLESS 或 VMess，不等于已经确认了运行内核。

2. 打开更新入口

   回到主窗口，选择「检查更新」→「Geo files」。若当前版本显示为「更新 Geo 文件」，选择该项即可，不要误点“更新订阅”。

3. 等待写入完成

   观察消息区域，确认 geoip.dat 与 geosite.dat 都完成下载并写入。一次测试中两个文件合计约 11.9 MB，网络稳定时通常在 5 至 30 秒内结束。

4. 重启运行内核

   使用「重启服务」或先停止再启动当前配置。仅关闭设置窗口不会让已运行的内核重新加载数据文件。

5. 核对启动日志

   打开「日志」窗口，确认没有出现 load geosite、load geoip 或 failed to start 等信息，再测试目标域名的出站结果。

在 v2rayNG 中更新 Geo 文件

1. 检查文件地址

   进入右上角菜单的「设置」→「Geo files 设置」，检查 GeoIP 与 GeoSite 下载地址是否分别指向对应的 dat 文件，避免两个输入框填入同一个文件地址。

2. 执行数据更新

   返回主界面，打开右上角菜单并选择「更新 Geo files」。等待页面提示两份文件处理完成，中途不要强制结束客户端进程。

3. 重启连接服务

   断开当前连接，等待约 2 秒后重新连接。这样可以让 Xray 内核重新初始化路由模块并读取新文件。

4. 打开运行日志

   从主界面进入「日志」，搜索 geoip、geosite、routing 等关键词，确认启动阶段没有文件读取错误。

5. 复测目标连接

   先测试一个明确应直连的国内域名，再测试一个应走代理的域名。分别记录出口地址和连接耗时，避免只凭页面能否打开判断规则是否命中。

规则写法与匹配顺序检查

{
  "routing": {
    "domainStrategy": "IPIfNonMatch",
    "rules": [
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "domain": ["geosite:cn"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "ip": ["geoip:cn"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "network": "tcp,udp",
        "outboundTag": "proxy"
      }
    ]
  }
}

• geosite:cn 应写入域名条件，不应写入 IP 条件。
• geoip:cn 与 geoip:private 应写入 IP 条件。
• domain:example.com 用于匹配该域名及常见子域名范围，完整匹配可按内核支持的规则形式配置。
• 自定义数据标签必须真实存在于所用 dat 文件中，不能根据文件名猜测标签。
• 阻断规则、直连规则和代理规则要按具体范围从窄到宽排列，最后再放兜底规则。

启动报错与数据库异常排查

规则命中但仍然误分流

现象	优先检查	验证动作
国内域名进入代理	GeoSite 标签与规则顺序	把目标域名单独加入直连规则并置于宽泛代理规则之前
直接连接 IP 时未命中	GeoIP 条件与目标 IP 归属	记录目标 IP，再检查是否命中 geoip:cn 或私有地址集合
TUN 下结果与系统代理不同	嗅探、DNS 与 domainStrategy	保持节点不变，分别记录两种模式下日志中的目标域名和 IP
更新后只有部分规则失效	自定义标签是否存在	逐条停用扩展标签，保留 geosite:cn 与 geoip:cn 做基线测试
局域网设备无法访问	geoip:private 的位置	将私有 IP 直连规则放到代理兜底规则之前重新连接

更新后的完整验证清单

1. 确认 geoip.dat 与 geosite.dat 都存在，文件大小大于 0 字节，修改时间接近本次更新时刻。
2. 确认当前运行的是预期内核，v2rayN 可从「设置」→「参数设置」→「Core 类型」核对。
3. 断开并重新连接，确保旧内核进程已经退出，新进程重新读取资源文件。
4. 查看启动日志，排除 file not found、decode、list not found 等加载错误。
5. 检查 GeoSite 标签位于域名条件，GeoIP 标签位于 IP 条件，出站标签与现有配置一致。
6. 将私有地址、精确域名等窄规则放在宽泛代理兜底之前，避免提前命中。
7. 分别测试域名连接与直接 IP 连接，记录实际选择的出站，而不是只看页面是否打开。
8. 确认系统代理或 TUN 模式下的应用流量确实进入客户端，测试工具未绕过本地代理端口。