Геобазы трекера

По IP посетителя трекер определяет страну, регион, город, провайдера, часовой пояс и тип соединения. Данные берутся из файлов геобаз на сервере и используются в фильтрах потока, проверках клоаки, макросах и отчётах. Состояние баз видят владелец и администратор.

Три базы

Файлы лежат на сервере в каталоге /opt/tracker/data/geoip. Если при установке задан другой каталог параметром --path, папка data/geoip находится в нём. Имена файлов фиксированы.

Набор полей IP2Location зависит от пакета базы: поле, которого нет в файле, трекер из неё не получает.

Названия региона и города записаны так, как они даны в базе, на английском: California, Berlin.

Что ставится при установке

Установщик скачивает бесплатную базу DB-IP City Lite с download.db-ip.com и сохраняет её как city.mmdb. Сначала запрашивается файл за текущий месяц, при неудаче — за предыдущий. Если city.mmdb уже лежит в каталоге, он не перекачивается.

После установки по IP определяются страна, регион и город. Провайдера, часового пояса и типа соединения в этой базе нет.

Остальные базы добавляются отдельно:

• IP2Proxy подключается в панели: Настройки → Боты и гео, блок IP2Proxy. Порядок действий — на странице IP2Proxy.
• IP2Location добавляется файлом ip2location.bin, см. Замена и обновление баз.

Если при установке база не скачалась, см. Не скачалась база GeoIP.

Как объединяются данные

Трекер опрашивает базы по порядку и берёт каждое поле из первой базы, где оно заполнено.

1. city.mmdb — страна, регион, город. Часовой пояс берётся отсюда, только если он записан в файле; в базе из установки его нет.
2. ip2location.bin — провайдер и всё, что осталось пустым после первой базы.
3. ip2proxy.bin — тип соединения. Страна и провайдер берутся из неё, только если первые две базы их не дали.

Тип соединения даёт только IP2Proxy. Значения: hosting — дата-центр, vpn, tor, proxy. У обычного соединения значение пустое.

База, которая не открылась, пропускается, остальные работают.

Реальный IP за Cloudflare и прокси

Когда домен работает через Cloudflare или proxy-сервер, запрос приходит на сервер трекера с адреса посредника. Адрес посетителя трекер берёт из заголовков запроса в таком порядке:

1. CF-Connecting-IP.
2. Первый адрес из X-Forwarded-For.
3. X-Real-IP.

Если ни в одном заголовке нет IP-адреса, используется адрес соединения. По найденному адресу определяются гео и тип соединения, он же записывается в клик.

Блок «Геобазы движка»

1. Откройте Админ-панель → Состояние.
2. Найдите блок Геобазы движка.

В блоке три колонки: mmdb — это файл city.mmdb, ip2location и ip2proxy. Под названием стоит статус, ниже — размер файла и дата в виде «файл от 04.10.2026». Если файла нет, строки с размером и датой тоже нет. Данные обновляются сами каждые 15 секунд, кнопка Обновить перечитывает их сразу.

Если файла ip2location.bin на сервере нет, колонка ip2location показывает Ошибка открытия. Так выглядит установка без этой базы: остальные базы работают, делать ничего не нужно.

Вместо колонок может стоять сообщение:

• «Нет свежих данных от redirect» — сведения от обработчика кликов старше 30 секунд. Что проверить — в разделе Очередь приёма кликов.
• «Версия redirect ещё не передаёт сведения о геобазах» — обработчик кликов не сообщил состояние баз.

Замена и обновление баз

Трекер сам не обновляет city.mmdb и ip2location.bin: в каталоге остаётся файл, скачанный при установке или положенный вручную. Обработчик кликов — сервис redirect — читает эти файлы один раз при запуске, поэтому новый файл начинает работать после перезапуска.

1. Загрузите новый файл на сервер в любую папку, например в /root.
2. Переместите его в каталог геобаз под именем city.mmdb или ip2location.bin. Имя пишется строчными буквами.
3. Разрешите чтение файла.
4. Перезапустите обработчик кликов.
5. Откройте Админ-панель → Состояние и проверьте статус Загружена и новую дату файла.

Команды для шагов 2–4 на примере city.mmdb:

sudo mv /root/city.mmdb /opt/tracker/data/geoip/city.mmdb
sudo chmod 644 /opt/tracker/data/geoip/city.mmdb
cd /opt/tracker
sudo docker compose --project-name tracker --env-file .env.production -f docker-compose.prod.yml restart redirect

Перемещайте готовый файл командой mv, а не записывайте его поверх прежнего: обработчик кликов держит прежний файл открытым до перезапуска.

Файл ip2proxy.bin обновляет панель, новая версия подключается без перезапуска.

Файлы геобаз входят в резервную копию. При восстановлении на новом сервере через мастер первого запуска они возвращаются на место. Держите в каталоге геобаз только файлы баз, без архивов, старых версий и вложенных папок: копию с другими файлами в этом каталоге мастер не восстановит и покажет сообщение «Копия содержит неподдерживаемый файл геобазы.»

Что не работает без базы

Трекер принимает клики без любой из баз. Поле, которое определить нечем, остаётся пустым. Пустое значение не совпадает ни с одним значением условия: условие с оператором в списке для такого клика не выполняется, с оператором не в списке — выполняется.

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

Заменил файл, а дата в блоке прежняя

Для city.mmdb и ip2location.bin блок показывает файл, открытый при запуске обработчика кликов. Перезапустите его, см. Замена и обновление баз.

Нужно ли подключать все три базы

Нет. Для условий по стране, региону и городу хватает city.mmdb из установки. IP2Proxy нужна для отсева дата-центров, прокси и VPN. IP2Location добавляет провайдера и часовой пояс.