IP徽章
下面演示几种最常用的网页嵌入方式：仅显示 IP、显示国家简称、显示中文国家名、指定 IP 查询、以及带颜色的“状态化”徽章。 每种方式都用一行展示，适合直接放到个人主页、后台面板、公告页或状态页中。
您当前的访问IP：
检测出口归属（简称）：
（例如 US/TW/JP）
检测出口归属（中文）：
查询指定IP（8.8.8.8）：
查询指定IP（中文）：
状态化展示（蓝色）：
（也可用 hex：/check-ip-zh-ff0000）
只展示访问者 IP（单段徽章），输出最干净；适合 README、状态页快速展示当前出口。
<img src="https://s.ipin.io/myip" alt="我的IP" />通过路由末尾加 -blue/-green/-gray 等控制背景色，让徽章更贴合页面主题。
<img src="https://s.ipin.io/myip-gray" alt="我的IP（灰色）" />支持 6 位十六进制颜色（不带 #），用于严格匹配品牌色/主题色。
<img src="https://s.ipin.io/myip-111827" alt="我的IP（自定义色）" />展示访问者 IP + 国家简称 country_code（如 US/TW/JP），适合面板与状态页快速识别出口归属。
<img src="https://s.ipin.io/check-ip" alt="IP + 国家简称" />在末尾追加 -blue/-green 等改变右侧结果块颜色，常用于“状态语义化”展示。
<img src="https://s.ipin.io/check-ip-blue" alt="IP + 简称（蓝色）" />用 6 位 hex 自定义右侧结果块颜色，适合对齐主题色或按风控等级配色。
<img src="https://s.ipin.io/check-ip-16a34a" alt="IP + 简称（自定义绿）" />查询并展示指定 IP 的国家简称，适合工单、告警、日志分析中将“可疑 IP”可视化。
<img src="https://s.ipin.io/check-8.8.8.8" alt="8.8.8.8 + 国家简称" />指定 IP 并加颜色后缀，可用于把风险等级“上色”（如 red=高风险、yellow=关注）。
<img src="https://s.ipin.io/check-8.8.8.8-red" alt="8.8.8.8（红色）" />当路由带 -zh/-en/-ja 等语言段时，右侧会显示“简称 + 国家名称”。默认不带语言不会输出国家名。
<img src="https://s.ipin.io/check-ip-zh" alt="IP + 简称 + 国家名（中文）" />语言段和颜色段可叠加：/check-ip-zh-blue，常用于不同语言页面统一风格。颜色参数：sky cyan green emerald yellow orange red rose gray black
<img src="https://s.ipin.io/check-ip-zh-blue" alt="中文国家名（蓝色）" />查询指定 IP 并输出多语言国家名，适合把“告警 IP”嵌入工单或通知消息中，阅读者无需打开详情也能快速理解来源国家。
<img src="https://s.ipin.io/check-8.8.8.8-zh" alt="8.8.8.8 + 国家名（中文）" />指定 IP + 语言 + 颜色三段组合，最适合做“安全/风控等级”可视化：例如红色代表高风险，绿色代表白名单。
<img src="https://s.ipin.io/check-8.8.8.8-zh-green" alt="8.8.8.8（中文 + 绿色）" />IP徽章（IP Badge）工具介绍
IP徽章 是一个轻量级“图片化接口”，它把“访问者 IP（或你指定的 IP）”以及对应的
country_code（国家简称）、
country_name（国家名称，可选）
渲染成一张可直接嵌入的 SVG 徽章图片，并以
Content-Type: image/svg+xml
输出。与传统返回 JSON 的查询接口不同，SVG 徽章能像普通图片一样在 README、后台面板、监控大屏、状态页或任何支持
<img>
的地方直接展示，无需前端再加工渲染。
工具内置两段式徽章布局（类似 shields.io）：左侧通常显示 IP，右侧显示查询结果（国家简称或“简称 + 国家名”），并支持通过路由段控制颜色与语言。
数据来源上，IP 归属查询使用本地表
ip2location_db11
（按 IPv4 范围匹配得到 country_code），
多语言国家名通过
sys_lang_multi
按 vc_code 映射到
name_en / name_zh / name_ja ... 等字段（仅在路由带语言段时才输出国家名）。
同时，工具会尝试从常见代理头（例如 Cloudflare、X-Forwarded-For 等）解析客户端真实 IP，适合部署在 CDN / 反代 / 负载均衡之后的场景。
路由与返回内容：从最简到完整
IP徽章的核心使用方式是：把路由当作图片地址使用。你在浏览器直接打开路由会看到 SVG 徽章，
在 Markdown 或 HTML 中引用同一个地址则会以图片形式渲染。为了满足不同“信息密度”的展示需求，路由分为 “myip” 与 “check” 两大类：
myip 偏展示（只要 IP），check 偏查询（带国家信息）。
另外，只有当路由包含 -<lang> 时才会展示国家名称，
不带语言时仅展示简称，从而保持输出更短更像状态徽章。
GET /myip适用：展示当前服务器出口 IP、调试代理链是否透传、个人主页展示等。输出是单段徽章，仅包含 IP 文本。
GET /check-ip
适用：监控面板、状态页快速提示“出口归属国家”。右侧仅显示 country_code（如 US / TW / JP）。
GET /check-8.8.8.8适用：工单、告警、日志分析时把“可疑 IP”做成可视化标签，便于快速识别来源国家。
GET /check-ip-zh
适用：面向非技术人员或需要更可读展示的页面；右侧显示 country_code + country_name，例如 “US 美国”。
默认语言缺省时不会输出国家名，从而避免“过长徽章”。
GET /check-8.8.8.8-zh适用：安全运营、海外业务排查、客服工单系统等，把某个 IP 的国家信息以“图片徽章”形式嵌入任意页面或消息体中。
颜色控制（方案 B）：像 shields 一样在路由末尾加 -<color>
IP徽章支持在路由末尾追加 -<color> 控制徽章背景颜色（通常用于右侧结果区），
这与 shields.io 的使用体验一致：你可以用简单的颜色 token（如 blue/green/red/gray），也可以用 6 位十六进制颜色值（不带 #）。
这样你可以把徽章颜色与业务含义绑定起来，例如 “green=正常、yellow=需要关注、red=高风险”，让徽章不仅展示信息，还传递状态语义。
GET /check-ip-zh-blue
GET /check-8.8.8.8-greentoken 适合“快速选色”，例如 blue/green/red/orange/yellow/gray 等（以你控制器里的映射表为准）。
GET /check-ip-zh-ff0000
GET /check-8.8.8.8-16a34ahex 适合与站点主题色严格对齐，例如你后台系统主色或品牌色，保证整体 UI 统一。
GET /myip-gray
GET /myip-111827单段徽章常用于“展示”，加颜色可让它更贴合页面风格或在列表中更易辨识。
嵌入方式：Markdown / HTML / 监控面板都能直接用
因为 IP徽章输出的是 SVG 图片，所以最推荐的用法是“直接嵌入”。在 GitHub/GitLab README 或 Wiki 中，使用 Markdown 图片语法即可；
在任意网页或管理后台里，则用 <img> 标签引用即可。
这种方式最大的好处是：你不需要额外写前端逻辑，也不需要处理跨域 JSON、渲染模板或字体排版，浏览器天然就能把 SVG 当图片绘制出来。
<img src="https://s.ipin.io/check-8.8.8.8-zh-green" alt="IP徽章" />如果你要在大屏或状态页上同时展示很多个徽章（例如多个节点出口、多个 IP 情报），建议开启较长的缓存时间（例如 1 小时或更久）， 这样可以明显降低 DB 查询压力并提升加载速度；对于变化频率很低的 IP 归属信息，缓存收益非常高。
常见场景：让“IP 信息”变成可视化组件
IP徽章非常适合用于“展示型”需求：比如在运维状态页中把不同节点的出口 IP/国家信息做成一组徽章墙，一眼就能发现某个节点是否跑到了不应出现的地区；
在安全运营中把告警 IP 做成红色徽章嵌入工单或通知（例如 “US 美国”/“RU Russia”），让值班人员无需打开详情就能快速理解风险上下文；
在 CDN/反代链路调试时，访问 /myip 与 /check-ip
可以帮助你快速验证真实 IP 是否透传、是否被错误覆盖；在多语言后台或国际化 SaaS 中，通过 -zh/-en/-ja
让同一个 IP 在不同语言界面里显示不同国家名，从而减少前端多语言字典的维护成本。更进一步，你还可以把颜色与业务状态绑定，例如绿色代表“允许访问”、黄色代表“需要验证”、红色代表“封禁/高风险”，让徽章同时承担“信息 + 状态”的双重职责。
提示：如果你准备对公网开放，建议在反代或应用层做“可信代理头”策略，避免客户端伪造 X-Forwarded-For 等头部导致展示错误；同时建议给
ip2location_db11.ip_from 与
sys_lang_multi.vc_code 建索引，并配合缓存头提升性能与稳定性。
