# Файлы геоданных

Перезагружает файлы геоданных по расписанию, а также может перед перезагрузкой скачать новые `.dat` файлы. Это подходит для случаев, когда перезапуск Xray нежелателен, но geodata нужно периодически обновлять.

На устройствах с малым объемом памяти используйте с осторожностью.

## GeodataObject

`GeodataObject` соответствует элементу `geodata` в файле конфигурации.

```json
{
  "geodata": {
    "cron": "0 4 * * *",
    "outbound": "proxy",
    "assets": [
      { "url": "https://example.com/geoip.dat", "file": "geoip.dat" },
      { "url": "https://example.com/geosite.dat", "file": "geosite.dat" }
    ]
  }
}
```

> `cron`: string

Стандартное cron-выражение из 5 полей, выполняется в локальном часовом поясе среды, где запущен Xray. Например:

- `"0 4 * * *"`: выполнять каждый день в 04:00.
- `"30 3 * * 1"`: выполнять каждый понедельник в 03:30.

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

> `outbound`: string

`tag` исходящего прокси, используемого при загрузке файлов geodata. Если не указано, загрузка идет через модуль маршрутизации.

> `assets`: \[ [AssetObject](#assetobject) \]

Список файлов geodata, которые нужно скачать и заменить.

Если после загрузки перезагрузка завершится ошибкой, все файлы, замененные в рамках этого обновления, будут откатаны вместе.

### AssetObject

```json
{
  "url": "https://example.com/geoip.dat",
  "file": "geoip.dat"
}
```

> `url`: string

URL для загрузки ресурса. Должен быть HTTPS URL.

> `file`: string

Имя файла ресурса для записи, например `geoip.dat` или `geosite.dat`.

Файл разрешается через [путь к файлам ресурсов](./features/env.md#путь-к-файлам-ресурсов). Это должен быть уже существующий обычный файл внутри каталога ресурсов; абсолютные пути и пути с выходом за пределы каталога ресурсов не поддерживаются.