whatismyip

Какой у меня IP-адрес

• Какой у меня IP-адрес
  • Функции
  • Конечные точки
  • Обнаружение DNS
  • Строить
  • Использование
  • Примеры
    • Запустите TCP-сервер по умолчанию
    • Запустите TLS (HTTP/2) и включите «Какой у меня DNS?»
    • Запустите сервер HTTP/3
    • Запустите TCP-сервер по умолчанию с настраиваемым шаблоном и доверьтесь паре настраиваемых заголовков, заданных вышестоящим прокси-сервером.
  • Скачать
  • Докер
    • Запустите контейнер локально, используя тестовые базы данных.
    • Из Docker Hub

Примечание

Начиная с версии 2.3.0, приложение включает в себя дополнительное обнаружение DNS клиента.

Просто еще один сервис «Какой у меня IP-адрес», включая геолокацию, проверку открытых портов TCP и информацию заголовков. Написанный на языке go с учетом высокой производительности, он использует gin, который использует httprouter — легкий высокопроизводительный HTTP-мультиплексор.

Взгляните на ifconfig.es — действующий сайт, использующий whatismyip и включенное DNS discovery .

Получите свой общедоступный IP-адрес легко из командной строки:

curl ifconfig.es
127.0.0.1

curl -6 ifconfig.es
::1

Получите IP вашего DNS-провайдера:

curl -L dns.ifconfig.es
2a04:e4c0:47::67 (Spain / OPENDNS)

Функции

• TLS и HTTP/2.
• Экспериментальная поддержка HTTP/3. Для HTTP/3 требуется работающий сервер TLS ( -tls-bind ), поскольку HTTP/3 запускается как соединение TLS, которое затем обновляется до UDP. Порт UDP такой же, как тот, который используется для сервера TLS.
• Обнаружение бета-версии DNS: самый эффективный подход к обнаружению DNS-сервера, который обрабатывает запросы клиента.
• Может работать через прокси-сервер, доверяя пользовательскому заголовку (обычно X-Real-IP ) для определения исходного IP-адреса. Он также поддерживает настраиваемый заголовок для определения порта клиента. Если прокси-сервер может добавить только заголовок для IP-адреса (например, фиксированный заголовок из CDN), порт клиента отображается как неизвестный.
• IPv4 и IPv6.
• Информация о геолокации, включая ASN. Эта функция возможна благодаря базам данных maxmind GeoLite2. Для использования этих баз данных необходим лицензионный ключ. Посетите сайт Maxmind для получения дальнейших инструкций и получения бесплатной лицензии.
• Проверка открытых портов TCP.
• Высокая производительность.
• Автономный сервер, который может перезагружать базы данных GeoLite2 и/или сертификаты SSL без остановки/запуска. Сигнал hup принимается во внимание.
• HTML-шаблоны для целевой страницы.
• Обычный текст и вывод в формате JSON.

Конечные точки

• https://ifconfig.es/
• https://ifconfig.es/client-port
• https://ifconfig.es/json (это то же самое, что и curl -H "Accept: application/json" https://ifconfig.es/ )
• https://ifconfig.es/geo
  • https://ifconfig.es/geo/city
  • https://ifconfig.es/geo/country
  • https://ifconfig.es/geo/country_code
  • https://ifconfig.es/geo/latitude
  • https://ifconfig.es/geo/longitude
  • https://ifconfig.es/geo/postal_code
  • https://ifconfig.es/geo/time_zone
• https://ifconfig.es/asn
  • https://ifconfig.es/asn/number
  • https://ifconfig.es/asn/organization
• https://ifconfig.es/all
• https://ifconfig.es/headers
  • https://ifconfig.es/<имя_заголовка>
• https://ifconfig.es/scan/tcp/<номер_порта>
• https://dns.ifconfig.es

Обнаружение DNS

Обнаружение DNS работает, заставляя клиента сделать запрос к <uuid>.dns.ifconfig.es Этот DNS-запрос обрабатывается сервером microdns, включенным в двоичный файл whatismyip . Для запуска сервера обнаружения необходимо создать файл конфигурации следующего вида:

