Skip to content

OlConnect Manager 3.0.0 — сводный релиз (server-v0.1.0 → server-v3.0.0)

Latest

Choose a tag to compare

@github-actions github-actions released this 09 Nov 10:57
· 1 commit to master since this release

OlConnect Manager 3.0.0 — сводный релиз

Почему 3.0.0. Линия 2.4.x набрала больше сотни выпусков: панель росла от «списка инстансов с
кнопками» до узла управления подписками, зеркалами и диагностикой. 3.0.0 подводит черту — это одна
версия, в которой собрано всё, что дошло до рабочего состояния, и явно перечислено, что закрыто и
почему. Прежние релизы свёрнуты в этот; теги и история git сохранены.

Код: server-v3.0.0, ветка master.

Что было сделано

Панель из «списка инстансов с кнопками» превратилась в полноценный узел управления: создание и жизненный цикл инстансов, встроенный сервер подписок с зеркалом на Яндекс.Диск, история состояния за час, обновление бинарей из интерфейса, WB-автоматизация и диагностика по журналам. За релизным циклом — 1137 коммитов и 223 тега; ниже всё сгруппировано по темам, а не по датам.

Нововведения

Инстансы

  • Один инстанс — один юнит olcrtc-server@N со своим /etc/olcrtc/<N>/env и ключом; создание, запуск, остановка, перезапуск и удаление из панели.
  • Удаление инстанса убирает и его systemd-артефакты, и записи во всех подписках: раньше оставались висячие юниты и мёртвые ссылки.
  • Совместимость носителей и транспортов проверяется на входе: панель предлагает только рабочие комбинации, неподходящие не показываются.
  • Шифрование OpenFlux (AES-256-GCM) с генерацией ключа в интерфейсе; ключ автоматически попадает в ссылку и QR.
  • Пинг цели, карточка настроек кодеков и лимитов (vp8.fps, vp8.batch, SCTP, payload cap, bridge mode).
  • Проверка занятости перед опасным действием: панель спрашивает про активных клиентов до остановки, перезапуска и удаления.

Подписки и зеркало

  • Подписки со slug и публичным адресом /sub/<slug>; сервер подписок встроен в админку и слушает loopback, наружу публикует Caddy.
  • Встроенный сервер поднимается на том же адресе, куда указывает Caddy, и по умолчанию на порту подписок: раньше он уезжал на эфемерный порт и /sub отвечал только случайно.
  • Зеркало подписок: JSON-бандл olcrtc-sub v2 выгружается на Яндекс.Диск, клиент получает bootstrap-ссылку с ключом.
  • Зеркало может ходить через SOCKS-прокси (OLCRTC_SUB_MIRROR_PROXY) — нужно там, где прямой доступ к Диску закрыт.
  • /sub/<slug>/open — HTML-страница перехода в приложение с параметрами зеркала.
  • QR подписки: сжатие gzip и multipart-разбиение для больших профилей.
  • При удалении подписки зеркало на Диске тоже удаляется; ошибки зеркала больше не тонут в общем успехе — они возвращаются полем mirror_errors.

Безопасность

  • Хранение ключей и данных профиля упорядочено: ключи отдельными файлами с правами 0640, admin.env — 0600.
  • Копирование профиля больше не раскрывает секреты: в буфер попадает только то, что нужно для подключения.
  • Логи чистятся от чувствительных данных: токены, cookies и ключи маскируются.
  • Неудачные попытки входа ограничиваются по IP (429), панель отвечает WWW-Authenticate вместо тихого отказа.
  • Обновления проверяются по sha256 перед установкой.
  • Открытие порта WebUI автоматизировано; конфигурация Caddy приведена в рабочий вид.

Диагностика

  • История состояния инстанса за 60 минут: состояние, прирост байт, клиенты, рестарты, отказы релея. Кольцо переживает рестарт панели и лежит в instance-history.json рядом с базой подписок.
  • Журналы сервисов из journald прямо в панели, включая журнал инстанса из его карточки.
  • Проверка работоспособности соединения: пинг цели, статус OpenFlux-ноды, занятость портов, тест зеркала.
  • Диагностика мобильной сети и доступных способов подключения — в клиенте и в подсказках панели.

