GeoSite: что это

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

Коротко

GeoSite — это файл geosite.dat со списками доменов, сгруппированных по категориям, который Happ использует в профиле маршрутизации через коды вроде geosite:ads.

GeoSite в Happ — файл geosite.dat: база данных, где домены сгруппированы по категориям, например по стране, сервису или назначению вроде рекламных доменов. В профиле маршрутизации на такую категорию можно сослаться коротким кодом вида geosite:ads в списках DirectSites, ProxySites и BlockSites, не перечисляя домены вручную. По умолчанию Happ скачивает geosite.dat из репозитория Loyalsoldier/v2ray-rules-dat на GitHub и поставляется с уже предустановленной копией файла.

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

Суть GeoSite

Домены, которые относятся к одной задаче — например, все домены одного крупного сервиса или все известные рекламные сети — можно один раз собрать в общий список и дать ему короткое имя. Это и есть идея GeoSite: файл, где такие списки доменов уже готовы и сгруппированы по категориям.

В Happ этот файл называется geosite.dat, и на категории внутри него можно ссылаться в правилах кодом вида geosite:<категория>, например geosite:cn для доменов одной страны или geosite:ads для рекламных доменов.

Работает GeoSite вместе с профилем маршрутизации: сам файл — это только справочник доменов по категориям, а решение, что делать с найденной категорией — пропускать напрямую, направлять через прокси или блокировать, — задают списки DirectSites, ProxySites и BlockSites внутри профиля.

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

Как и geoip.dat, файл geosite.dat входит в предустановленный набор геофайлов Happ, поэтому категории вроде geosite:ads доступны сразу после установки приложения, ещё до первого обновления файлов.

Поле профиля	Назначение
`Geositeurl`	Ссылка, откуда Happ скачивает актуальный geosite.dat
`DirectSites`	Домены и категории geosite, которые идут напрямую
`ProxySites`	Домены и категории geosite, которые идут через прокси
`BlockSites`	Домены и категории geosite, которые блокируются

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

Для больших профилей и устройств с ограниченной памятью, например iOS, у Happ есть механизм урезанных GEO-файлов: ядру передаётся не весь geosite.dat, а только те категории, которые реально упомянуты в правилах активного профиля.

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

Условный пример правила, где домены заданы одновременно категорией GeoSite и конкретным именем:

JSON

{
  "DirectSites": ["geosite:cn", "geosite:geolocation-cn"],
  "ProxySites": ["geosite:google"],
  "BlockSites": ["geosite:ads", "example-tracker.com"]
}

Такое смешение категорий и отдельных доменов в одном списке — обычная практика: Happ обрабатывает оба формата одинаково при проверке правил.

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

Рядом с GeoSite стоит несколько понятий, которые тоже касаются доменов и маршрутизации, но работают иначе.

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

Как часто обновляются геофайлы Happ и что делать при сбое — на странице геофайлы Happ и в инструкции обновление GEO-файлов вручную.

Главное

GeoSite в Happ — это файл geosite.dat, применяемый через коды вида geosite:ads в списках DirectSites, ProxySites и BlockSites профиля маршрутизации.
По умолчанию Happ скачивает geosite.dat из репозитория Loyalsoldier/v2ray-rules-dat и поставляется с предустановленной копией для работы сразу после установки.
Ссылку на файл задаёт поле Geositeurl профиля маршрутизации, его можно заменить на собственный адрес.
Если загрузка geosite.dat не завершается за 3 минуты, менеджер загрузки останавливает процесс и показывает ошибку рядом с профилем.
Параметр domainStrategy определяет, участвует ли вообще проверка по GeoSite до попытки резолвинга домена в IP-адрес.

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

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

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

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

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

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

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

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

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

Можно ли использовать свой список доменов вместо geosite.dat?

Профиль маршрутизации Happ позволяет заменить стандартный адрес в поле Geositeurl на собственный, если нужен файл с другим набором категорий. Кроме того, конкретные домены можно добавлять напрямую в списки DirectSites, ProxySites и BlockSites рядом с кодами geosite — оба формата допустимы одновременно в одном списке.

Как domainStrategy влияет на срабатывание правил GeoSite?

Правила по GeoSite проверяются по имени домена, поэтому они всегда доступны независимо от значения domainStrategy — этот параметр влияет на дальнейший шаг, резолвинг в IP для правил GeoIP. Но именно от порядка проверки доменных и IP-правил зависит, что сработает раньше, если один и тот же ресурс попадает под правила обоих файлов.

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

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

Источники

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