> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/knowledge-base/nastroiki-sistemy/system-settings/geoip.md).

# Настройки GeoIP

Полная настройка GeoIP: провайдеры, приоритет, кеш, устойчивость, обновления и диагностика

GeoIP определяет страну и город по IP-адресу. Результат используется в аналитике, географических ограничениях и связанных проверках, но не является точным адресом клиента: VPN, прокси и мобильная сеть могут изменить определённое местоположение.

Точный путь:

**«Настройки» — «Общие настройки» — «Дополнительно» — «GeoIP»**

Для открытия, сохранения и диагностических действий требуется право **«Настройки GeoIP» из блока «Настройки»**. Оно выдаётся по пути **«Пользователи» — «Список групп пользователей»**. Откройте нужную группу.

{% hint style="warning" %}
Право «Разрешить управление GEOIP в админпанели» из блока «Админпанель» относится к историческому справочнику стран и городов и не заменяет право «Настройки GeoIP» для этого экрана.
{% endhint %}

## Что находится на экране

| Вкладка              | Что настраивается                                                              |
| -------------------- | ------------------------------------------------------------------------------ |
| «Основное»           | Включение GeoIP, обработка ошибок, источник IP и технические диапазоны         |
| «Провайдеры»         | MaxMind GeoLite2, DB-IP Lite, IPLocate.io и IP2Location.io, их доступы и тесты |
| «Стратегия»          | Порядок провайдеров, автоматическое переключение и объединение результатов     |
| «Кеш»                | Какие результаты сохранять и как долго их использовать                         |
| «Отказоустойчивость» | Временная пауза сбойного источника, ожидание ответа, повторы и журналирование  |
| «Обновления»         | Автоматическое и ручное обновление локальных баз                               |
| «Диагностика»        | Готовность GeoIP, состояние провайдеров, кеша и обновлений                     |

Подробные инструкции разделены по задачам:

* [провайдеры, доступы и стратегия](/knowledge-base/nastroiki-sistemy/system-settings/geoip/geoip-providers-and-strategy.md);
* [кеш и отказоустойчивость](/knowledge-base/nastroiki-sistemy/system-settings/geoip/geoip-cache-and-resilience.md);
* [обновления и диагностика](/knowledge-base/nastroiki-sistemy/system-settings/geoip/geoip-updates-and-diagnostics.md).

## Основные параметры

| Параметр                                 | Что произойдёт                                                                  |
| ---------------------------------------- | ------------------------------------------------------------------------------- |
| «Определять страну и город по IP»        | Общий выключатель GeoIP во всех связанных сценариях                             |
| «Проверять и дополнять найденные данные» | Нормализует названия и дополняет неполный ответ доступными сведениями           |
| «Кешировать результаты (быстрее)»        | Сокращает повторные обращения к провайдерам для одного IP                       |
| «Временно не обращаться к провайдерам»   | Использует только сохранённые результаты; новые IP останутся без местоположения |
| «Ускорять обработку списков IP»          | Оптимизирует массовую обработку IP в списках и аналитике                        |
| «Показывать подробности при проверке»    | Добавляет безопасные диагностические сведения к результату проверки             |

Названия стран и городов возвращаются на языке сайта. Если перевод недоступен, используется английское название.

## Если местоположение не найдено

Поле **«Если местоположение не удалось определить»** предлагает три варианта:

| Значение                                 | Когда использовать                                                             |
| ---------------------------------------- | ------------------------------------------------------------------------------ |
| «Продолжить без данных о местоположении» | Обычная работа, где GeoIP помогает, но не является обязательной проверкой      |
| «Продолжить и записать ошибку в журнал»  | Период диагностики или контроль качества провайдеров                           |
| «Остановить операцию с ошибкой»          | Только для заранее проверенного сценария, в котором местоположение обязательно |

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

## Как определять IP посетителя

Обычный выбор — **«Учитывать доверенные прокси»**. Он нужен, когда сайт работает через Nginx, Cloudflare или другой настроенный прокси. Вариант **«Использовать только прямое подключение»** применяйте только по указанию системного администратора.

Оставьте включёнными **«Пропускать частные IP»** и **«Пропускать зарезервированные IP»**: внутренние и технические адреса нельзя корректно определить как обычного посетителя, и их не следует отправлять внешним сервисам.

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

## Безопасная первичная настройка

{% stepper %}
{% step %}

### Включите основное определение

На вкладке «Основное» включите «Определять страну и город по IP», кеширование и проверку найденных данных. Не включайте режим только кеша при первой настройке.
{% endstep %}

{% step %}

### Подготовьте провайдеры

На вкладке «Провайдеры» оставьте только источники, для которых установлена база либо сохранены необходимые данные подключения. Проверьте каждый источник отдельным публичным IP.
{% endstep %}

{% step %}

### Задайте стратегию

На вкладке «Стратегия» расположите локальные базы первыми, включите «Переключение провайдеров» и при необходимости «Объединять результаты».
{% endstep %}

{% step %}

### Проверьте устойчивость

Оставьте автоматическую паузу сбойного источника и ограничение одинаковых предупреждений. Сетевые интервалы меняйте только после подтверждённой диагностики.
{% endstep %}

{% step %}

### Настройте обновления

Включите обновление только тех локальных баз, для которых выполнены условия доступа. Укажите период и час UTC, когда скачивание не мешает рабочей нагрузке.
{% endstep %}

{% step %}

### Проведите итоговую проверку

Сохраните настройки, откройте «Диагностика» и подтвердите, что GeoIP готов к работе. Проверьте каждый источник несколькими публичными IP, а затем выполните безопасный прикладной сценарий, который использует общую настройку GeoIP.
{% endstep %}
{% endstepper %}

Кнопка «Проверить» на вкладке «Провайдеры» обращается непосредственно к выбранному источнику. Она подтверждает его доступность, но не проверяет общий кеш и автоматическое переключение цепочки.

## Справочник стран и городов

Добавление страны в справочник не настраивает GeoIP и не разрешает направление для этой страны. Справочник находится по пути **«Утилиты» — «Страны и города»** и описан отдельно в статье [«Страны и города»](/knowledge-base/obmen/currency-list-and-card/locations.md).

## Результат

Настройка завершена, когда вкладка «Диагностика» показывает готовность, хотя бы один включённый источник доступен, тестовый публичный IP возвращает ожидаемую страну, кеш имеет ожидаемую политику, а недоступность одного провайдера не останавливает разрешённый рабочий сценарий.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.iexexchanger.com/knowledge-base/nastroiki-sistemy/system-settings/geoip.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.