Стабильность и обновление

  • Автоматическое переключение между провайдерами и транспортами на клиенте: обрыв одного канала не оставляет пользователя без сети.
  • Обновление бинарей из панели: скачивание во временный каталог, install -m 0755 поверх старого файла, перезапуск сервиса.
  • Лаунчер больше не падает на CONFIG_FILE: unbound variable при отсутствии env-файла.
  • Обработчик статики отвечает честным 404 на отсутствующий ассет вместо отдачи index.html с кодом 200: сломанный путь больше не выглядит как «пустая страница».
  • Транспорты: добавлен Mail.ru, отдельные имена транспортов OpenFlux, починен watchdog SFU-слота, убран искусственный лимит скорости в goolom, vp8.max_sample_bytes наконец умеет расти.

Что больше не работает и почему

  • videochannel и seichannel. Мертвы на проекте, datachannel работает только с Jitsi. Комбинации, которые не могут подняться, убраны из интерфейса — это сознательное сужение, а не регресс.
  • Plain-text подписка в клиенте. Приложение разбирает только JSON-бандл из зеркала; /sub/<slug> остаётся для браузера. При выключенном зеркале подписка в клиент не попадёт.
  • Ручной ввод spec-URI. Убран: профиль собирается из полей формы, чтобы несовместимые параметры не попадали в конфиг.
  • Смена акцентного цвета панели. Функция была добавлена и откачена целиком; интерфейс снова монохромный.
  • Переработка интерфейса («Рейка»). Жила в ветке experimental/design-rail-2026-11, макеты в C:\Projects\ofx-design. Решение владельца — вернуть прежнюю панель; ветка остаётся экспериментом, в master её нет.
  • Встроенная копия olcrtc-launcher в установщике. Оставлен один источник правды — файл в server-install/systemd/, копия удалена, чтобы версии не расходились.

Закрытые issues

Тема Issues
Безопасность и ключи #49 более безопасное хранение ключей и данных профиля, #50 защита секретных данных при копировании профиля, #51 дополнительная очистка логов от чувствительных данных, #54 вопросы по безопасности
Установка и обновление #44 не работает обновление, #46 нельзя установить/обновить последнюю версию, #57 olcrtc-launcher: line 139: CONFIG_FILE: unbound variable
Диагностика #48 улучшить проверку работоспособности соединения, #53 диагностика мобильной сети и доступных способов подключения, #59 ошибка при создании инстанса
Ссылки и интерфейс #45 кривая ссылка через UI, #39 добавить команду открытия порта для WebUI, #38 caddy
Совместимость #52 ограничить несовместимые комбинации провайдеров и транспортов
Надёжность #47 автоматическое переключение между провайдерами и транспортами, #43 ошибки подключения клиента
Капча #56 добавление прохождения капчи
Вопросы пользователей #58 какое приложение использовать для подключения

Известные проблемы

  • #55 «Не подключается к конференции». Часть конференц-носителей поднимает сессию, но туннель не проходит дальше: нужна диагностика на стороне носителя, issue открыт.
  • Латентности в API нет. Панель показывает объём, клиентов, uptime, разрывы и отказы; измерение задержки — только явной ручкой пинга.
  • История стирается при полном удалении. instance-history.json лежит в /var/lib/olcrtc и удаляется вместе с базой подписок.
  • Капча настраивается не в панели. Обход SmartCaptcha живёт в exit-ноде OpenFlux-Android; в панели только выбор носителя и транспорта.
  • Порт подписок — значение из admin.env, а не константа. Если его меняли руками, /sub перестанет отвечать после переустановки с другим свободным портом.

Как обновиться

# панель
sudo install -m 0755 olcrtc-admin /usr/local/bin/olcrtc-admin
sudo systemctl restart olcrtc-admin

# инстансы (после деплоя серверного бинаря)
sudo install -m 0755 olcrtc /usr/local/bin/olcrtc
sudo systemctl restart 'olcrtc-server@*'

# состояние
systemctl status olcrtc-admin --no-pager
journalctl -u olcrtc-admin -n 50 --no-pager

Или установщиком, который сам забирает бинари и перезапускает сервисы:

curl -fsSL https://raw.githubusercontent.com/Oleglog/OlConnect_manager/master/server-install/olcrtc-setup.sh | sudo bash -s -- --update

На управляемом стенде держите OLCRTC_OPENFLUX_AUTO_UPDATE=false в /etc/olcrtc/env, чтобы инстансы не поднялись на другой версии exit-ноды, чем та, с которой сняты замеры.