> 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-updates-and-diagnostics.md).

# Обновления и диагностика GeoIP

Автообновление баз MaxMind и DB-IP, ручная проверка и расшифровка диагностики GeoIP

Локальные базы GeoIP устаревают, поэтому их нужно обновлять по расписанию и проверять после загрузки. Экран использует безопасную замену: скачивает данные с официального адреса, проверяет файл и только затем делает его рабочим.

Точный путь:

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

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

## Автоматические обновления

На вкладке **«Обновления»** доступны:

| Параметр                  | Что делает                                                 |
| ------------------------- | ---------------------------------------------------------- |
| «Включить автообновление» | Разрешает плановую проверку срока локальных баз            |
| «Обновлять базы MaxMind»  | Загружает выбранные данные MaxMind при наступлении срока   |
| «Обновлять базу DB-IP»    | Загружает DB-IP Lite при наступлении срока                 |
| «Интервал обновления»     | Задаёт минимальное число дней между успешными обновлениями |
| «Час обновления по UTC»   | Задаёт час, когда система может начать загрузку            |

Автообновление выполняется фоновым расписанием. Выбирайте час UTC с учётом часового пояса команды и обычной нагрузки. Если Scheduler или связанный фоновый процесс остановлен, одно сохранение параметров не запустит обновление.

### Что требуется провайдерам

* MaxMind: сохранённые Account ID и лицензионный ключ.
* DB-IP Lite: включённый провайдер и подтверждённая видимая атрибуция **«IP Geolocation by DB-IP»**.

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

## Ручное обновление

Действия **«Обновить сейчас»** для MaxMind и DB-IP не меняют расписание и запускают отдельное обновление выбранного источника.

{% stepper %}
{% step %}

### Проверьте условия доступа

Для MaxMind убедитесь, что данные сохранены. Для DB-IP проверьте атрибуцию. Подтвердите свободное место и доступ сервера к официальному источнику загрузки.
{% endstep %}

{% step %}

### Зафиксируйте текущую диагностику

Откройте «Диагностика» и запишите последний результат и время обновления выбранного провайдера.
{% endstep %}

{% step %}

### Запустите обновление

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

{% step %}

### Проверьте результат

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

Ошибка скачивания не должна заменять исправную рабочую базу повреждённым файлом. Сохраните сообщение, проверьте доступ, сеть и условия провайдера, затем повторите только после устранения причины.

## Как читать «Диагностику»

### Общая готовность

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

### Состояние провайдеров

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

Снимайте паузу только после устранения причины. Иначе источник снова получит ошибки и будет временно пропущен.

### Состояние кеша

Блок показывает используемое хранилище, политику и число записей быстрого кеша. Действие **«Очистить кеш GeoIP»** перестаёт использовать старые результаты GeoIP, но не очищает кеш остальных разделов.

{% hint style="warning" %}
После очистки первые запросы снова обращаются к провайдерам. Это может временно увеличить задержку и расход лимита внешних сервисов. Не очищайте кеш только ради проверки кнопки.
{% endhint %}

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

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

## Частые проблемы

| Симптом                                     | Что проверить                                                                    |
| ------------------------------------------- | -------------------------------------------------------------------------------- |
| MaxMind не обновляется                      | Account ID, лицензионный ключ, доступ к официальному источнику и свободное место |
| DB-IP не обновляется                        | Подтверждение атрибуции и готовность локального провайдера                       |
| Провайдер доступен, но результат пуст       | Тип определения, полноту конкретной базы и публичность IP                        |
| Все внешние провайдеры на паузе             | Сеть, ключи, лимиты, тайм-ауты и первую общую ошибку                             |
| После обновления показываются старые данные | Кеш GeoIP и время последнего успешного обновления                                |
| Автообновление не запускается               | «Включить автообновление», выбранные базы, Scheduler и заданный час UTC          |

## Результат

Обслуживание завершено, когда история фиксирует успешную загрузку, провайдер доступен, тестовый 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/geoip-updates-and-diagnostics.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.