> 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/sistemnye-nastroiki-i-obsluzhivanie/system-settings/geoip.md).

# Настройки GeoIP

Для работы требуется право «Настройки GeoIP» или «Общие настройки».

## Где находится

Откройте:

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

## Параметры

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

«Кешировать результаты» запоминает ответ для IP и уменьшает повторные проверки. «Улучшать результат (нормализация)» приводит названия и служебные данные к согласованному виду.

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

## Влияние

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

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

Общие параметры GeoIP и справочник стран защищены разными правами. Для справочника требуется право «Разрешить управление GEOIP в админпанели».

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

### Добавление страны

Нажмите «Добавить страну». В форме «Добавление страны» заполните:

* «Название страны» — название на основном языке обязательно, остальные переводы можно добавить для активных локалей;
* «Код» — уникальный двухбуквенный код страны латиницей, например `RU`.

Код приводится к верхнему регистру и после создания не редактируется. Если код уже занят, найдите существующую запись и измените её название вместо создания дубликата.

### Изменение названия

Нажмите действие редактирования в строке, заполните переводы и нажмите «Сохранить». Изменение названия не меняет код страны. После сохранения проверьте списки стран в направлениях, городах и клиентских формах для каждой рабочей локали.

{% hint style="warning" %}
Добавление страны в справочник не разрешает направление для этой страны автоматически. Географические ограничения валют и направлений настраиваются отдельно.
{% endhint %}

## Проверка

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

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


---

# 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/sistemnye-nastroiki-i-obsluzhivanie/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.