Руководство / Устранение неполадок

Типичные ошибки YAML-конфига и их починка

Устранение неполадок · Обновлено 2026-06-08 · ~2 мин чтения

Правите конфиг или Mixin руками? Синтаксическая ошибка YAML не даст профилю загрузиться. Сверьте свою ошибку со списком:

Ошибка 1: пляшущие отступы (лидер хит-парада)

# неверно: поля выровнены по-разному
proxies:
  - name: node-A
     type: ss        # лишний пробел
# верно: одноуровневые поля выровнены строго; только пробелы, никаких Tab

Фирменные ошибки: did not find expected key, mapping values are not allowed. «Показывать пробелы» в редакторе спасает жизнь.

Ошибка 2: нет пробела после двоеточия

port:7890     # неверно — после двоеточия нужен пробел
port: 7890    # верно

Ошибка 3: спецсимволы без кавычек

password: p@ss:word!   # двоеточие внутри — неоднозначный разбор
password: "p@ss:word!" # верно: в кавычки

Пароли, имена узлов с эмодзи и значения, начинающиеся с * (как "*.lan" в fake-ip-filter), лучше всегда брать в кавычки.

Проверка

После правки перещёлкните профиль в Profiles и смотрите Logs на ошибки разбора; либо сперва прогоните фрагмент через любой онлайн-валидатор YAML. Номера строк в ошибках относятся к слитому конфигу — при активном Mixin ищите по имени поля, а не по номеру строки.