Как обновить volrix.pm с экрана «Обновления» или командой на сервере, как запланировать обновление, что делать при сбое и как откатиться.
Обновлено 29.10.2026
Обновить volrix.pm можно двумя способами: кнопками на экране «Обновления» (основной путь, команд вводить не нужно) или командой volrix-update на сервере (когда экран недоступен или версия очень старая). В обоих случаях перед обновлением снимается полная копия, а если после обновления система не поднялась, агент сам возвращает прежнюю версию. Обновление делает администратор системы: на время установки система недоступна всем пользователям, обычно несколько минут.
**Где находится:** «Администрирование» → «Обслуживание» → «Обновления». Просматривать экран можно с правом updates.read, скачивать, загружать, запускать, планировать и отменять - с правом updates.manage. По умолчанию оба права только у администратора системы.
Вверху четыре плитки: «Текущая версия», «Служба обновлений» («работает», «не отвечает», «не установлена»; у установки из исходников «не нужна»), «Свободно на диске» и «Точки отката». Под ними оранжевая плашка, если со службой проблема. Ниже по порядку:
Одновременно может быть только одна заявка. Установить версию старше текущей нельзя: система ответит, что вернуться можно только откатом. Файл, который не подходит по лицензии, получит «нет» в «Можно ставить» с причиной, например истекшей поддержкой: тогда доступны версии, вышедшие до ее окончания (плюс 30 дней льготного периода), а на бесплатной лицензии - все.
Для запланированного обновления система сама показывает всем пользователям желтую плашку с временем начала («Сохраните работу заранее»). Показывать ее начинают за столько часов, сколько задано в настройках проверки обновлений («Предупреждать пользователей о плановом обновлении, часов»: от 0 до 168, по умолчанию 24). Когда обновление идет, вместо плашки появляется окно «Идет обновление системы»: оно само обновит страницу, когда система вернется. Администраторам с правом просмотра обновлений в шапке показывается синяя плашка «Доступна версия N» (ее можно закрыть до следующей версии) или красная плашка обновления безопасности (не закрывается).
Значок шестеренки рядом с кнопкой «Проверить обновления» открывает окно «Проверка обновлений».
При проверке запрашивается только update.json и его подпись, никаких сведений о вашей системе не передается.
Перед каждым обновлением снимается точка отката, в списке видно имя вида 20261029-031500-to-1.2.0, версии и размер. Экран только показывает точки: кнопки отката на нем нет. Автоматический откат происходит сам, если обновление не прошло. Если новая версия установилась, но в ней обнаружилась проблема, откат делается командой на сервере (ниже). Откат возвращает базу данных на момент перед обновлением, поэтому все, что пользователи внесли после обновления, будет потеряно. Остановите работу пользователей до отката.
После обновлений на сервере остаются образы прошлых версий, файлы обновлений и журналы. Блок «Место на диске» в конце экрана очищает только то, что не нужно ни работающей системе, ни точкам отката; база данных, файлы, настройки, резервные копии и чужие образы не затрагиваются никогда.
Кнопки очистки доступны с правом updates.manage и когда служба обновлений работает.
Если установка выросла из старой версии, на экране может появиться плашка «Состав выпуска» или «Встречи не включены» с кнопкой «Довести до полного состава». Нажмите ее: экран покажет одну команду, ее нужно выполнить на сервере под root. Она добавляет недостающие файлы выпуска (видеовстречи и другое) и пересоздает контейнеры. Пока плашки нет, установка в полном составе. Перед пересозданием сервера видеовстреч убедитесь, что встреч нет: оно рвет идущие. Подробнее о встречах - Видеовстречи: установка и настройка.
Те же операции можно сделать вручную в каталоге установки (/opt/volrix, если ставили мастером; ~/volrix при установке без мастера). Нужны docker с compose v2, openssl, python3 и tar. Агент volrix-update лежит в этом каталоге. Запускать его нужно именно из каталога, где лежат docker-compose.release.yml и .env.
Коды завершения apply: 0 - применено, 2 - обновление не прошло проверку и система автоматически возвращена, 1 - прочие ошибки (отказ до начала или неудачный откат).
cd /opt/volrix # при установке без мастера - ~/volrix V=1.2.0 curl -fLO https://volrix.ru/download/releases/$V/volrix-$V.volrixpkg curl -fsSL https://volrix.ru/download/releases/$V/SHA256SUMS | grep " volrix-$V.volrixpkg$" | sha256sum -c - && ./volrix-update apply volrix-$V.volrixpkg ./volrix-update status
Подставьте нужную версию в V. Третья строка скачивает пакет, четвертая сверяет контрольную сумму с опубликованной и только при совпадении запускает обновление. Если сумма не совпала, обновление не начнется.
cd /opt/volrix sha256sum volrix-1.2.0.volrixpkg # сравните с SHA256SUMS ./volrix-update verify volrix-1.2.0.volrixpkg ./volrix-update apply volrix-1.2.0.volrixpkg
Комплект со страницы Скачать тоже содержит пакет обновления. Номер последней версии и контрольная сумма - в volrix.ru/download/latest.json.
cd /opt/volrix curl -fsSL https://volrix.ru/download/latest.json # подставьте номер версии из ответа curl -fL -o volrix-dist.tar.gz https://volrix.ru/download/volrix-dist-<ВЕРСИЯ>.tar.gz sha256sum volrix-dist.tar.gz tar -xzf volrix-dist.tar.gz --wildcards '*.volrixpkg' ./volrix-update apply volrix-0.0.0-<ВЕРСИЯ>.volrixpkg
Сумма из sha256sum должна совпасть с суммой в latest.json. Проще и короче - взять отдельный пакет из releases, как в предыдущем разделе.
Если плашка говорит «Служба обновлений на сервере не установлена», выполните на сервере в каталоге установки команду установки службы. Она ставит таймер systemd, который запускается каждые 30 секунд.
sudo python3 ./volrix-updater install --dir /opt/volrix
Если служба «не отвечает» (нет сигнала больше трех минут), проверьте таймер и при необходимости включите его.
systemctl status volrix-updater.timer sudo systemctl enable --now volrix-updater.timer sudo python3 ./volrix-updater status
Экран «Обновления» появился в версии 0.114.0, проверка новых версий - в 0.115.0. Если установлена версия 0.114.x, файл пакета загружается кнопкой «Загрузить файл обновления»; если ниже 0.114.0, обновляйте командами на сервере, как описано выше. Обновление меняет только код: видеовстречи, распознавание речи и ИИ-протокол на старой установке сами не появляются - как их подключить, написано в Видеовстречи: установка и настройка.
Отказоустойчивый кластер обновляется не этим экраном, а установщиком кластера: новый выпуск применяется командой volrix-cluster apply volrix-cluster.yml на сервере установщика. Узлы приложения обновляются по одному: каждый выводится из балансировки, обновляется, проходит проверку готовности и возвращается, база данных при этом не останавливается. Узлы видеовстреч тоже обновляются по одному; мост выводится так, что участники переезжают на другие мосты без выхода из встречи. Состояние узлов во время обновления видно на экране Кластер: разные версии на узлах в это время нормальны.
Расписание копий и проверка восстановления.
Первая установка и где что лежит.
Схема серверов и состояние узлов при обновлении.