← 返回首页深度篇
深度篇 · Enterprise · 企业版后台使用说明 > 安全管理

企业 IP 白名单怎么配:几条必须记住的规则

Enterprise | 更新于 2026-10-18

本篇涵盖的知识重点

网络设置路径

1 进入网络设置页面 2 梳理需要放行的出口 IP 清单 3 按格式规则录入 IP 与网段 4 保存后验证与持续维护 5 变更前准备好回滚方案
共 5 步,按编号顺序阅读

白名单规则要点

1进入网络设置页面

作用IP 白名单是企业级的准入闸门,入口找对才能做后续配置。

操作登录企业管理后台,在 企业设置 > 网络设置 菜单中找到 IP 白名单配置项。

注意需要企业管理员权限才能配置;页面具体字段名称以实际展示为准。

白名单作用的客户端形态
  • IDE:集成开发环境中的客户端形态
  • CLI:命令行形态
  • 插件:各类编辑器插件形态
  • 覆盖范围:作用于 WorkBuddy 和 CodeBuddy 的各种形态,被限制的 IP 将无法登录并使用
企业设置网络设置中的 IP 白名单配置项
图:在 企业设置 > 网络设置 中配置企业的 IP 白名单
2梳理需要放行的出口 IP 清单

作用白名单配错比不配更麻烦:一旦少配一个办公网出口,对应办公室的成员会集体无法使用。

操作先列清企业的固定出口:办公网出口、机房出口、VPN 地址池等,把每个需要放行的地址整理成清单。若某一类地址数量多且有连续段,优先用网段形式表达。

注意居家办公、移动网络这类动态地址无法预先枚举,把这些人纳入白名单范围时需特别谨慎。

3按格式规则录入 IP 与网段

作用格式不合规会让整条规则失效,是最常见的配置失败原因。

操作在白名单输入框中填写需要放行的 IP,填写完成后保存配置。

注意逗号必须是英文逗号且前后不留空格;不填写代表允许所有 IP 访问,而仅设置 127.0.0.1 则代表禁止所有 IP 访问,这两条最容易记反。

四条生效规则
  • 多个 IP 用英文逗号隔开,逗号前后不加空格
  • 仅设置 127.0.0.1 代表禁止所有 IP 访问,可作为临时全量封禁手段
  • 不填写则代表允许所有 IP 访问,等同于不启用限制
  • 设置 IP 段例如 10.10.10.0/24 代表允许该网段访问,适合出口地址成段的场景
4保存后验证与持续维护

作用白名单是企业准入策略,网络环境变化时需要同步更新,否则会陆续出现成员无法登录的反馈。

操作保存配置后,从清单内的网络与清单外的网络分别登录一次,确认限制按预期生效。后续办公网出口调整、VPN 地址池变更时,同步更新白名单清单。

注意被限制的 IP 将无法登录并使用,涉及 IDE、CLI、插件等全部形态;如需临时全量封禁,可仅设置 127.0.0.1。

5变更前准备好回滚方案

作用白名单影响面覆盖全员,一旦误配最快也要等管理员改回来,提前留一手能缩短故障时间。

操作变更前先把当前清单完整复制到变更记录中,再按评审过的清单执行变更;出现异常时直接恢复原清单。

注意被限制的 IP 将无法登录并使用,误配会立刻影响整个办公网;回滚就是恢复原清单,不要临时重新拼一份。

生效规则补充

配置与校验练习

练习1:梳理企业出口网段并生成白名单清单
提示词(点右上角「复制」,可直接发给 WorkBuddy)
```markdown
我要为企业配置 IP 白名单,请帮我设计一份网段梳理与清单生成方案。
必须依据的规则(不要新增规则):
- 配置入口为 企业设置 > 网络设置;
- 白名单作用于 WorkBuddy 和 CodeBuddy 的各种形态(IDE / CLI / 插件),被限制的 IP 将无法登录并使用;
- 多个 IP 用英文逗号隔开,逗号前后不加空格;
- 仅设置 127.0.0.1 代表禁止所有 IP 访问;
- 不填写则代表允许所有 IP 访问;
- 设置 IP 段例如 10.10.10.0/24 代表允许该网段访问。
我的场景:总部办公网出口为 3 个固定公网 IP;分部办公网使用一个 /24 网段;VPN 地址池是一个 /26 网段;另有 5 位长期出差的同事使用家庭宽带。
请输出:1)一张梳理表(来源 / 地址或网段 / 是否建议纳入白名单 / 理由);2)一段可直接粘贴到输入框的示例清单,严格使用英文逗号且不加空格,用占位符表示真实地址;3)一段针对出差同事这类动态地址的处理建议(不超过 150 字),说明纳入与不纳入各自的代价。
```
预期结果

得到一张梳理表、一段格式合规的示例清单(英文逗号、无空格、网段用 CIDR)和动态地址处理建议。

练习2:校验一批 IP 白名单填写是否符合格式
提示词(点右上角「复制」,可直接发给 WorkBuddy)
```markdown
我准备提交一份 IP 白名单配置,请帮我逐条校验是否符合规则并给出修正版本。
规则(严格按此判断):多个 IP 用英文逗号隔开,逗号前后不加空格;仅设置 127.0.0.1 代表禁止所有 IP 访问;不填写代表允许所有 IP 访问;IP 段用类似 10.10.10.0/24 的写法代表允许该网段访问。
待校验清单:
1. 203.0.113.10, 203.0.113.11
2. 203.0.113.10,203.0.113.11
3. 203.0.113.10;203.0.113.11
4. 10.10.10.0/24
5. 127.0.0.1
6. (留空)
7. 10.10.10.0/24, 192.0.2.7
请输出:1)一张校验表(编号 / 是否合规 / 违反哪条规则 / 实际生效效果 / 修正写法);2)一段给提交人的提示(不超过 150 字),重点提醒两个最容易记反的规则。
```
预期结果

得到逐条校验表和修正写法,能识别中文逗号、空格、分号等问题,并正确解释留空与仅填 127.0.0.1 的相反效果。

练习3:制定 IP 白名单变更的风险控制方案
提示词(点右上角「复制」,可直接发给 WorkBuddy)
```markdown
IP 白名单配错会导致成员集体无法登录,请帮我制定变更的风险控制方案。
已知事实(请严格按此设计,不要新增功能):
- 入口为 企业设置 > 网络设置;
- 白名单作用于 WorkBuddy 和 CodeBuddy 的各种形态(IDE / CLI / 插件),被限制的 IP 将无法登录并使用;
- 多个 IP 用英文逗号隔开,逗号前后不加空格;
- 仅设置 127.0.0.1 代表禁止所有 IP 访问;
- 不填写则代表允许所有 IP 访问;
- 设置 IP 段例如 10.10.10.0/24 代表允许该网段访问。
请输出:1)一份变更流程(申请—评审—备份原清单—灰度变更—验证—回滚),其中要明确回滚就是恢复原清单;2)一张「误配场景—影响面—应急动作」对照表,至少覆盖漏配某个办公网出口、误填 127.0.0.1、格式错误导致整体失效三类;3)一段变更通知模板(不超过 150 字),提醒成员在变更窗口内如遇无法登录应如何反馈。
```
预期结果

得到一份变更流程、一张误配场景对照表和一段通知模板,回滚方案明确且影响面描述准确。

参考文档:IP 白名单(WorkBuddy 官方文档)
本文基于官方文档再创作,具体以官方文档站实际展示为准。