IP 白名单功能允许您指定一组受信任的 IP 地址,只有这些 IP 发起的注册或登录请求才会被允许。当白名单启用后,所有不在白名单中的 IP 都将被拒绝访问,有效提升应用的安全性。
路径:控制台 → 进入具体应用 → 左侧导航「配置」→ 「安全设置」→ 「风险策略」→ 选择「P 白名单」
1. 功能概述
-
白名单中的 IP 地址允许进行注册和登录操作(限制类型固定为“允许注册/登录”)。
-
系统在处理请求时,会先检查黑名单,再检查白名单。
-
如果 IP 在黑名单中,直接拒绝。
-
如果 IP 不在黑名单中,但白名单已配置(至少一条记录),则只有白名单内的 IP 允许访问,其余 IP 全部拒绝。
-
如果白名单为空(未配置任何 IP),则不做白名单限制,所有 IP 均可访问(但仍受黑名单控制)。
-
-
所有配置以应用为维度独立管理,互不干扰。
2. 白名单列表页
列表页以表格形式展示所有已添加的 IP 白名单记录,支持搜索和分页。
| 字段 | 说明 | 示例 |
|---|---|---|
| IP | 被允许的 IP 地址 | 183.6.116.162 |
| 限制类型 | 固定为“允许注册/登录” | 允许注册/登录 |
| 添加时间 | 记录添加的时间,格式 YYYY-MM-DD HH:mm:ss,根据您浏览器的时区自动转换 |
2026-04-02 11:05:51 |
| 操作 | 提供“删除”按钮,点击可移除该 IP | [删除] |
列表操作:
-
搜索:列表左上角搜索框,支持对 IP 地址进行模糊搜索。
-
添加 IP:列表右上角 “+ 添加 IP” 按钮,点击弹出添加模态框。
3. 添加 IP 白名单
点击 “+ 添加 IP” 按钮后,弹出模态框,用于输入需要允许的 IP 地址。
3.1表单字段
| 字段 | 说明 | 必填 | 规则 |
|---|---|---|---|
| IP | 需要加入白名单的 IP 地址 | 是 | 支持单个 IP(如 123.45.67.89)或多个 IP,多个 IP 需用英文逗号分隔(例如 123.45.67.89, 203.0.113.5)。单次添加上限为 100 个 IP。 |
| 限制类型 | 固定为“允许注册/登录”,不可更改 | 是 | — |
3.2校验规则
-
输入时检查每个 IP 是否符合标准格式,以及英文逗号分隔是否正确。
-
提交后,系统会逐个处理 IP。对于已在白名单中的 IP,将自动跳过,不重复插入,且不会提示用户;仅新 IP 会被成功添加。
3.3保存与反馈
-
点击 “确定” 后,模态框关闭,列表立即刷新,展示所有成功添加的 IP(包括新添加的和已存在的,但已存在的不会重复显示)。
-
无论一次添加多少个 IP,列表中每个 IP 均展示为独立的记录,便于单独管理。
-
点击 “取消” 可关闭模态框,不执行任何操作。

生效时间提示:白名单配置添加成功后,最多需要 2 分钟 才能在全球生效。在此期间,新配置可能尚未完全同步到所有边缘节点,请稍后重试。
4. 删除 IP 白名单
-
在列表中找到需要删除的 IP,点击该行右侧的 “删除” 按钮。
-
弹出二次确认对话框:
-
点击 “确定” 后,该 IP 从白名单中移除,列表自动刷新;点击 “取消” 则放弃删除。
