產生 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-zht、check-8.8.8.8-ja-red。myip 沒有國家，所以不能加語言段。

顏色名

blue（預設）、green、gray、red、yellow、orange、purple、black、sky、cyan、emerald、rose。雙段徽章裡顏色用在右段（國家那一段），單段徽章整塊變色。

十六進位顏色

6 位十六進位，不含 #，如 16a34a。適合對齊品牌色或主題色；顏色較淺時文字自動換成深色，確保看得清。例：check-ip-zht-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 回應與註冊資訊。