Huy hiệu IP

IP Badge là một “API ảnh hoá” nhẹ, biến “IP người truy cập (hoặc IP bạn chỉ định)” cùng với country_code (mã quốc gia) và country_name (tên quốc gia, tuỳ chọn) thành một hình ảnh huy hiệu SVG có thể nhúng trực tiếp và trả về với Content-Type: image/svg+xml. Khác với API tra cứu truyền thống trả về JSON, huy hiệu SVG có thể hiển thị như ảnh thường trong README, bảng điều khiển quản trị, màn hình giám sát, trang trạng thái hoặc bất kỳ nơi nào hỗ trợ <img>, không cần xử lý/renderer thêm ở phía frontend.

Công cụ cung cấp bố cục huy hiệu 2 đoạn (giống shields.io): bên trái thường hiển thị IP, bên phải hiển thị kết quả (mã quốc gia hoặc “mã + tên quốc gia”), đồng thời hỗ trợ điều khiển màu và ngôn ngữ qua các đoạn route. Về nguồn dữ liệu: tra cứu quốc gia của IP dùng bảng cục bộ ip2location_db11 (khớp theo dải IPv4 để lấy country_code), còn tên quốc gia đa ngôn ngữ lấy từ sys_lang_multi bằng cách map theo vc_code tới các trường name_en / name_zh / name_ja ... (chỉ xuất tên quốc gia khi route có đoạn ngôn ngữ). Ngoài ra, công cụ sẽ cố gắng phân tích IP thực của client từ các header proxy phổ biến (ví dụ Cloudflare, X-Forwarded-For...), phù hợp khi triển khai sau CDN / reverse proxy / load balancer.

Cách dùng cốt lõi của IP Badge là: dùng route như một địa chỉ ảnh. Mở route trực tiếp trong trình duyệt sẽ thấy huy hiệu SVG, còn nhúng cùng địa chỉ đó vào Markdown hoặc HTML thì sẽ được render như ảnh. Để đáp ứng nhu cầu hiển thị với mức “đậm đặc thông tin” khác nhau, route được chia thành hai nhóm: myip và check: myip thiên về hiển thị (chỉ IP), check thiên về tra cứu (kèm thông tin quốc gia). Ngoài ra, chỉ khi route có -<lang> thì mới hiển thị tên quốc gia; không có ngôn ngữ thì chỉ hiển thị mã, giúp badge ngắn gọn và giống “status badge” hơn.

GET /myip

GET /check-ip

GET /check-8.8.8.8

GET /check-ip-zh

GET /check-8.8.8.8-zh

IP Badge hỗ trợ thêm -<color> ở cuối route để điều khiển màu nền (thường là vùng kết quả bên phải), tương tự trải nghiệm của shields.io: bạn có thể dùng token màu đơn giản (blue/green/red/gray) hoặc màu hex 6 ký tự (không có #). Nhờ đó bạn có thể gắn màu với ý nghĩa nghiệp vụ, ví dụ “green = bình thường, yellow = cần chú ý, red = rủi ro cao”, để badge vừa hiển thị thông tin vừa truyền tải trạng thái.

Vì IP Badge trả về ảnh SVG nên cách khuyến nghị nhất là “nhúng trực tiếp”. Trong README/Wiki của GitHub/GitLab, chỉ cần dùng cú pháp ảnh của Markdown; trong bất kỳ trang web hay hệ thống quản trị nào, dùng thẻ <img> để tham chiếu là xong. Lợi ích lớn nhất là: không cần viết thêm logic frontend, không cần xử lý JSON CORS, render template hay typography — trình duyệt tự nhiên vẽ SVG như một ảnh.

![IP Badge](https://s.ipin.io/check-ip-zh-blue)

<img src="https://s.ipin.io/check-8.8.8.8-zh-green" alt="IP Badge" />

IP Badge rất phù hợp cho nhu cầu “trình bày/hiển thị”. Ví dụ, trên trang trạng thái vận hành, bạn có thể biến IP/ quốc gia điểm thoát của từng node thành một “bức tường badge”, nhìn một cái là phát hiện node nào đang chạy sang khu vực không mong muốn. Trong vận hành an ninh, bạn có thể biến IP cảnh báo thành badge màu đỏ và nhúng vào ticket hoặc thông báo (ví dụ “US United States” / “RU Russia”), giúp người trực ca hiểu nhanh bối cảnh rủi ro mà không cần mở chi tiết. Khi debug chuỗi CDN/reverse proxy, truy cập /myip và /check-ip giúp bạn xác minh nhanh IP thực có được truyền qua hay bị ghi đè sai. Trong hệ thống quản trị đa ngôn ngữ hoặc SaaS quốc tế, thông qua -zh/-en/-ja bạn có thể hiển thị tên quốc gia theo ngôn ngữ giao diện, giảm chi phí bảo trì từ điển i18n phía frontend. Xa hơn nữa, bạn có thể gắn màu với trạng thái nghiệp vụ — xanh lá = “cho phép”, vàng = “cần xác minh”, đỏ = “chặn/rủi ro cao” — để badge đồng thời đảm nhiệm “thông tin + trạng thái”.

Gợi ý: nếu bạn định mở ra Internet, nên áp dụng chính sách “proxy header đáng tin cậy” ở reverse proxy hoặc tầng ứng dụng để tránh client giả mạo header như X-Forwarded-For gây hiển thị sai; đồng thời nên tạo index cho ip2location_db11.ip_from và sys_lang_multi.vc_code, và kết hợp header cache để tăng hiệu năng và độ ổn định.