# Устранение неполадок

## REG.RU API

### `ACCESS_DENIED_FROM_IP`
IP сервера не разрешён в настройках API REG.RU. Добавьте адрес сервера в разделе «Настройки API» личного кабинета REG.RU. Проверьте, что запросы идут именно с этого IP:

```bash
curl -s https://api.ipify.org; echo
```

### `PARAMETER_MISSING: domain_name or service_id required`
Некоторые команды не принимают список `services`/`domains` в JSON и требуют верхнеуровневый `domain_name` или `service_id`. Raw-вызов: передайте параметр напрямую, например `{"service_id":"123456"}`. Типизированные обёртки уже делают это правильно.

### `service/get_details` возвращает пустой `services`
Для части услуг (например, ISPmanager-хостингов, VPS и выделенных серверов) REG.RU не отдаёт панельные логины и пароли. Это ответ API, а не ошибка панели. Сохраните пароль вручную в «Доступах» — он будет зашифрован и доступен агенту по API с правом `secrets:read`.

### `DOMAIN_IS_NOT_USE_REGRU_NSS`
Домен делегирован не на `ns1.reg.ru`/`ns2.reg.ru`, поэтому управлять зоной через API нельзя. Домены на `ns5/ns6.hosting.reg.ru` и `ns1/ns2.shop.reg.ru` ведутся в панели ISPmanager. Смените NS в карточке домена, если хотите управлять зоной через REG.RU.

### `NO_SUCH_COMMAND`
Команда недоступна типу аккаунта (например, партнёрские функции у обычного клиента). Проверьте каталог команд на странице «API REG.RU».

### `INSUFFICIENT_FUNDS` / `NOT_ENOUGH_MONEY`
Недостаточно средств. Пополните баланс REG.RU; продление создаст счёт.

### `IP_EXCEEDED_ALLOWED_CONNECTION_RATE`
Превышен лимит 1200 запросов/час. Панель останавливается на 1100, но параллельные скрипты могли израсходовать лимит. Подождите до конца часа; проверьте cron и сторонние интеграции.

### Ответ 502 `REGRU_API_ERROR`
Смотрите `details.api_code`/`api_text` в ответе и `var/log/app.log` (там журнал без секретов, с request id).

## Панель

### 403 `CSRF_FAILED`
Истёк или отсутствует CSRF-токен. Обновите страницу. Если повторяется: проверьте, что cookie `rg_session` не блокируется, и что панель открыта по тому же протоколу, что указан в `APP_URL` (при `SESSION_SECURE=1` на http cookie не установится).

### Пустая страница, «Загрузка панели…» не исчезает
Откройте консоль браузера:

1. 404 на `assets/js/app.js` — не выполнен `tools/build.php` или nginx не отдаёт статику;
2. CSP-ошибки — не должно быть inline-скриптов; проверьте, что index.html не правили;
3. ошибка `bootstrap` — смотрите `var/log/app.log` и ответ `/api/v1/bootstrap`.

### 500 «Внутренняя ошибка сервера»
`APP_DEBUG=1` в development покажет детали. Частые причины: неверный `APP_KEY` (длина не 32 байта после base64), нет прав на `var/`, не применены миграции.

### Сессия сбрасывается сразу
`SESSION_SECURE=1` требует HTTPS. Для локального http поставьте `SESSION_SECURE=0`. Проверьте, что nginx не переписывает cookie-path и домен.

### «Нет доменов», хотя аккаунт подключён
Выполните `regru sync --scope=all` или кнопку синхронизации. Проверьте `regru doctor --online` и `var/log/app.log` на ошибки API.

### DNS-страница пуста
Через API управляются только зоны на `ns1.reg.ru`/`ns2.reg.ru`. Остальные домены показаны в блоке «Домены на NS хостинга».

### Не приходят письма/не работают ссылки в панели
Панель не отправляет писем. Сброс пароля — только CLI: `regru user:passwd --login=... --password-stdin`.

## Развёртывание

### nginx отдаёт 404 на `/regru/`
Проверьте `nginx -T | grep -A5 'location ^~ /regru/'`, `try_files` и что front controller лежит в `<remote>/index.php`. Для подкаталога приложение само срезает префикс по `SCRIPT_NAME`; если используется нестандартный rewrite, проверьте путь в ошибке (`details.path`).

### 502 Bad Gateway
Сокет PHP-FPM в блоке nginx не совпадает с пулом сайта. Сравните `REGRU_FPM_SOCKET` и `grep listen /etc/php/*/fpm/pool.d/*.conf` (или конфиг панели).

### 403 на статике (`/regru/assets/...`)
Файлы принадлежат не тому пользователю, под которым работает nginx, или сработал `disable_symlinks if_not_owner`. Выполните `chown -R site_user:site_user <remote>`.

### Cron не выполняется
У cron минимальный `PATH` и нет `HOME`. Используйте абсолютные пути (пример в `docs/DEPLOY.md`), проверяйте `journalctl -u cron` и `/var/mail/<user>`. Запуск под тем же пользователем, что владеет файлами.

### «Database is locked»
SQLite в WAL-режиме допускает одного писателя. Панель ставит `busy_timeout=5000`; при интенсивном cron уменьшите частоту синхронизации или вынесите бэкап на ночь.

### После обновления белый экран/ошибки
Проверьте, что миграции применились (`regru doctor`), и что задеплоился новый `assets/`. Кэш браузера: обновите с `Ctrl+F5`.

## Диагностика

```bash
php backend/bin/regru doctor --online
php backend/bin/regru routes
tail -50 var/log/app.log
sqlite3 var/regru.sqlite 'select id,status,started_at,error from sync_runs order by id desc limit 5;'
```