---
domain : dns.example.com
redirect_port : " :8000 "
resource_records :
  - " 1800 IN SOA xns.example.com. hostmaster.example.com. 1 10000 2400 604800 1800 "
  - " 3600 IN NS xns.example.com. "
ipv4 :
  - " 127.0.0.2 "
ipv6 :
  - " aaa:aaa:aaa:aaaa::1 "

Центр DNS для example.com делегировал субдоменную зону dns.example.com серверу, на котором работает служба whatismyip .

Клиент может запросить URL-адрес dns.example.com , выполнив перенаправление curl -L dns.example.com .

Чтобы избежать перенаправления, вы можете указать действительный URL, например, для настоящего ifconfig.es:

curl $( uuidgen ) .dns.ifconfig.es

curl $( cat /proc/sys/kernel/random/uuid ) .dns.ifconfig.es

Строить

Требуется Голанг >= 1,22.

make build

Использование

 Usage of whatismyip:
  -bind string
        Listening address (see https://pkg.go.dev/net?#Listen) (default ":8080")
  -enable-http3
        Enable HTTP/3 protocol. HTTP/3 requires --tls-bind set, as HTTP/3 starts as a TLS connection that then gets upgraded to UDP. The UDP port is the same as the one used for the TLS server.
  -enable-secure-headers
        Add sane security-related headers to every response
  -geoip2-asn string
        Path to GeoIP2 ASN database
  -geoip2-city string
        Path to GeoIP2 city database
  -resolver string
        Path to the resolver configuration. It actually enables the resolver for DNS client discovery.
  -template string
        Path to template file
  -tls-bind string
        Listening address for TLS (see https://pkg.go.dev/net?#Listen)
  -tls-crt string
        When using TLS, path to certificate file
  -tls-key string
        When using TLS, path to private key file
  -trusted-header string
        Trusted request header for remote IP (e.g. X-Real-IP). When using this feature if -trusted-port-header is not set the client port is shown as 'unknown'
  -trusted-port-header string
        Trusted request header for remote client port (e.g. X-Real-Port). When this parameter is set -trusted-header becomes mandatory
  -version
        Output version information and exit

Примеры

Запустите TCP-сервер по умолчанию

./whatismyip -geoip2-city ./test/GeoIP2-City-Test.mmdb -geoip2-asn ./test/GeoLite2-ASN-Test.mmdb

Запустите TLS (HTTP/2) и включите «Какой у меня DNS?»

./whatismyip -geoip2-city ./test/GeoIP2-City-Test.mmdb -geoip2-asn ./test/GeoLite2-ASN-Test.mmdb 
             -bind " " -tls-bind :8081 -tls-crt ./test/server.pem -tls-key ./test/server.key 
             -resolver ./test/resolver.yml

Запустите сервер HTTP/3

./whatismyip -geoip2-city ./test/GeoIP2-City-Test.mmdb -geoip2-asn ./test/GeoLite2-ASN-Test.mmdb 
             -bind " " -tls-bind :8081 -tls-crt ./test/server.pem -tls-key ./test/server.key -enable-http3

Запустите TCP-сервер по умолчанию с настраиваемым шаблоном и доверьтесь паре настраиваемых заголовков, заданных вышестоящим прокси-сервером.

./whatismyip -geoip2-city ./test/GeoIP2-City-Test.mmdb -geoip2-asn ./test/GeoLite2-ASN-Test.mmdb 
             -trusted-header X-Real-IP -trusted-port-header X-Real-Port -template mytemplate.tmpl

Скачать

Загрузите последнюю версию с github

Докер

Ультралегкий (~4 МБ) образ доступен в Docker Hub. Начиная с версии 2.1.2 , двоичный файл сжимается с помощью upx.

Запустите контейнер локально, используя тестовые базы данных.

make docker-run

Из Docker Hub

docker run --tty --interactive --rm 
    -v $PWD / < path to city database > :/tmp/GeoIP2-City-Test.mmdb:ro 
    -v $PWD / < path to ASN database > :/tmp/GeoLite2-ASN-Test.mmdb:ro -p 8080:8080 
    dcarrillo/whatismyip:latest 
      -geoip2-city /tmp/GeoIP2-City-Test.mmdb 
      -geoip2-asn /tmp/GeoLite2-ASN-Test.mmdb