Значок IP

Значок IP: указанный IP + название страны на китайском

Значок IP: указанный IP + китайский + цвет

Частые способы (отображение на странице)

Ниже показаны самые распространённые варианты встраивания на веб-страницу: отображать только IP, отображать код страны, отображать название страны на китайском, запрос по указанному IP, а также “статусные” бейджи с цветом. Каждый вариант показан одной строкой — удобно вставлять прямо на личную страницу, в админ-панель, на страницу объявлений или страницу статуса.

Ваш текущий IP: IP-бейдж: мой IP

Определить egress (код): IP-бейдж: IP + код страны （например US/TW/JP）

Определить egress (китайский): IP-бейдж: название страны на китайском

Запрос по указанному IP (8.8.8.8): IP-бейдж: 8.8.8.8 + код страны

Запрос по указанному IP (китайский): IP-бейдж: 8.8.8.8 (китайский)

Статусное отображение (синий): IP-бейдж: китайский + синий （можно и hex: /check-ip-zh-ff0000）

Удобно для маленьких экранов: IP-бейдж: перенос строки на маленьком экране

Односегментный бейдж (IP)

Показывает только IP посетителя (один сегмент) — самый “чистый” вывод; подходит для README и страниц статуса, чтобы быстро показать текущий egress.

<img src="https://s.ipin.io/myip" alt="Мой IP" />

Односегментный бейдж (IP) + цвет (token)

Добавьте в конце маршрута -blue/-green/-gray и т. п., чтобы управлять фоном и подогнать бейдж под тему страницы.

<img src="https://s.ipin.io/myip-gray" alt="Мой IP (серый)" />

Односегментный бейдж (IP) + цвет (hex)

