# 03 · Настройки

Панель читает один файл формата `KEY=VALUE`. Порядок поиска:

1. путь из `FORNEX_ENV`;
2. `.env` в корне приложения;
3. `fornex.env` уровнем выше корня приложения (рекомендуется — вне корня сайта).

Если файла нет, используются настоящие переменные окружения: так панель запускается в
контейнере и в проверке CI. Настоящая переменная окружения всегда важнее файла, поэтому одно
значение можно переопределить на один запуск, ничего не редактируя.

Относительные пути в `DB_PATH`, `LOG_PATH`, `SNAPSHOT_DIR` считаются от корня приложения;
абсолютные используются как есть.

## Приложение

| Ключ | По умолчанию | Действие |
|---|---|---|
| `APP_NAME` | `Fornex Control` | заголовок окна и шапка страницы |
| `APP_ENV` | `production` | в `development` в ответ попадает текст исключения |
| `APP_VERSION` | `1.1.0` | показывается в интерфейсе и в `/api/health`; попадает в `?v=` ссылок на статику |
| `APP_URL` | `http://localhost:8080/` | канонический адрес, используется только в сообщениях |
| `APP_BASE` | пусто | подкаталог в URL, например `/fornex`; интерфейс добавляет его к своим запросам |
| `APP_TIMEZONE` | `UTC` | часовой пояс отметок времени, которые пишет панель |

## API Fornex

| Ключ | По умолчанию | Действие |
|---|---|---|
| `FORNEX_API_KEY` | — | **обязателен**: без него панель не запускается |
| `FORNEX_BASE_URL` | `https://ru.fornex.com/api` | публичный API живёт на хосте `ru.`; `fornex.com/api/` отвечает 302/403 |
| `FORNEX_TIMEOUT` | `30` | секунд на HTTP-запрос |
| `FORNEX_RETRIES` | `2` | повторы только для сети и 5xx, никогда для бизнес-ошибки |
| `FORNEX_USER_AGENT` | `fornex-control/1.1` | без браузерного `User-Agent` запросы к Fornex подвисают на TLS |
| `FORNEX_DEFAULT_IP` | пусто | подставляется в пресеты «сайт на VPS» и «почта на VPS»; пусто — поле обязательно заполнить |

## Вход

| Ключ | По умолчанию | Действие |
|---|---|---|
| `ADMIN_LOGIN` | `admin` | имя входа |
| `ADMIN_PASSWORD_HASH` | пусто | результат `password_hash()`; пусто — вход запрещён |
| `AUTO_LOGIN_IP` | пусто | адрес, с которого сессия выдаётся без пароля; пусто — механизм выключен |
| `SESSION_NAME` | `fnx_session` | имя cookie |
| `SESSION_IDLE` | `1800` | секунд бездействия до выхода |
| `SESSION_SECURE` | `1` | cookie только по HTTPS; `0` — лишь для локального HTTP |

`AUTO_LOGIN_IP` даёт право записи без пароля с одного адреса. Это удобство для рабочего места
внутри своей сети, а не способ аутентификации: оставляйте пустым, если сеть и адрес не ваши.

## Локальное состояние

| Ключ | По умолчанию | Действие |
|---|---|---|
| `DB_PATH` | `var/fornex.sqlite` | журнал, индекс снимков, токены API, попытки входа |
| `LOG_PATH` | `var/log/app.log` | журнал с ротацией: 5 МБ на файл, хранится 5 файлов |
| `LOG_LEVEL` | `info` | `debug`, `info`, `warning`, `error` |
| `SNAPSHOT_DIR` | `var/snapshots` | по каталогу на домен: BIND-файл и JSON с идентификаторами записей |

Каталог с базой и журналом должен быть доступен на запись пользователю PHP и недоступен по
HTTP. `var/` исключён в `.gitignore`.

## Проверка DNS

| Ключ | По умолчанию | Действие |
|---|---|---|
| `VERIFY_RESOLVER` | `8.8.8.8` | публичный резолвер: «что видит мир» |
| `VERIFY_AUTHORITATIVE` | `ns1.fornex.com` | авторитетный сервер Fornex: зона как она есть, без кеша |

Две половины отчёта существуют, чтобы различать «записи нет» и «резолвер ещё не догнал» — после
изменения зоны это разные вещи с разными действиями.

## Пределы безопасности

В `backend/config/defaults.php`:

| Ключ | По умолчанию | Действие |
|---|---|---|
| `security.login_attempts` | `10` | неудачных входов с адреса до ответа `429` |
| `security.login_window` | `900` | окно в секундах |

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

## Что не настраивается намеренно

- Зона никогда не кешируется локально.
- Записи `SOA` и `NS` не редактируются ни из интерфейса, ни из CLI.
- Удаление только по числовому `id`; настройки, включающей шаблонное удаление, нет.
- Снимок перед записью обязателен и не отключается.