> ## Documentation Index
> Fetch the complete documentation index at: https://docs.axottle.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Ошибки валидации, компиляции, критические замечания линтера, ошибки применения и отказы проб — и порядок диагностики.

Почти любая проблема с Connection Unit укладывается в одну из пяти групп: не сохраняется схема (валидация), не собирается план (компиляция), блокирует применение линтер, падает само применение или отказывает проба. Начните с порядка диагностики ниже, затем перейдите к своей группе.

<Info>Для кого: администратор панели, SRE. Требуемые права: управление Connection Units, доступ к диагностике.</Info>

## Порядок диагностики

<Steps>
  <Step title="Линтер и компиляция">
    Запустите **компиляцию** черновика. Ошибки компиляции и критические замечания линтера блокируют применение — их устраняют первыми. Оба видны в диалоге плана и на вкладке **Линтер**.
  </Step>

  <Step title="Компиляция → план">
    Убедитесь, что план компиляции в статусе «скомпилирован» (не `failed`). Применение отказывается запускаться, пока план не чист.
  </Step>

  <Step title="Здоровье">
    После применения откройте вкладку **Здоровье**, запустите проверку и при необходимости соберите журналы с нод. Порядок — на странице <a href="/ru/connection-units/diagnostics">Диагностика и пробы</a>.
  </Step>
</Steps>

## Ошибки валидации (сохранение схемы)

Сервер не даст сохранить или скомпилировать топологию, нарушающую правила графа. Типичные сообщения (поведенчески):

* шлюз нельзя соединить с интернетом напрямую — между ними должна стоять входная нода;
* условная связь без корректной цели;
* CDN-блок должен вести ровно на одну входную ноду.

CDN-блок, оставленный неподключённым, допустим в черновике, но заблокирует применение. Правила соединений — на странице <a href="/ru/connection-units/constructor">Конструктор</a>.

## Ошибки компиляции (блокируют применение)

Компиляция отклоняет план, который не сможет работать:

* нет блока «Интернет» — применение невозможно; или блоков «Интернет» больше одного;
* входная нода не настроена;
* у входной ноды не назначены физические ноды;
* в схеме нет ни одного пригодного входной ноды;
* у внешнего прокси не указан адрес или порт;
* у транзитной ноды нет цели или несколько целей выхода;
* условная связь ведёт на недопустимый блок;
* некорректный ключ внешнего транзита (`vless://`).

Исправьте указанные блоки и скомпилируйте заново.

## Критические замечания линтера (блокируют применение)

Критические замечания линтера сливаются с ошибками компиляции и используют тот же барьер применения. Что исправить:

| Замечание (поведенчески)                             | Что делать                                                       |
| ---------------------------------------------------- | ---------------------------------------------------------------- |
| Открытый прокси (авторизующий протокол без клиентов) | Добавьте клиентов или смените шаблон входа.                      |
| Внутренний/служебный порт на публичном адресе        | Уберите служебный порт с публичного адреса.                      |
| Дублирующийся входной порт                           | Разведите входы по разным портам.                                |
| Некорректная маскировка TLS                          | Заполните обязательные параметры маскировки (домен, сертификат). |
| Правило ссылается на несуществующий выход            | Соедините правило с существующим выходным блоком.                |
| Безусловное правило сбрасывает весь трафик           | Добавьте условия или уберите это правило.                        |

Замечания уровней high/medium/low (нет распознавания протокола, не заблокирован SMTP, неконтролируемый IPv6, нет запасного обработчика) применение **не** блокируют, но их стоит просмотреть.

## Ошибки применения (`apply_failed`)

<AccordionGroup>
  <Accordion title="«План компиляции failed — исправьте ошибки перед применением»">
    Скомпилируйте черновик заново и устраните все ошибки компиляции, затем повторите применение.
  </Accordion>

  <Accordion title="Балансируемый Connection Unit требует подтверждения">
    Для работы балансировщика нужна включённая настройка подписки на стороне бэкенда. Если она выключена, применение вернёт запрос на подтверждение — подтвердите переключатель в диалоге применения.
  </Accordion>

  <Accordion title="Не удалось выгрузить ресурсы на бэкенд">
    Статус переходит в **Ошибка применения**, а в диалоге показан частичный список того, что уже было выгружено. Устраните причину и повторите применение — либо откатитесь на предыдущую версию.
  </Accordion>

  <Accordion title="После применения здоровье деградировало">
    Результат помечается как «частично»: схема применена, но какая-то проверка нездорова. Разбирайтесь через вкладку **Здоровье** — <a href="/ru/connection-units/diagnostics">Диагностика и пробы</a>.
  </Accordion>
</AccordionGroup>

Если применение застряло в ошибке и починить его правками не удаётся — откатитесь на предыдущую применённую версию: <a href="/ru/connection-units/lifecycle">Жизненный цикл и версии</a>.

## Отказ проб (probe refusal)

Внешняя региональная проба (L5) с входного блока возвращает ошибку, если:

* к блоку не привязана нода;
* у ноды нет IP-адреса или домена.

Привяжите ноду с адресом или доменом, проверьте подключение провайдера внешних проб и повторите запуск.

## Предупреждение об «уводе» ноды

Если входная или транзитная нода уже занята другим Connection Unit, панель предупредит перед переназначением: это «уводит» ноду из той схемы. Убедитесь, что действие намеренное, иначе можно нарушить работу другого Connection Unit.

## Проверка

<Check>Проблема решена, когда компиляция чистая, на вкладке **Линтер** нет замечаний `critical`, состояние схемы — **Применено**, а проверка здоровья возвращает `healthy`.</Check>

## Откат

* **Вернуть предыдущую рабочую схему** — откат на предыдущую версию с повторным применением: <a href="/ru/connection-units/lifecycle">Жизненный цикл и версии</a>.

Связанные страницы: <a href="/ru/connection-units/lifecycle">Жизненный цикл</a>, <a href="/ru/connection-units/routing">Маршрутизация</a>, <a href="/ru/connection-units/diagnostics">Диагностика и пробы</a>, <a href="/ru/cdn/troubleshooting">Устранение неполадок CDN</a>.

<Note>Проверено для версии Axottle текущей ветки. Дата проверки: 2026-07-11.</Note>