IP 白名单
IP 白名单功能允许您限制 API Key 只能从指定的 IP 地址发起请求，有效提升 API 调用的安全性。该功能为全局生效，配置后对所有 API 请求均进行 IP 校验。
功能入口
在控制台左侧功能栏中，点击 IP 白名单 进入管理页面。
图1：左侧功能栏 - IP 白名单入口
添加 IP 地址
在 IP 白名单管理页面，点击「添加」按钮，可以添加允许访问的 IP 地址。
图2：IP 白名单管理页面 - 添加 IP
支持的格式
IP 白名单支持以下两种格式：
| 格式 | 示例 | 说明 |
|---|---|---|
| 单个 IP | 203.0.113.50 | 精确匹配单个 IP 地址 |
| CIDR | 192.168.1.0/24 | 匹配一个 IP 段，如 192.168.1.0 ~ 192.168.1.255 |
添加方式
方式一：单个添加
在输入框中输入单个 IP 或 CIDR 地址，点击「确定」即可添加。
图3：单个添加 IP 地址
方式二：批量导入
点击「批量导入」按钮，支持以文本方式批量导入多个 IP 地址或 CIDR，每行一个。
图4：批量导入 IP 地址
注意事项
注意
- IP 白名单为全局配置，开启后对所有 API Key 的请求均生效。
- 添加白名单前，请确保已将您当前使用的 IP 地址加入列表，否则会导致 API 请求被拒绝。
- 如果白名单列表为空，则不进行 IP 限制，所有 IP 均可访问。
- 修改白名单后立即生效，无需重启服务。
常见问题
Q：添加白名单后 API 请求返回 403 错误怎么办？
请检查发起请求的服务器 IP 是否已添加到白名单中。如果您使用了代理或负载均衡器，请确保添加的是出口 IP 地址。
Q：CIDR 格式如何计算 IP 范围？
CIDR 中 / 后的数字表示网络前缀长度。常见示例：
/32— 单个 IP（等同于直接填写 IP）/24— 256 个 IP（如10.0.0.0/24匹配10.0.0.0~10.0.0.255）/16— 65,536 个 IP（如10.0.0.0/16匹配10.0.0.0~10.0.255.255）
Q：批量导入有数量限制吗？
单次批量导入建议不超过 500 条，如需添加更多，可以分批次导入。