Установка Vision на Linux

Vision поставляется как единый бинарный файл для Linux со встроенным веб-интерфейсом и базой данных. Бинарный файл устанавливает себя как сервис systemd.

Требования

• Linux x86-64 (Ubuntu 20.04+, Debian 11+, RHEL 8+ или любой современный дистрибутив)
• Минимум 512 МБ RAM
• Доступ root (для однократной установки)
• ffmpeg и ffprobe на хосте — нужны для проверки камер и экспорта клипов
• Один или несколько доступных серверов Cesbo Alta
• Исходящий HTTPS на ls1–ls3.cesbo.com и app.cesbo.com для лицензии

Установка

1. Запустите установщик

   curl -fsSL https://vision.cesbo.com/install.sh | sh

   Установщик скачивает последнюю стабильную сборку для Linux x86-64, устанавливает бинарный файл в /usr/local/bin/ и запускает vision install. Если вы работаете не от root, для привилегированных шагов он использует sudo.

Это всё. Установщик выводит URL для открытия (сначала адрес в локальной сети) и сгенерированные данные для входа администратора.

Установка конкретной сборки

Сборки публикуются по адресу https://cdn.cesbo.com/vision/builds/vision-<tag>, где начальная v тега отбрасывается — например, релиз v261105 соответствует файлу vision-261105.

sudo curl -Lo /usr/local/bin/vision https://cdn.cesbo.com/vision/builds/vision-<tag>
sudo chmod +x /usr/local/bin/vision
sudo vision install

Что делает vision install

Установщик идемпотентен — повторный запуск после загрузки более нового бинарного файла обновляет сервис, сохраняя вашу конфигурацию и данные.

• Создаёт отдельного системного пользователя vision (без входа в систему).
• Генерирует ключ шифрования, секрет JWT и случайный пароль администратора в /etc/vision/vision.env.
• Записывает рабочую конфигурацию в /etc/vision/config.yaml.
• Создаёт пустой /etc/vision/license.txt для лицензии и никогда его не перезаписывает.
• Сохраняет базу данных и данные приложения в /var/lib/vision/. Записи камер остаются на Alta.
• Устанавливает и запускает unit systemd vision.service.
• Выводит URL доступа и учётные данные администратора (показываются один раз).

Путь	Назначение
/usr/local/bin/vision	Бинарный файл
/etc/vision/config.yaml	Конфигурация
/etc/vision/vision.env	Секреты (ключи, пароль администратора)
/etc/vision/license.txt	Серийный номер лицензии, записывается при активации
/var/lib/vision/	База данных и данные приложения
/etc/systemd/system/vision.service	Unit сервиса

Перед экспортом клипов или снимков экрана выберите хранилище по умолчанию в Settings → Storages → Clips & Screenshots. Экспортированные файлы не входят в архивы, создаваемые обычным vision backup.

Первый вход

Откройте URL, выведенный установщиком (по умолчанию сервер слушает порт 3303):

http://your-server-ip:3303

Установщик записывает http.secure_cookies: false, поэтому вход работает по обычному http://. Когда перед Vision появится HTTPS (обратный прокси), установите значение true и выполните sudo vision restart.

Осторожно

Открывайте Vision по адресу в локальной сети или по публичному имени, а не через localhost — через localhost видео HLS в реальном времени позже будет отклоняться.

Войдите с email и паролем администратора, показанными установщиком. Первый экран — Settings → License: Vision остаётся заблокированным, пока не будет активирован. Email всегда admin@localhost, пароль генерируется. Оба значения также хранятся в /etc/vision/vision.env.

Заметка

ADMIN_EMAIL и ADMIN_PASSWORD в /etc/vision/vision.env задают первую учётную запись администратора, только пока таблица пользователей пуста. Их изменение после первого запуска не влияет на существующую учётную запись — вместо этого смените пароль в интерфейсе. Если вы полностью заблокированы и не можете открыть интерфейс, восстановите пароль администратора с хоста — см. Восстановление забытого пароля.

Следующие шаги

1. Активируйте лицензию — Settings → License → Activate. Свежая установка заблокирована, пока вы этого не сделаете.
2. Добавьте сервер Alta — Settings → Connections → Add Server. Пока это не сделано, vision status сообщает Not ready: no Alta server yet.
3. Добавьте камеры.
4. Задайте хранилище для клипов и снимков экрана в Settings → Storages.

http.allowed_origins предзаполнен обнаруженными адресами локальной сети. Редактируйте его в /etc/vision/config.yaml только когда пользователи подключаются к Vision через прокси или по публичному имени, затем выполните sudo vision restart.

Управление сервисом

sudo vision status           # unit state, readiness, data sizes
sudo vision restart          # validates the config, then restarts
sudo vision logs -f          # follow logs (no root needed)
vision version               # print version
sudo vision uninstall        # remove (add --purge to also delete data + user)

Сервис автоматически перезапускается при сбое (systemd Restart=on-failure). Это тонкие обёртки над systemctl/journalctl — см. Справочник CLI, где приведён полный набор команд, включая vision doctor для автономной диагностики и vision backup/vision restore для резервного копирования.

Обновление

Чтобы обновиться до последней стабильной сборки, запустите установщик повторно — он скачивает последний бинарный файл, распаковывает его и заново запускает vision install, сохраняя вашу конфигурацию и базу данных:

curl -fsSL https://vision.cesbo.com/install.sh | sh

Чтобы сделать то же самое вручную, по адресу https://cdn.cesbo.com/vision/latest/vision-linux-x86_64.tar.gz доступен архив tar.gz с бинарным файлом vision:

curl -L https://cdn.cesbo.com/vision/latest/vision-linux-x86_64.tar.gz | tar -xz
sudo ./vision install

install перезапускает сервис всякий раз, когда запущенный процесс старше бинарного файла на диске.