`geo`

geo estima localização e proprietário de rede de um IP público por um provedor remoto ou, quando disponível, por uma base GeoIP local.

RedeVersão 1.2.4Estável

lil-terminal

pwd/sandboxdir 1 . -Fconfig/ data/ logs/ src/ tmp/geoExemplo didático offline — sem consulta real Remote ipwho.is HTTPS yes Local GeoIP nogeo meExemplo didático offline — sem consulta real IP 8.8.8.8 Source ipwho.is Type IPv4 Continent Example continent (XX)geo -cExemplo didático offline — sem consulta real IP 8.8.8.8 Source ipwho.is Continent Example continent (XX) Country Example country (ZZ)

Visão geral

Use geo para Geolocalização IP e proprietário da rede. As operações comuns continuam curtas, e formas especializadas acrescentam detalhes apenas quando necessário, para que o trabalho repetido seja fácil de entender, repetir e levar a scripts do lil-terminal.

Geolocalização de IP é contexto, não identidade

VPNs, proxies, redes móveis, CDNs e roteamento do provedor podem deslocar a localização exibida. -local evita a consulta remota, mas exige extensão GeoIP e base compatíveis no servidor.

Sintaxe

lil-terminal

geo [host|ip|me] [options]

Referência

geo

mostrar o estado do provedor e do GeoIP local

geo me

usar o endereço do visitante atual

geo -c

mostrar o país e o continente do visitante atual

geo 8.8.8.8

mostrar um resumo da localização do IP e da rede

geo example.com -a

mostrar todos os campos disponíveis de localização e rede

geo -db

mostrar detalhes do banco GeoIP local

-c

mostrar país e continente

-r

mostrar região, cidade, CEP e coordenadas

-tz

mostrar detalhes do fuso horário

-asn | -isp | -org | -dom

mostrar os dados de rede selecionados

-type

mostrar a família IP

-json

mostrar a resposta do provedor como JSON formatado

-4 | -6

resolver um host por IPv4 ou IPv6

-local

usar somente a extensão GeoIP local

Uso prático

geo mostra as fontes; geo me usa o IP do visitante. -c mostra país, -r região e coordenadas aproximadas, -tz fuso e -asn/-isp/-org/-dom dados da rede. -a exibe todos os campos e -json a resposta do serviço. -4/-6 seleciona família de IP, -local evita a consulta externa e -db mostra a base local.

Limites e segurança

IPs privados e de loopback são recusados; algumas faixas especiais podem passar no filtro PHP, mas o provedor pode rejeitá-las. O serviço remoto usa ipwho.is por HTTPS com cache de sessão. GeoIP local pode não estar disponível. Exemplos usam respostas simuladas sem consulta real.

Prévia interativa do sandbox

Execute os exemplos preparados diretamente na página. Os resultados são predefinidos e exibidos no navegador; nenhum comando do terminal é executado no servidor.

Verificar o provedor e depois um IP

Instalar e gerenciar

Instale a versão compatível atual. Escolha Base para o conjunto completo de recursos ou Minimum para o pacote reduzido; use upgrade para atualizar um módulo já instalado.

Base e Minimum são dois pacotes da mesma versão atual do módulo.

Pacote Base

Instala o pacote completo com referência local e todos os modos publicados.

install geo

Pacote Minimum

Instalar o pacote reduzido. A referência local é omitida; help <cmd> -i abre a referência atual do servidor.

install geo -m

Versão pública exata

Instalar exatamente esta versão publicada.

install geo -v 1.2.4

Verificar ou atualizar

upgrade verifica compatibilidade e substitui o bloco somente quando necessário.

upgrade geo

Remover módulo

Remove o bloco da extensão sem afetar o núcleo ou outros módulos.

install geo -u

Exemplos

Os exemplos podem ser copiados, mas o site não os executa. Revise caminhos, permissões e opções destrutivas.

Verificar o provedor e depois um IP

geo

Exemplo didático offline — sem consulta real
Remote       ipwho.is
HTTPS        yes
Local GeoIP  no

Mostrar detalhes do banco GeoIP local

geo -db

Exemplo didático offline — sem consulta real
Local GeoIP database unavailable

Usar o endereço do visitante atual

geo me

Exemplo didático offline — sem consulta real
IP           8.8.8.8
Source       ipwho.is
Type         IPv4
Continent    Example continent (XX)
Country      Example country (ZZ)
Region       Example region (XX-01)
City         Example city
Postal       00000
Coordinates  0, 0
ASN          AS64500
ISP          Example ISP
ORG          Example Network
Timezone     Etc/UTC (+00:00)

Mostrar um resumo da localização do IP e da rede

geo 8.8.8.8

Exemplo didático offline — sem consulta real
IP           8.8.8.8
Source       ipwho.is
Type         IPv4
Continent    Example continent (XX)
Country      Example country (ZZ)
Region       Example region (XX-01)
City         Example city
Postal       00000
Coordinates  0, 0
ASN          AS64500
ISP          Example ISP
ORG          Example Network
Timezone     Etc/UTC (+00:00)

Mostrar todos os campos disponíveis de localização e rede

