下面演示几种最常用的网页嵌入方式：仅显示 IP、显示国家简称、显示中文国家名、指定 IP 查询、以及带颜色的“状态化”徽章。 每种方式都用一行展示，适合直接放到个人主页、后台面板、公告页或状态页中。 检测出口归属（简称）： （例如 US/TW/JP） 查询指定IP（8.8.8.8）： 状态化展示（蓝色）： （也可用 hex：/check-ip-zh-ff0000） 只展示访问者 IP（单段徽章），输出最干净；适合 README、状态页快速展示当前出口。 通过路由末尾加 -blue/-green/-gray 等控制背景色，让徽章更贴合页面主题。 支持 6 位十六进制颜色（不带 #），用于严格匹配品牌色/主题色。 展示访问者 IP + 国家简称 country_code （如 US/TW/JP），适合面板与状态页快速识别出口归属。 在末尾追加 -blue/-green 等改变右侧结果块颜色，常用于“状态语义化”展示。 用 6 位 hex 自定义右侧结果块颜色，适合对齐主题色或按风控等级配色。 查询并展示指定 IP 的国家简称，适合工单、告警、日志分析中将“可疑 IP”可视化。 指定 IP 并加颜色后缀，可用于把风险等级“上色”（如 red=高风险、yellow=关注）。 当路由带 -zh/-en/-ja 等语言段时，右侧会显示“简称 + 国家名称”。默认不带语言不会输出国家名。 语言段和颜色段可叠加： /check-ip-zh-blue ，常用于不同语言页面统一风格。颜色参数： sky cyan green emerald yellow orange red rose gray black 查询指定 IP 并输出多语言国家名，适合把“告警 IP”嵌入工单或通知消息中，阅读者无需打开详情也能快速理解来源国家。 指定 IP + 语言 + 颜色三段组合，最适合做“安全/风控等级”可视化：例如红色代表高风险，绿色代表白名单。 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> 时才会展示国家名称， 不带语言时仅展示简称，从而保持输出更短更像状态徽章。 适用：展示当前服务器出口 IP、调试代理链是否透传、个人主页展示等。输出是单段徽章，仅包含 IP 文本。 适用：监控面板、状态页快速提示“出口归属国家”。右侧仅显示 country_code （如 US / TW / JP）。 适用：工单、告警、日志分析时把“可疑 IP”做成可视化标签，便于快速识别来源国家。 适用：面向非技术人员或需要更可读展示的页面；右侧显示 country_code + country_name ，例如 “US 美国”。 默认语言缺省时不会输出国家名，从而避免“过长徽章”。 适用：安全运营、海外业务排查、客服工单系统等，把某个 IP 的国家信息以“图片徽章”形式嵌入任意页面或消息体中。 颜色控制（方案 B）：像 shields 一样在路由末尾加 -<color> IP徽章支持在路由末尾追加 -<color> 控制徽章背景颜色（通常用于右侧结果区）， 这与 shields.io 的使用体验一致：你可以用简单的颜色 token（如 blue/green/red/gray），也可以用 6 位十六进制颜色值（不带 #）。 这样你可以把徽章颜色与业务含义绑定起来，例如 “green=正常、yellow=需要关注、red=高风险”，让徽章不仅展示信息，还传递状态语义。 token 适合“快速选色”，例如 blue/green/red/orange/yellow/gray 等（以你控制器里的映射表为准）。 hex 适合与站点主题色严格对齐，例如你后台系统主色或品牌色，保证整体 UI 统一。 单段徽章常用于“展示”，加颜色可让它更贴合页面风格或在列表中更易辨识。 嵌入方式：Markdown / HTML / 监控面板都能直接用 因为 IP徽章输出的是 SVG 图片，所以 最推荐的用法是“直接嵌入” 。在 GitHub/GitLab README 或 Wiki 中，使用 Markdown 图片语法即可； 在任意网页或管理后台里，则用 <img> 标签引用即可。 这种方式最大的好处是：你不需要额外写前端逻辑，也不需要处理跨域 JSON、渲染模板或字体排版，浏览器天然就能把 SVG 当图片绘制出来。 如果你要在大屏或状态页上同时展示很多个徽章（例如多个节点出口、多个 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 建索引，并配合缓存头提升性能与稳定性。