# 系统 IP 地址

GAMEMONITORING 使用这些 IP 地址检查游戏服务器，并把 [Webhook 请求](https://gamemonitoring.cn/developers/docs/webhook#connect)投递到你的系统。

如果你的服务器、网站、WAF、CDN 或 bot protection 限制进入请求，请把它们加入 allowlist。

## 何时需要添加 {#when-needed}

- 游戏服务器只接受允许地址的请求；
- [Webhook 处理器](https://gamemonitoring.cn/developers/docs/webhook#handler-requirements)受 firewall、WAF 或 Cloudflare 保护；
- bot protection 会拦截自动请求；
- 主机服务商要求提供网络规则使用的 IP 列表。

## 使用示例 {#usage-example}

Webhook 示例：处理器地址是 `https://panel.example.com/gamemonitoring-webhook`，域名受 Cloudflare 保护。请把 GAMEMONITORING IP 地址加入该域名或精确路径的 allowlist，避免 Cloudflare 显示 challenge 或拦截 [Webhook `POST` 请求](https://gamemonitoring.cn/developers/docs/webhook#handler-requirements)。

游戏服务器示例：firewall 只允许可信地址访问 query 端口。请把 GAMEMONITORING IP 地址加入 query 端口规则，否则监控无法稳定检查在线状态和服务器状态。

## 配置允许列表 {#allowlist}

把上方列表中的 IP 地址交给系统管理员或主机服务商。规则必须允许这些地址向你的游戏服务器或 Webhook 处理器发送进入请求。

如果规则按路径配置，请限制到所需 endpoint，例如 `/gamemonitoring-webhook`。如果规则按端口配置，请只指定游戏 query 端口或接收 Webhook 的 web-server 端口。

## 配置后验证 {#verification}

修改规则后，发送测试请求或[测试 Webhook](https://gamemonitoring.cn/developers/docs/webhook#tests-resend)，并确认请求不再被拦截。

如果验证失败，请查看 firewall、WAF 或 Cloudflare 日志。日志中应包含源 IP、请求路径和拦截原因。通过这些信息可以判断域名、路径、端口或规则顺序是否遗漏。

## Cloudflare 配置 {#cloudflare}

如果 Webhook 处理器在 Cloudflare 后面，请把 GAMEMONITORING IP 地址加入一个跳过 WAF 检查的规则：

1. 登录 Cloudflare dashboard。
2. 选择需要的域名。
3. 打开 **Security**。
4. 选择 **WAF**。
5. 打开 **Custom rules**。
6. 点击 **Create rule**。
7. 设置清晰名称，例如 **Allow GAMEMONITORING**。
8. 在 **Field** 中选择 **IP Source Address**。
9. 在 **Operator** 中选择 **is in**。
10. 在 **Value** 中添加上方列表中的 IP 地址。
11. 在 **Choose action** 中选择 **Skip**。
12. 在 **WAF components to skip** 中选择会拦截处理器请求的检查。
13. 在 **Select order** 中选择 **First**。
14. 点击 **Deploy**。

如果配置后请求仍被拦截，请检查 firewall 或 Cloudflare 日志，并确认规则应用到了正确域名和处理器路径。

```http
GET https://api.gamemonitoring.cn/pages/system/ips
```
