Repository navigation
Releases
OlConnect Manager 3.0.0 — сводный релиз (server-v0.1.0 → server-v3.0.0)
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-subv2 выгружается на Яндекс.Диск, клиент получает 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-ноды, чем та, с которой сняты замеры.