Files
buryan-infra/docs
root cd2657b2f8 VPN: проверка «канал работает» в наблюдении + команда !vpn link
Задача 4.2 из реестра: проверка «VPN работает» в наблюдении. Сделано.

Почему отдельная проверка: порт 10443 может слушать, а трафик не
проходить — именно это мы уже видели, когда провайдер вмешивался
в поток. Открытый порт об этом не говорит.

Как проверяется (ops/vpn/vpn-check.sh): поднимается временный клиент
xray на самом VPS, идёт через него в интернет, сверяется внешний адрес.
Совпал — канал пропускает трафик. За собой убирает. Ключ берётся из
рабочей конфигурации xray, а не из файла со ссылками: тот файл лежит
на домашнем узле, а проверка идёт на VPS.

Встроено в /opt/buryan-hub/scripts/check-services.sh (функция check_vpn),
вызывается каждые 5 минут вместе с остальными проверками, провал
попадает в общую тревогу в Matrix.

Порт 2087 (Reality) намеренно не проверяется: он не работает и занесён
в план задачами VPN-2.3, иначе тревога была бы каждые 5 минут.

Проверено отдельным запуском только новой функции, без полного цикла
наблюдения (чтобы не поднять ложную тревогу): код 0, PASSED=1.

Отдельно: команда !vpn link для настройки на самом телефоне. QR с того
же экрана не считать, а ссылку из сообщения можно скопировать и вставить
в приложение. Проверены варианты !vpn link, !VPN LINK, !vpn ссылка,
а также отказ на чужой ключ и молчание на обычный текст.
2026-10-16 20:53:09 +03:00
..

buryan-hub — описание хозяйства

Документы

Документ О чём
PLAN.md Полный план развития: что делаем и в каком порядке
TASKS.md Реестр задач с отметками о состоянии
NIGHT-JOURNAL.md Журнал работ: что и как проверено
NIGHT-REPORT.md Итоговый отчёт по спринту
DATABASE-STANDARD.md Правила работы с базами
COMMANDS.md Справочник команд ботов

Порядок работ

1. Завершить обновления    (4 службы)
2. Сеть и доступ           (вход, DNS, VPS)
3. Звонки и медиа          (Element Call)
4. Сквозная связность      (единый вход, уведомления, наблюдение)
5. Улучшение служб         (по каждой)

Правила работы

Десять правил, выведенных по ходу спринта — часть на своих ошибках. Полный список: PLAN.md, раздел 7.

Главные:

  1. Проверяй записью, а не чтением.
  2. Состояние службы — по живому процессу, а не по состоянию в системе.
  3. Пустой список — это неудача.
  4. Проверяй на настоящих данных.
  5. Никогда не перезапускай Docker массово.
  6. Сбой шага — верни состояние и иди дальше.
  7. Не удаляй без проверенной копии.