> 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/geoip-providers-and-strategy.md).

# Провайдеры и стратегия GeoIP

Подключение провайдеров GeoIP, проверка доступов, приоритет и автоматическое переключение

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

Точный путь:

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

Требуется право **«Настройки GeoIP» из блока «Настройки»**.

## Доступные провайдеры

| Провайдер        | Тип            | Что может определить                       | Что требуется                                                                  |
| ---------------- | -------------- | ------------------------------------------ | ------------------------------------------------------------------------------ |
| MaxMind GeoLite2 | Локальная база | Страну, город и доступные сетевые сведения | Установленная база; Account ID и лицензионный ключ для скачивания и обновления |
| DB-IP Lite       | Локальная база | Страну и город                             | Установленная база и выполненное требование об атрибуции                       |
| IPLocate.io      | Внешний сервис | Геолокацию по публичному IP                | Сохранённый API-ключ и доступ к сервису                                        |
| IP2Location.io   | Внешний сервис | Страну, регион, город и ASN                | Сохранённый API-ключ и доступ к сервису                                        |

Карточка каждого провайдера показывает **«Готовность к работе»**. Для локального источника система проверяет наличие и читаемость базы; для внешнего — наличие данных подключения. Включённый, но неготовый провайдер не следует считать резервом.

## Данные для подключения

Для MaxMind нажмите **«Настроить доступ»** и сохраните Account ID и лицензионный ключ. Для IPLocate.io и IP2Location.io сохраните API-ключ из личного кабинета соответствующего сервиса.

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

{% hint style="danger" %}
Не вставляйте ключи в заявку поддержки, чат, снимок экрана или репозиторий. Если ключ был раскрыт, отзовите его у провайдера и сохраните новый.
{% endhint %}

## Условие DB-IP Lite

Переключатель **«Подтвердить атрибуцию DB-IP»** включайте только после того, как на клиентском сайте размещена видимая ссылка **«IP Geolocation by DB-IP»** в соответствии с условиями бесплатной базы. Без подтверждения автоматическое и ручное обновление DB-IP может быть недоступно.

## Проверка провайдера

{% stepper %}
{% step %}

### Сохраните доступ

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

{% step %}

### Укажите публичный IP

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

{% step %}

### Выберите тип определения

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

{% step %}

### Нажмите «Проверить»

Сверьте найденные поля и время ответа. Один тест внешнего сервиса учитывается в его лимите запросов.
{% endstep %}
{% endstepper %}

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

## Порядок провайдеров

Перейдите на вкладку **«Стратегия»**. Поле **«Как применять порядок»** предлагает:

| Значение                     | Поведение                                    |
| ---------------------------- | -------------------------------------------- |
| «Строго по списку ниже»      | Использует порядок, заданный перетаскиванием |
| «Сначала установленные базы» | Ставит локальные источники перед внешними    |
| «Сначала внешние сервисы»    | Ставит внешние сервисы перед локальными      |

В блоке **«Приоритет провайдеров»** перемещайте строки за маркер перетаскивания. Чем выше источник, тем раньше он будет вызван с учётом выбранного режима.

Для большинства установок безопасная основа — локальные базы первыми, внешние сервисы ниже как дополнение или резерв. Это уменьшает задержку и зависимость от лимитов API.

## Переключение и объединение

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

Если переключение выключено, ошибка первого выбранного провайдера сразу приводит к поведению, заданному на вкладке «Основное». Если объединение включено, один запрос может задействовать несколько источников и увеличить расход внешнего лимита.

## Проверка стратегии

1. Проверьте первый провайдер известным публичным IP.
2. Проверьте второй провайдер тем же IP.
3. Сохраните порядок и выполните безопасный прикладной сценарий, который использует общую настройку GeoIP.
4. В согласованном тестовом окне сделайте первый источник недоступным либо временно отключите его.
5. Повторите тот же прикладной сценарий и подтвердите, что он получил пригодный результат от следующего источника.
6. Верните исходную настройку и проверьте «Диагностику».

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


---

# 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/geoip-providers-and-strategy.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.