地区管理
一句话:本页提供内置的行政区划树(省 / 市 / 区县)与一个 IP 归属地查询小工具。地区数据是系统自带的只读数据,本页没有增删改。
功能在哪
- 菜单路径:系统管理 → 地区管理
- 地址栏路由:
/system/area - 权限:无独立权限标识——能看到菜单就能用(IP 查询按钮也不额外鉴权)

界面认识
| 区域 | 作用 |
|---|---|
| 工具条 | 只有一个「IP 查询」按钮 |
| 列表 | 虚拟滚动的树表,两列:编号 / 地名。默认只展示根节点,点行首三角逐级展开(中国 → 省 → 市 → 区县) |
编号是有规律的
省级编号以 0000 结尾(如 110000 北京市、320000 江苏省),市级以 00 结尾(如 320100 南京市)。业务表里存地区时通常存这个编号,界面再按编号翻译成地名。
常用操作
查 IP 归属地
- 点「IP 查询」;
- 输入 IPv4 地址(必填,空提交报「IP 地址不能为空」);
- 点「确定」,「地址」框只读展示结果(如
江苏省 南京市),提示「查询成功」。

查询走后端本地库,不联网
归属地解析在服务端用内置 IP 库完成,断外网也能查;结果是区县级精度的估算值,运营商机房 IP 可能落到省会。
浏览行政区划
纯浏览:逐级展开即可。数据由系统初始化写入,本页不提供新增/修改/删除——需要维护地区数据属于后端数据初始化范畴,不在界面能力内。
字段说明
| 字段 | 必填 | 校验 | 说明 |
|---|---|---|---|
| IP | 是 | 「IP 地址不能为空」;非法格式由后端报错 | 仅 IPv4 |
| 地址 | — | 只读 | 展示查询结果 |
视角对照
| 视角 | 看到什么 |
|---|---|
| 所有能进系统管理的角色 | 同一份只读地区树与 IP 查询 |
套餐受限租户 aoteman@test | 套餐未勾该菜单时侧边栏无入口 |
进阶
- 字典管理:下拉选项的源头;地区是树形结构化数据,与字典是两套体系,别混用;
- 业务侧(如收货地址选择器)按编号取地区树,接口与本页同源。
常见问题
Q:为什么没有「新增」按钮? A:地区数据是内置只读数据。本页的定位是「查」而不是「维护」。
Q:IP 查询结果和实际不符? A:本地 IP 库为区县级估算;新分配的 IP 段、NAT 出口 IP 都可能偏差。需要精确归属请结合业务侧风控数据。
Q:列表第一行只有「中国」? A:树默认折叠到根。点行首三角展开,或用本页数据接口直接取某一级。
