GeoIP: что это

Автор: Екатерина Лебедева, редактор раздела knowledge base
Проверил:: Артём Волков
Проверено:: 28 сентября 2026
Опубликовано:: 27 сентября 2026, обновлено 28 сентября 2026
Версия гайда:: 1.0

Коротко

GeoIP — это файл geoip.dat с базой соответствий IP-адресов странам и организациям, который Happ использует в профиле маршрутизации, чтобы направлять трафик по коду вроде geoip:cn.

GeoIP в Happ — не отдельная функция, а файл geoip.dat: база данных, которая группирует диапазоны IP-адресов по странам и крупным сервисам. В профиле маршрутизации на такие группы можно ссылаться короткими кодами вида geoip:cn или geoip:amazon в списках DirectIp, ProxyIp и BlockIp вместо того, чтобы перечислять адреса вручную. По умолчанию Happ скачивает geoip.dat из репозитория Loyalsoldier/v2ray-rules-dat на GitHub и хранит его локально, а при сбое загрузки показывает ошибку на главном экране и красный восклицательный знак у профиля.

GeoIP — файл geoip.dat с базой данных, которая группирует диапазоны IP-адресов по странам и организациям, чтобы правила маршрутизации могли ссылаться на такую группу одним кодом вместо перечисления адресов.

Суть GeoIP

GeoIP-база решает практическую задачу: описать не один IP-адрес, а сразу целую группу адресов, привязанных, например, к одной стране или к инфраструктуре одного крупного сервиса. Вместо длинного списка конкретных адресов в правиле маршрутизации указывается короткий код такой группы.

В Happ эта база — файл geoip.dat, тот же формат, что используют многие проекты на базе Xray-core. Из него берутся значения вида cn, amazon или private, которые записываются в правило как geoip:<код>.

Работает GeoIP всегда в связке с профилем маршрутизации: сам файл — это только база данных, а решение, что с найденной группой адресов делать — пускать напрямую, через прокси или блокировать, — задают списки DirectIp, ProxyIp и BlockIp внутри профиля.

Как это выглядит в Happ

Happ поставляется с уже предустановленными геофайлами, поэтому маршрутизация по кодам GeoIP работает сразу после установки, без необходимости сначала что-то скачивать.

Поле профиля	Назначение
`Geoipurl`	Ссылка, откуда Happ скачивает актуальный geoip.dat
`DirectIp`	Список адресов и кодов geoip, которые идут напрямую
`ProxyIp`	Список адресов и кодов geoip, которые идут через прокси
`BlockIp`	Список адресов и кодов geoip, которые блокируются

По умолчанию Geoipurl указывает на репозиторий Loyalsoldier/v2ray-rules-dat на GitHub — там же лежит и файл geosite.dat. Если загрузка обновлённого файла не укладывается в 3 минуты, менеджер загрузки останавливает процесс, а на главном экране и рядом с профилем в списке появляется сообщение об ошибке — подробный разбор на странице ошибки загрузки GEO-файлов.

Отдельная функция — урезанные GEO-файлы: вместо полного geoip.dat ядру передаётся только та часть, которая реально используется в правилах текущего профиля, что особенно важно при ограничениях памяти на iOS.

Пример использования в профиле

Так код GeoIP выглядит внутри списка правил профиля маршрутизации — условный пример:

JSON

{
  "DirectIp": ["geoip:private", "10.0.0.0/8"],
  "ProxyIp": ["geoip:amazon"],
  "BlockIp": ["geoip:ads"]
}

Коды GeoIP можно свободно сочетать с обычными IP-диапазонами в одном и том же списке — Happ обрабатывает их как равноправные элементы правила.

Чем GeoIP отличается от похожих терминов

GeoIP легко перепутать с соседними понятиями, которые тоже участвуют в маршрутизации по IP и доменам.

Термин	Работает с	Отличие от GeoIP
GeoSite	Доменными именами	GeoIP группирует адреса, GeoSite — имена сайтов
Профиль маршрутизации	Всеми правилами сразу	GeoIP — только один из источников данных для этих правил
domainStrategy	Моментом резолвинга домена	Определяет, дойдёт ли запрос до проверки по GeoIP вообще

Подробный разбор устройства геофайлов в Happ и того, как часто они обновляются, — на странице геофайлы Happ.

Главное

GeoIP в Happ — это файл geoip.dat, а не отдельная настройка: он используется через ссылки вида geoip:cn в списках DirectIp, ProxyIp и BlockIp профиля маршрутизации.
По умолчанию Happ скачивает geoip.dat из репозитория Loyalsoldier/v2ray-rules-dat и поставляется с предустановленной копией, чтобы работать сразу после установки.
Ссылку на файл в профиле маршрутизации задаёт поле Geoipurl, которое можно заменить своим адресом при необходимости.
Если загрузка geoip.dat не завершается за 3 минуты, менеджер загрузки останавливает процесс и показывает ошибку на главном экране.
Функция useChunkFiles может вырезать из geoip.dat только нужные разделы, чтобы не перегружать память устройства при старте ядра.

Частые вопросы

Что означает geoip:cn в правилах Happ?

Это ссылка на конкретную группу IP-адресов внутри файла geoip.dat — в данном случае на диапазоны, привязанные к определённой стране. Такую метку можно вписать в список DirectIp, ProxyIp или BlockIp профиля маршрутизации, и Happ применит правило сразу ко всем адресам из этой группы, без необходимости перечислять их вручную.

Где Happ берёт файл geoip.dat по умолчанию?

По умолчанию ссылка Geoipurl в профиле маршрутизации указывает на последний релиз geoip.dat из репозитория Loyalsoldier/v2ray-rules-dat на GitHub. Приложение также поставляется с уже предустановленными геофайлами, поэтому маршрутизация по GEO-кодам работает сразу после установки, ещё до первого обновления файлов.

Что произойдёт, если geoip.dat не скачается?

Документация Happ описывает менеджер загрузки геофайлов, который работает в фоне. Если скачивание не завершается за 3 минуты, процесс останавливается, на главном экране появляется сообщение об ошибке, а рядом с проблемным профилем — красный восклицательный знак. Ошибка исчезает после успешной загрузки или удаления такого профиля.

Чем GeoIP отличается от GeoSite в Happ?

GeoIP работает с IP-адресами и используется в списках DirectIp, ProxyIp и BlockIp, а GeoSite — с доменными именами и применяется в DirectSites, ProxySites и BlockSites. Оба файла из одного источника и обновляются похожим образом, но описывают ресурсы по-разному: один по сетевому адресу, второй по имени домена.

Можно ли заменить файл geoip.dat в Happ на свой?

Профиль маршрутизации допускает указать собственный адрес в поле Geoipurl вместо стандартной ссылки на Loyalsoldier/v2ray-rules-dat. Это может понадобиться, если провайдер поддерживает собственную, более узкую или более актуальную базу IP-адресов для своих правил маршрутизации.

Как GeoIP связан с параметром domainStrategy?

domainStrategy определяет, резолвит ли Xray домен в IP-адрес до проверки правил или только после того, как правило по домену не сработало. От этого зависит, дойдёт ли вообще очередь до проверки IP-адреса по базе GeoIP: при стратегии AsIs резолвинга для маршрутизации не происходит вовсе, и правила GeoIP по факту не участвуют в решении.

Упомянутые темы

Разделы по теме

Источники

Документация Happ: геонастройки и маршрутизация — обращение 28 сентября 2026