Distintivo de IP
Abaixo demonstramos algumas das formas mais comuns de incorporação na web: exibir apenas o IP, exibir o código do país, exibir o nome do país em chinês, consultar um IP específico e usar badges “com estado” por meio de cores. Cada forma é mostrada em uma única linha, ideal para colocar diretamente em uma página pessoal, painel administrativo, página de avisos ou página de status.
Seu IP atual:
Detectar o egress (código):
(ex.: US/TW/JP)
Detectar o egress (chinês):
Consultar um IP específico (8.8.8.8):
Consultar um IP específico (chinês):
Exibição com status (azul):
(também pode usar hex: /check-ip-zh-ff0000)
Mostra apenas o IP do visitante (badge de um segmento), com a saída mais limpa; ideal para README ou páginas de status para exibir rapidamente o egress atual.
<img src="https://s.ipin.io/myip" alt="Meu IP" />Adicione ao final da rota -blue/-green/-gray etc. para controlar a cor de fundo e alinhar o badge ao tema da página.
<img src="https://s.ipin.io/myip-gray" alt="Meu IP (cinza)" />Suporta cores hexadecimais de 6 dígitos (sem #) para corresponder com precisão à cor da marca/tema.
<img src="https://s.ipin.io/myip-111827" alt="Meu IP (cor personalizada)" />Mostra o IP do visitante + o código do país country_code (ex.: US/TW/JP). Ideal para painéis e páginas de status para identificar rapidamente a origem do egress.
<img src="https://s.ipin.io/check-ip" alt="IP + código do país" />Acrescente -blue/-green etc. para mudar a cor do bloco de resultado à direita, muito usado para exibição “com semântica de status”.
<img src="https://s.ipin.io/check-ip-blue" alt="IP + código (azul)" />Use um hex de 6 dígitos para personalizar a cor do bloco de resultado à direita; ideal para alinhar ao tema ou colorir por níveis de risco.
<img src="https://s.ipin.io/check-ip-16a34a" alt="IP + código (verde personalizado)" />Consulta e mostra o código do país de um IP especificado; útil para visualizar “IPs suspeitos” em tickets, alertas e análises de logs.
<img src="https://s.ipin.io/check-8.8.8.8" alt="8.8.8.8 + código do país" />Ao especificar um IP e adicionar um sufixo de cor, você pode “colorir” o nível de risco (ex.: vermelho = alto risco, amarelo = atenção).
<img src="https://s.ipin.io/check-8.8.8.8-red" alt="8.8.8.8 (vermelho)" />Quando a rota inclui um segmento de idioma como -zh/-en/-ja, o lado direito mostra “código + nome do país”. Sem idioma, por padrão, o nome do país não é exibido.
<img src="https://s.ipin.io/check-ip-zh" alt="IP + código + nome do país (chinês)" />Idioma e cor podem ser combinados: /check-ip-zh-blue, útil para manter o estilo consistente em páginas de diferentes idiomas. Tokens de cor: sky cyan green emerald yellow orange red rose gray black
<img src="https://s.ipin.io/check-ip-zh-blue" alt="Nome do país em chinês (azul)" />Consulta um IP especificado e exibe o nome do país no idioma escolhido; ideal para inserir “IPs de alerta” em tickets ou notificações, permitindo entender rapidamente o país de origem sem abrir detalhes.
<img src="https://s.ipin.io/check-8.8.8.8-zh" alt="8.8.8.8 + nome do país (chinês)" />A combinação IP especificado + idioma + cor é a mais adequada para visualizar “níveis de segurança/risco”: por exemplo, vermelho = alto risco, verde = lista branca.
<img src="https://s.ipin.io/check-8.8.8.8-zh-green" alt="8.8.8.8 (chinês + verde)" />Introdução à ferramenta IP Badge (Badge de IP)
IP Badge é uma “API de imagem” leve que pega o “IP do visitante (ou um IP que você especificar)” e o respectivo
country_code (código do país) e
country_name (nome do país, opcional),
renderiza tudo em uma imagem SVG de badge diretamente incorporável e retorna com
Content-Type: image/svg+xml.
Diferente das APIs tradicionais que retornam JSON, o badge SVG pode ser exibido como uma imagem comum em README, painéis administrativos, telões de monitoramento, páginas de status ou em qualquer lugar que suporte
<img>,
sem precisar de renderização extra no front-end.
A ferramenta oferece um layout de badge em dois segmentos (estilo shields.io): à esquerda normalmente aparece o IP, e à direita o resultado (código do país ou “código + nome do país”), além de permitir controlar cor e idioma por segmentos da rota.
Sobre a fonte de dados, a consulta de pertencimento do IP usa a tabela local
ip2location_db11
(match por faixa IPv4 para obter country_code),
e o nome do país multilíngue vem de
sys_lang_multi,
mapeando por vc_code para campos como
name_en / name_zh / name_ja ...
(o nome do país só é exibido quando a rota inclui um segmento de idioma).
Além disso, a ferramenta tenta extrair o IP real do cliente a partir de cabeçalhos comuns de proxy (por exemplo, Cloudflare, X-Forwarded-For), sendo adequada para cenários atrás de CDN / reverse proxy / balanceadores.
Rotas e conteúdo retornado: do mínimo ao completo
O uso principal do IP Badge é: tratar a rota como um endereço de imagem. Ao abrir a rota no navegador, você verá o badge SVG;
ao referenciar a mesma URL em Markdown ou HTML, ela será renderizada como imagem. Para atender diferentes “densidades de informação”, as rotas se dividem em duas categorias: myip e check:
myip é mais voltado a exibição (só IP), e check a consulta (com informações de país).
Além disso, o nome do país só é exibido quando a rota inclui -<lang>;
sem idioma, apenas o código é exibido, mantendo o output mais curto e com cara de “badge de status”.
GET /myipIndicado para: mostrar o IP de saída atual do servidor, depurar se a cadeia de proxy está repassando o IP real, exibir em página pessoal etc. A saída é um badge de um segmento contendo apenas o texto do IP.
GET /check-ip
Indicado para: painéis de monitoramento e páginas de status para indicar rapidamente o “país do egress”. À direita exibe apenas country_code (ex.: US / TW / JP).
GET /check-8.8.8.8Indicado para: tickets, alertas e análise de logs ao transformar “IPs suspeitos” em etiquetas visuais para identificar rapidamente o país de origem.
GET /check-ip-zh
Indicado para: páginas voltadas a não técnicos ou quando é necessária maior legibilidade; à direita exibe country_code + country_name, por exemplo “US United States”.
Se o idioma for omitido, o nome do país não é retornado por padrão, evitando badges longos demais.
GET /check-8.8.8.8-zhIndicado para: operações de segurança, investigações internacionais, sistemas de tickets de suporte etc., incorporando a informação do país do IP como “badge de imagem” em qualquer página ou corpo de mensagem.
Controle de cor (opção B): adicionar -<color> ao final como no shields
O IP Badge permite adicionar -<color> ao final da rota para controlar a cor de fundo (normalmente a área de resultado à direita),
com uma experiência semelhante ao shields.io: você pode usar tokens simples (blue/green/red/gray) ou um valor hex de 6 dígitos (sem #).
Assim, é possível vincular a cor a um significado de negócio, por exemplo “green = normal, yellow = atenção, red = alto risco”, fazendo o badge transmitir informação e semântica de status ao mesmo tempo.
-
Especificar token de cor:
GET /check-ip-zh-blue GET /check-8.8.8.8-greenTokens são ideais para “seleção rápida de cor”, como blue/green/red/orange/yellow/gray etc. (conforme a tabela de mapeamento no seu controlador).
-
Especificar hex de 6 dígitos (sem #):
GET /check-ip-zh-ff0000 GET /check-8.8.8.8-16a34aHex é ideal para alinhar rigorosamente com a cor do tema do site, como a cor principal do seu backoffice ou a cor da marca, garantindo consistência visual.
-
myip também suporta cor:
GET /myip-gray GET /myip-111827Badges de um segmento são usados principalmente para “exibição”; adicionar cor ajuda a combinar com o estilo da página ou a destacar em listas.
Incorporação: funciona direto em Markdown / HTML / painéis de monitoramento
Como o IP Badge retorna uma imagem SVG, o uso mais recomendado é incorporar diretamente. Em README/Wiki do GitHub/GitLab, use a sintaxe de imagem do Markdown;
em qualquer página web ou painel administrativo, basta referenciar via <img>.
A grande vantagem é que você não precisa escrever lógica extra no front-end nem lidar com JSON e CORS, templates ou tipografia — o navegador renderiza SVG como imagem nativamente.
<img src="https://s.ipin.io/check-8.8.8.8-zh-green" alt="IP Badge" />Se você pretende exibir muitos badges ao mesmo tempo em um telão ou página de status (por exemplo, vários egress de nós, vários itens de inteligência de IP), recomenda-se habilitar um tempo de cache mais longo (por exemplo, 1 hora ou mais). Isso reduz significativamente a carga de consultas no banco e melhora a velocidade de carregamento. Como a informação de pertencimento do IP muda pouco, o ganho com cache é muito alto.
Cenários comuns: transforme “informação de IP” em componente visual
O IP Badge é excelente para necessidades “orientadas a exibição”. Por exemplo, em uma página de status de operações, você pode transformar o IP/país de saída de diferentes nós em uma “parede de badges”, identificando rapidamente se algum nó está saindo por uma região inesperada.
Em operações de segurança, você pode transformar IPs de alerta em badges vermelhos e incorporá-los em tickets ou notificações (ex.: “US United States” / “RU Russia”), permitindo que a equipe de plantão entenda o contexto de risco sem abrir detalhes.
Ao depurar cadeias de CDN/reverse proxy, acessar /myip e /check-ip
ajuda a verificar rapidamente se o IP real está sendo repassado corretamente ou se está sendo sobrescrito.
Em backoffices multilíngues ou SaaS internacional, usando -zh/-en/-ja
o mesmo IP pode mostrar nomes de países diferentes conforme o idioma, reduzindo o custo de manter dicionários de i18n no front-end.
Além disso, você pode vincular cor a estado de negócio — verde = “permitido”, amarelo = “precisa verificar”, vermelho = “bloqueado/alto risco” — fazendo o badge cumprir dupla função: “informação + status”.
Dica: se você pretende expor isso publicamente, recomenda-se aplicar uma política de “cabeçalhos de proxy confiáveis” no reverse proxy ou na camada de aplicação, para evitar que clientes forjem cabeçalhos como X-Forwarded-For e causem exibição incorreta.
Também é recomendado criar índices em
ip2location_db11.ip_from e
sys_lang_multi.vc_code,
além de usar cabeçalhos de cache para melhorar desempenho e estabilidade.