geo 8.8.8.8 -a

Exemplo didático offline — sem consulta real
IP           8.8.8.8
Source       ipwho.is
Type         IPv4
Continent    Example continent (XX)
Country      Example country (ZZ)
Region       Example region (XX-01)
City         Example city
Postal       00000
Coordinates  0, 0
ASN          AS64500
ISP          Example ISP
ORG          Example Network
Domain       example.test
Timezone     Etc/UTC (+00:00)
Local time   2026-11-01T12:00:00Z

Mostrar o país e o continente do visitante atual

geo -c

Exemplo didático offline — sem consulta real
IP         8.8.8.8
Source     ipwho.is
Continent  Example continent (XX)
Country    Example country (ZZ)

Mostrar país e continente

geo 8.8.8.8 -c

Exemplo didático offline — sem consulta real
IP         8.8.8.8
Source     ipwho.is
Continent  Example continent (XX)
Country    Example country (ZZ)

Rejeitar um endereço sem geolocalização pública

geo 8.8.8.8 -r

Exemplo didático offline — sem consulta real
IP           8.8.8.8
Source       ipwho.is
Region       Example region (XX-01)
City         Example city
Postal       00000
Coordinates  0, 0

Mostrar detalhes do fuso horário

geo 8.8.8.8 -tz

Exemplo didático offline — sem consulta real
IP        8.8.8.8
Source    ipwho.is
Timezone  Etc/UTC (+00:00)

Mostrar os dados de rede selecionados

geo 8.8.8.8 -asn

Exemplo didático offline — sem consulta real
IP      8.8.8.8
Source  ipwho.is
ASN     AS64500

Mostrar os dados de rede selecionados

geo 8.8.8.8 -isp

Exemplo didático offline — sem consulta real
IP      8.8.8.8
Source  ipwho.is
ISP     Example ISP

Mostrar os dados de rede selecionados

geo 8.8.8.8 -org

Exemplo didático offline — sem consulta real
IP      8.8.8.8
Source  ipwho.is
ORG     Example Network

Mostrar os dados de rede selecionados

geo 8.8.8.8 -dom

Exemplo didático offline — sem consulta real
IP      8.8.8.8
Source  ipwho.is
Domain  example.test

Mostrar a família IP

geo 8.8.8.8 -type

Exemplo didático offline — sem consulta real
IP      8.8.8.8
Source  ipwho.is
Type    IPv4

Mostrar a resposta do provedor como JSON formatado

geo 8.8.8.8 -json

Exemplo didático offline — sem consulta real
{
    "ip": "8.8.8.8",
    "type": "IPv4",
    "continent": "Example continent",
    "continent_code": "XX",
    "country": "Example country",
    "country_code": "ZZ",
    "region": "Example region",
    "region_code": "XX-01",
    "city": "Example city",
    "postal": "00000",
    "latitude": 0,
    "longitude": 0,
    "connection": {
        "asn": 64500,
        "isp": "Example ISP",
        "org": "Example Network",
        "domain": "example.test"
    },
    "timezone": {
        "id": "Etc/UTC",
        "utc": "+00:00",
        "current_time": "2026-11-01T12:00:00Z"
    }
}

Mostrar país e continente

geo 8.8.8.8 -c -r -tz

Exemplo didático offline — sem consulta real
IP           8.8.8.8
Source       ipwho.is
Continent    Example continent (XX)
Country      Example country (ZZ)
Region       Example region (XX-01)
City         Example city
Postal       00000
Coordinates  0, 0
Timezone     Etc/UTC (+00:00)

Usar somente a extensão GeoIP local

geo 8.8.8.8 -local

Exemplo didático offline — sem consulta real
Local GeoIP data unavailable

Resolver um host por IPv4 ou IPv6

geo example.test -4 -c

Exemplo didático offline — sem consulta real
Target     example.test
IP         8.8.8.8
Source     ipwho.is
Continent  Example continent (XX)
Country    Example country (ZZ)

Resolver um host por IPv4 ou IPv6

geo example.test -6 -c

Exemplo didático offline — sem consulta real
Target     example.test
IP         2606:4700:4700::1111
Source     ipwho.is
Continent  Example continent (XX)
Country    Example country (ZZ)

Geo · 20

geo 10.0.0.2

Exemplo didático offline — sem consulta real
Public IP address required

Geo · 21

geo 127.0.0.1

Exemplo didático offline — sem consulta real
Public IP address required

Geo · -4

geo 8.8.8.8 -4 -6

Exemplo didático offline — sem consulta real
Choose either IPv4 or IPv6

Geo · -what

geo 8.8.8.8 -what

Exemplo didático offline — sem consulta real
?

Geo · -c

geo bad.invalid -c

Exemplo didático offline — sem consulta real
Host not found

Documentação relacionada

Quais diagnósticos de rede estão disponíveis? →O que acontece se repo.lil.dog ficar indisponível? →

Versão pública atual

v1.2.42026-10-31

Filtros GeoIP sem host

geo -c e outros filtros sem host passam a usar automaticamente o IP do visitante.

# Histórico de versões