Агент Linux (PromoBrowser) — Установка

PromoBrowser — это браузер в стиле kiosk на базе Python + PyQt5 / QtWebEngine. Работает в полноэкранном режиме, без рабочего стола (запускается напрямую на VT7), в виде службы systemd.

Требования

• Debian 12 (Bookworm) или выше, либо Ubuntu 22.04 LTS или выше.
• Доступ root (для установки системных пакетов и регистрации службы).
• Python 3.11+ (входит в Debian 12 / Ubuntu 22.04).
• Среда рабочего стола не требуется.

Быстрая установка (рекомендуется)

Выполните от имени root:

curl -fsSL https://rds.digitalsignagerds.com/install.sh | bash

Скрипт:

1. Устанавливает системные пакеты:
   • PyQt5 + QtWebEngine + gstreamer (плеер)
   • python3-xlib, xorg, xinit (минимальная сессия X)
   • gpsd + gpsd-clients (опциональный модуль GPS — если подключить USB-GPS, он определяется автоматически через USBAUTO=true)
   • onboard (экранная клавиатура для сенсорных экранов, показывается автоматически при открытии диалога настроек)
   • scrot (утилита для снимков экрана; используется системой удалённых снимков из RDS)
2. Создаёт venv в /opt/promobrowser/.venv с параметром --system-site-packages.
3. Регистрирует службу systemd kiosk-browser.
4. Настраивает автозапуск на VT7.
5. Включает gpsd.socket (активация по сокету) — демон запускается по требованию, когда его запрашивает агент или другой клиент.

После установки:

systemctl start kiosk-browser
chvt 7

chvt 7 переключает активную виртуальную консоль, чтобы вы увидели браузер на экране. Если ваша машина загружается с уже активной графической средой, этот шаг можно пропустить.

Ручная установка

git clone --branch main --depth 1 https://github.com/promotienda/promobrowser.git
cd promobrowser
sudo bash install.sh
systemctl start kiosk-browser
chvt 7

Разработка (без службы)

Если вы хотите протестировать агент, не устанавливая его как службу:

bash run.sh

Скрипт сам устанавливает зависимости и автоматически запускает X, если дисплей не обнаружен.

Проверка

systemctl status kiosk-browser        # состояние службы
journalctl -u kiosk-browser -f        # логи systemd в реальном времени
tail -f /tmp/kiosk.log                # логи приложения

Если всё в порядке, вы должны увидеть браузер в полноэкранном режиме на VT7 с URL по умолчанию (или с вашим стартовым URL, если он уже настроен).

Первоначальная настройка

При первом запуске агент открывает пустой браузер и ждёт, пока вы привяжете устройство:

1. Откройте настройки — двумя равнозначными способами:
   • Клавиатура: наберите 12345 (комбинация работает в любой момент, даже когда фокус находится на веб-странице).
   • Сенсорный экран / мышь: коснитесь 5 раз верхнего левого угла менее чем за 2 секунды.
2. Появится цифровая клавиатура с запросом passcode. По умолчанию это 0000. Как можно скорее измените его на вкладке Security.
3. Перейдите на вкладку Server:
   • Server URL — https://rds.digitalsignagerds.com (по умолчанию).
   • Username — пользователь, созданный для вас Promotienda.
   • Device ID — код RDSXXXX, который вы присвоили этому устройству в веб-панели.
   • Нажмите Test Connection — проверяет учётные данные и регистрирует устройство на сервере.
4. Конфигурация kiosk (режим Web / Playlist, стартовый URL, белый список, passcode) задаётся в веб-панели — устройство получает её при следующем heartbeat.

Минимальная версия