生成 IP 徽章

徽章显示什么

一枚徽章就是一张很小的 SVG 图片，嵌进页面后由我们的服务器实时生成，不需要写任何脚本。

• IP、国家简称和国家名

  左边是 IP 地址，右边（双段样式）是两位国家简称，如 US、JP。地址里加语言段（-zh、-zht、-en、-ja、-ru、-fa、-tr），右边就变成「简称 + 国家名」，如 US 美国。国家来自 IP 归属数据库，是估算值；查不到或额度用完时显示 --。

• 三种样式、十二种颜色

  只显示访客 IP（单段）、访客 IP + 国家、指定 IP + 国家。颜色可选 12 个名字（blue、green、gray、red、yellow、orange、purple、black、sky、cyan、emerald、rose），也可以填任意 6 位十六进制颜色，深浅色背景上的文字会自动换成黑或白。

• 缓存与限制

  数据库已有结果不会消耗新的国家查询额度；只有数据库未命中时才调用数据服务商。额度用完后，未收录 IP 的国家显示 --。

• 隐私

  不保存徽章访问者身份、访问次数或逐次访问历史，也不和账号关联。指定 IP 会写在图片地址中，请勿为需要保密的地址制作徽章。国家结果按 IP 去重保存，数据库未命中时才发送给 IP2Location.io 和 ipapi.is。

生成并嵌入 IP 徽章

1. 在「样式」里选一种：只显示访客 IP、访客 IP + 国家，或指定 IP + 国家（选这个要再填一个 IPv4 / IPv6 地址）。
2. 选了带国家的样式后，可以在「国家名语言」里选一种语言，右边就会显示简称加国家名；不选则只显示两位简称。
3. 点一个预设颜色，或在「自定义颜色」里填 6 位十六进制（不带 #，如 1a8cff）。下面的预览会实时更新。
4. 在「预览与嵌入代码」里复制你要的格式：图片地址、HTML、Markdown（GitHub README、文档）或 BBCode（论坛签名）。
5. 把代码粘贴到网页、README 或论坛签名里。访客 IP 徽章每个访问者看到的是自己的地址；想让所有人看到同一个 IP，用指定 IP 的样式。

徽章地址与选项详细说明

徽章的地址是 /api/tools/badge/[spec]，所有选项都写在最后这一段里，用连字符连起来。

myip

单段徽章，只显示访问者自己的 IP，输出最干净，适合 README 和状态页快速展示当前出口。例：myip、myip-gray。

check-ip

双段徽章：左边访问者自己的 IP，右边两位国家简称（如 US、JP）。例：check-ip、check-ip-green。

check-<IP>

双段徽章，查指定 IPv4 或 IPv6 的国家，适合在工单、告警和日志分析里把「可疑 IP」做成标签。例：check-8.8.8.8、check-2606:4700:4700::1111。

语言段：-zh、-zht、-en、-ja、-ru、-fa、-tr

放在 IP 之后、颜色之前，右边变成「简称 + 国家名」，如 US 美国。zh 简体中文、zht 繁体中文。例：check-ip-zh、check-8.8.8.8-ja-red。myip 没有国家，所以不能加语言段。

颜色名

blue（默认）、green、gray、red、yellow、orange、purple、black、sky、cyan、emerald、rose。双段徽章里颜色用在右段（国家那一段），单段徽章整块变色。

十六进制颜色

6 位十六进制，不带 #，如 16a34a。适合对齐品牌色或主题色；颜色较浅时文字自动换成深色，保证看得清。例：check-ip-zh-16a34a。

单段与双段、小屏幕

单段徽章最窄，适合手机和窄栏；双段徽章加了国家后更宽，加国家名后更宽。徽章是矢量图，按 HTML 的 height 缩放也不会糊。

HTML / Markdown / BBCode

HTML：<img src="…" alt="…">；Markdown：，用于 GitHub、GitLab 的文档；BBCode：[img]地址[/img]，用于大多数论坛签名。三种都用同一个图片地址。

缓存

访客 IP 徽章返回 private, no-store，不被缓存；指定 IP 的徽章返回 public, max-age=3600（1 小时），查不到国家时 max-age=60。

国家显示 --

IP 是内网或保留地址、数据库里没有它的国家，或当天的国家查询额度用完时，国家位置显示 --；额度每天重置。

地址不合法时

写法不对（如语言写错、颜色不是 12 个名字也不是 6 位十六进制、IP 不合法）会返回一枚灰色的 invalid 徽章，而不是空白图。

IP 徽章常见问题

更多免费工具

• 我的 IP 地址查看你当前连接使用的公网 IP，以及它的归属地、所属网络和连接类型。
• IP 地址查询查看你的公网 IP，或查询任意 IP 地址的归属地、ASN、运营商和网络类型。
• IP 查 ASN（批量）一次粘贴最多 100 个 IPv4 / IPv6，批量查出所属的路由网段、ASN 和 AS 持有者，可导出 CSV。
• 域名检查输入域名，查看 DNS 记录、SSL 证书到期时间、网站的 HTTP 响应和注册信息。