Поддерживаются 6-значные hex-цвета (без #) для точного соответствия фирменным/тематическим цветам.

<img src="https://s.ipin.io/myip-111827" alt="Мой IP (кастомный цвет)" />

Двухсегментный бейдж (IP клиента + код страны)

Показывает IP посетителя + код страны country_code (например US/TW/JP). Удобно для панелей и страниц статуса, чтобы быстро понимать принадлежность egress.

<img src="https://s.ipin.io/check-ip" alt="IP + код страны" />

Двухсегментный бейдж (IP клиента + код) + цвет (token)

Добавьте в конце -blue/-green и т. п., чтобы изменить цвет правого блока результата — часто используется для “семантики статуса”.

<img src="https://s.ipin.io/check-ip-blue" alt="IP + код (синий)" />

Двухсегментный бейдж (IP клиента + код) + цвет (hex)

Используйте 6-значный hex, чтобы настроить цвет правого блока результата — удобно для выравнивания с темой или окраски по уровням риска.

<img src="https://s.ipin.io/check-ip-16a34a" alt="IP + код (кастомный зелёный)" />

Двухсегментный бейдж (указанный IP + код страны)

Запрашивает и показывает код страны для указанного IP — полезно, чтобы визуализировать “подозрительные IP” в тикетах, алертах и анализе логов.

<img src="https://s.ipin.io/check-8.8.8.8" alt="8.8.8.8 + код страны" />

Двухсегментный бейдж (указанный IP + код) + цвет

Если указать IP и добавить цветовой суффикс, можно “раскрасить” уровень риска (например, red = высокий риск, yellow = внимание).

<img src="https://s.ipin.io/check-8.8.8.8-red" alt="8.8.8.8 (красный)" />

Двухсегментный бейдж (IP клиента + код + название страны, мультиязычно)

Если маршрут содержит языковой сегмент -zh/-en/-ja и т. п., справа будет “код + название страны”. Без языка по умолчанию выводится только код страны.

<img src="https://s.ipin.io/check-ip-zh" alt="IP + код + название страны (китайский)" />

Двухсегментный бейдж (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 с выводом названия страны на выбранном языке. Подходит для вставки “алерт-IP” в тикеты или уведомления — читатель быстро поймёт страну источника без открытия деталей.

<img src="https://s.ipin.io/check-8.8.8.8-zh" alt="8.8.8.8 + название страны (китайский)" />

Двухсегментный бейдж (указанный IP + название страны) + цвет

Комбинация “указанный IP + язык + цвет” лучше всего подходит для визуализации “уровней безопасности/риска”: например, красный — высокий риск, зелёный — белый список.

<img src="https://s.ipin.io/check-8.8.8.8-zh-green" alt="8.8.8.8 (китайский + зелёный)" />

Обзор инструмента IP-бейдж (IP Badge)

IP-бейдж — это лёгкий “изображенческий API”: он берёт “IP посетителя (или указанный вами IP)” и соответствующие country_code (код страны), country_name (название страны, опционально), рендерит их в SVG-картинку бейджа, которую можно напрямую встраивать, и возвращает с Content-Type: image/svg+xml. В отличие от обычных API, которые возвращают JSON, SVG-бейдж можно показывать как обычное изображение в README, админ-панелях, на мониторинговых экранах, страницах статуса и в любом месте, где поддерживается <img>, без дополнительной отрисовки на фронтенде.

Инструмент использует двухсегментную компоновку бейджа (как у shields.io): слева обычно отображается IP, справа — результат (код страны или “код + название страны”), а цвет и язык задаются сегментами маршрута. По источникам данных: определение принадлежности IP использует локальную таблицу ip2location_db11 (сопоставление по диапазонам IPv4 для получения country_code), а многоязычные названия стран берутся из sys_lang_multi через сопоставление по vc_code к полям name_en / name_zh / name_ja ... (название страны выводится только если в маршруте указан языковой сегмент). Кроме того, инструмент пытается извлечь реальный IP клиента из распространённых прокси-заголовков (например Cloudflare, X-Forwarded-For), что удобно при размещении за CDN / reverse proxy / балансировщиком.

Маршруты и содержимое ответа: от минимального к полному

Ключевая идея IP-бейджа: использовать маршрут как адрес картинки. Открыв маршрут в браузере, вы увидите SVG-бейдж, а в Markdown или HTML тот же адрес будет отрисован как изображение. Для разных “плотностей информации” маршруты делятся на две группы: myip и check: myip — больше про отображение (только IP), check — про запрос (с информацией о стране). Кроме того, название страны показывается только если маршрут содержит -<lang>; без языка выводится только код страны, чтобы бейдж оставался коротким и “статусным”.

① Показать только IP посетителя (односегментный бейдж)

GET /myip

Подходит для: отображения текущего egress-IP сервера, проверки прокси-цепочки, личной страницы и т. п. Вывод — один сегмент, только текст IP.

② Показать IP посетителя + код страны (двухсегментный бейдж)

GET /check-ip

Подходит для: мониторинговых панелей и страниц статуса, чтобы быстро показать “страну egress”. Справа отображается только country_code (например US / TW / JP).

③ Запрос по указанному IP + код страны (двухсегментный бейдж)

GET /check-8.8.8.8

Подходит для: тикетов, алертов, анализа логов — визуализировать “подозрительный IP” как метку и быстро понимать страну источника.

④ Показать IP посетителя + код + название страны (с языком)

GET /check-ip-zh

Подходит для: страниц для нетехнических пользователей или где нужна лучшая читаемость. Справа будет country_code + country_name, например “US United States”. Если язык не задан, название страны не выводится, чтобы не делать бейдж слишком длинным.

⑤ Запрос по указанному IP + код + название страны (с языком)

GET /check-8.8.8.8-zh

Подходит для: SOC/безопасности, международных расследований, систем поддержки — встраивать информацию о стране IP как “картинку-бейдж” в любую страницу или тело сообщения.

Управление цветом (вариант B): добавьте -<color> в конце маршрута, как в shields

IP-бейдж поддерживает добавление -<color> в конце маршрута, чтобы управлять цветом фона (обычно правой части результата), по аналогии с shields.io: можно использовать простые токены (blue/green/red/gray) или 6-значный hex (без #). Это позволяет привязать цвет к бизнес-смыслу: например “green = нормально, yellow = внимание, red = высокий риск”, чтобы бейдж передавал не только информацию, но и статус.

Задать цвет token:
```
GET /check-ip-zh-blue

GET /check-8.8.8.8-green
```
Токены удобны для “быстрого выбора” цвета: blue/green/red/orange/yellow/gray и т. д. (в соответствии с вашей таблицей соответствий в контроллере).
Задать 6-значный hex (без #):
```
GET /check-ip-zh-ff0000

GET /check-8.8.8.8-16a34a
```
Hex удобен для точного совпадения с цветами темы/бренда — например, с основным цветом админ-панели, чтобы UI выглядел единообразно.
myip тоже поддерживает цвет:
```
GET /myip-gray

GET /myip-111827
```
Односегментные бейджи чаще используются “для отображения”; цвет помогает вписать их в стиль страницы или выделить в списке.

Встраивание: Markdown / HTML / мониторинговые панели — всё работает “из коробки”

Так как IP-бейдж отдаёт SVG-картинку, самый рекомендуемый способ — прямое встраивание. В README/Wiki GitHub или GitLab достаточно синтаксиса изображения в Markdown; на любой веб-странице или в админке используйте тег <img>. Главное преимущество: не нужно писать дополнительную логику на фронтенде и обрабатывать CORS-JSON, шаблоны или типографику — браузер сам рисует SVG как картинку.

Markdown (README/документация)

![IP-бейдж](https://s.ipin.io/check-ip-zh-blue)

HTML (веб/админка/страница объявлений)

<img src="https://s.ipin.io/check-8.8.8.8-zh-green" alt="IP-бейдж" />

Мониторинг/страница статуса (рекомендуется кэш)

Если вы хотите показывать много бейджей одновременно на экране мониторинга или странице статуса (например, несколько узлов/несколько IP-индикаторов), рекомендуется выставить более длительное время кэша (например, 1 час и больше). Это заметно снижает нагрузку на БД и ускоряет загрузку. Так как принадлежность IP меняется редко, кэш даёт большой выигрыш.

Типовые сценарии: превратите “IP-информацию” в визуальный компонент

IP-бейдж отлично подходит для “витринных” сценариев. Например, на странице статуса DevOps можно показать egress-IP/страны разных узлов стеной бейджей — и сразу увидеть, если какой-то узел “уехал” в неожиданную географию. В SOC/безопасности можно делать красные бейджи для алерт-IP и вставлять их в тикеты или уведомления (например “US United States” / “RU Russia”), чтобы дежурный быстро понял контекст риска без открытия деталей. При отладке цепочек CDN/reverse proxy доступ к /myip и /check-ip помогает быстро проверить, прокидывается ли реальный IP и не перезаписывается ли он ошибочно. В многоязычных админках и международных SaaS, добавляя -zh/-en/-ja, можно показывать разные названия стран для одного и того же IP в зависимости от языка интерфейса и снизить затраты на поддержку i18n-словарей на фронтенде. А если привязать цвет к статусу (зелёный = “разрешено”, жёлтый = “нужна проверка”, красный = “блок/высокий риск”), бейдж будет одновременно нести “информацию + статус”.

Подсказка: если вы планируете открывать это в интернет, рекомендуется настроить политику “доверенных прокси-заголовков” на уровне reverse proxy или приложения, чтобы клиенты не могли подделывать X-Forwarded-For и получать некорректное отображение. Также стоит добавить индексы для ip2location_db11.ip_from и sys_lang_multi.vc_code, и использовать заголовки кэширования для повышения производительности и стабильности.