BrainCam. Инструкция по установке

Версия документа: 1.2. Дата: 05.09.2026. Продукт: BrainCam — программа подсчёта объектов и сверки факта с документом по видео с камер объекта. Правообладатель: ИП Шпагин В. В.

1. Что вы получаете

Один файл дистрибутива и файл настройки участка:

Дистрибутив самодостаточен: ничего не скачивается из интернета ни при установке, ни при работе. Внутрь входит собственная среда исполнения и файлы моделей — на объекте интернет не нужен.

Почему архив, а не пакет системы. Один и тот же файл ставится на любую поддерживаемую ОС без пересборки, разворачивается одной командой и не требует доступа к репозиториям пакетов — это условие работы в закрытом контуре и на объекте без связи. Пакеты deb и rpm собираются поверх того же дистрибутива и появятся вместе со сборками под отечественные ОС (раздел 12).

2. Требования к компьютеру

Один компьютер — один участок, до 6 камер по конструкции. Участков больше — компьютеров больше, по этим же требованиям. Сколько камер компьютер держит на деле, зависит от того, как часто нужно смотреть кадр. Замер 05.09.2026 на процессоре x86-64 (AMD EPYC 7763, Ubuntu 24.04), кадр 1280×720, версия программы 0.2.0:

Числа даны для облегчённой модели, которая работает в программе по умолчанию. В поставку входит и точная модель — она подробнее разбирает сложные кадры, но смотрит кадр 6,4 с на двух ядрах и 3,7 с на четырёх, поэтому применяется к присланным записям, а не к потоку в реальном времени. Какая модель работает, задаётся в blok.conf (модель).

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

Права: установка выполняется от учётной записи с правами администратора (sudo).

3. Что подготовить до установки

1. Компьютер по разделу 2, включённый в локальную сеть объекта, с постоянным адресом.
2. Данные камер — по каждой: адрес в сети, логин, пароль, номер потока (основной или дополнительный), при наличии — полный адрес потока RTSP.
3. Файл настройки участка uchastok.json — присылаем мы после разметки по вашим записям.
4. Файл лицензии license.key — в текущей версии не нужен; когда понадобится, пришлём и переносится любым способом, включая флеш-накопитель.

4. Установка

Все команды выполняются в терминале компьютера, на который ставится программа.

# 1. Распаковать дистрибутив
tar -xzf braincam-<версия>-linux-x86_64.tar.gz
cd braincam-<версия>

# 2. Запустить установщик
sudo ./install.sh

Установщик выполняет и печатает каждый шаг:

1. проверяет процессор (AVX2), объём памяти, свободное место на диске и версию ОС;
2. создаёт системную учётную запись braincam без права входа в систему;
3. раскладывает файлы по каталогам раздела 5 и выставляет права;
4. регистрирует и включает службы braincam и braincam-web;
5. выполняет самопроверку (раздел 10) и печатает её результат.

Установка не запрашивает доступа в интернет и не изменяет настроек сети, кроме открытия порта интерфейса на локальном адресе.

Время установки — 18 секунд от распаковки архива до конца самопроверки (замер 05.09.2026 на чистой Ubuntu 24.04, архив на локальном диске; одинаково на 2 и на 8 ядрах). Обновление версии — 13 секунд.

5. Куда что устанавливается

Программа работает от учётной записи braincam, прав администратора при работе не требует и за пределы перечисленных каталогов не пишет.

Сколько места занимают данные. На каждое учтённое место сохраняется кадр-доказательство — около 300 КБ при кадре 1280×720 — и строка журнала событий около 200 байт; журнал работы программы растёт примерно на 22 КБ в час. Замер 05.09.2026 на одном участке: за 3 ч 14 мин при 66 учтённых местах данные выросли на 20,2 МБ — 6,2 МБ в час, около 150 МБ в сутки при таком темпе. Кадры старше срока хранения (по умолчанию 30 дней, blok.conf) удаляются, поэтому каталог данных при этом темпе не превышает примерно 4,5 ГБ; диска 256 ГБ хватает с многократным запасом. На участке с другим потоком мест объём считается из тех же 300 КБ на место.

6. Настройка участка

sudo cp uchastok.json /etc/braincam/uchastok.json
sudo chown root:braincam /etc/braincam/uchastok.json && sudo chmod 640 /etc/braincam/uchastok.json
sudo systemctl restart braincam

Файл содержит границы рабочей зоны, линию счёта, габариты грузового места и роли камер участка. Готовим его мы: клиент участок не настраивает и в наш кабинет настройки не заходит. Настройка применяется при запуске службы — после замены файла службу нужно перезапустить. Пока камеры не описаны (раздел 7), служба после перезапуска останавливается с записью в журнале «Список камер не прочитан: нет ни одной камеры» и пробует стартовать снова каждые 5 секунд — это ожидаемо, после раздела 7 она поднимется.

Если файл повреждён или не соответствует формату, служба не запускается и печатает в журнал строку с указанием ошибки; предыдущая настройка при этом сохраняется в /etc/braincam/uchastok.json.bak.

7. Подключение камер

Камеры описываются в /etc/braincam/kamery.conf, по одной строке на камеру:

# номер | роль        | адрес потока
1       | schet       | rtsp://логин:пароль@192.168.10.11:554/Streaming/Channels/101
2       | obzor       | rtsp://логин:пароль@192.168.10.12:554/Streaming/Channels/101

Роли камер: schet — счёт (на ней стоит линия), obzor — обзор, dokumenty — пост документов, kuzov — крупный план, zona — зона приёмки. Роли должны совпадать с ролями в uchastok.json. Для проверки без камер вместо адреса потока можно указать путь к видеозаписи на этом компьютере (например /srv/zapis.mp4, файл должен быть доступен на чтение всем): программа гоняет её по кругу как поток камеры.

После правки файла:

sudo systemctl restart braincam
sudo journalctl -u braincam -n 50

В журнале по каждой камере печатается «поток открыт» или причина отказа (неверный адрес, отказ в доступе, недоступный узел).

Программа только читает потоки камер. Она не изменяет их настроек, не пишет архив видеонаблюдения и не вмешивается в работу вашего видеорегистратора.

8. Запуск, остановка, автозапуск

sudo systemctl start braincam          # запустить счёт
sudo systemctl stop braincam           # остановить
sudo systemctl restart braincam        # перезапустить после смены настройки
sudo systemctl status braincam         # состояние
sudo systemctl enable braincam braincam-web    # автозапуск после перезагрузки (включён установщиком)

Обе службы поднимаются автоматически при включении компьютера, вход в систему для этого не нужен: программа ведёт себя как прибор — подали питание, участок работает.

Служба не поднялась — порядок действий:

1. sudo systemctl status braincam — причина в последней строке;
2. sudo journalctl -u braincam -n 100 — подробности;
3. sudo /opt/braincam/bin/braincam --проверка — самопроверка (раздел 10);
4. типовые причины — раздел 11.

9. Экран участка в браузере

Служба braincam-web отдаёт экран участка по локальной сети:

http://<адрес компьютера в вашей сети>:8080/

Открывается с любого компьютера объекта в браузере. Интернет для этого не нужен — это локальная сеть, как страница настроек сетевого оборудования.

• Порт по умолчанию — 8080, меняется в /etc/braincam/blok.conf.
• Наружу за периметр объекта интерфейс не публикуется: программа сама никуда не подключается, открывать порт в интернет не требуется и не рекомендуется.
• Экран работает только на чтение: с него нельзя изменить настройку участка.

10. Самопроверка

sudo /opt/braincam/bin/braincam --проверка

Проверяются и печатаются одной таблицей: версия программы · процессор и память · свободное место на диске · наличие и целостность файла модели · чтение настройки участка · доступность каждой камеры · состояние лицензии · права на каталоги.

Самопроверка выполняется установщиком, и её же просим выполнить при любом обращении в поддержку — её вывод отвечает на большинство вопросов без выезда.

11. Типовые неполадки

12. Операционные системы

Текущая поддерживаемая система — Ubuntu 24.04 LTS.

13. Лицензия

Программа работает по файлу-ключу /etc/braincam/license.key. В ключе — номер участка и срок действия; ключ подписан правообладателем, изготовить его больше никто не может.

sudo cp license.key /etc/braincam/license.key
sudo chown root:braincam /etc/braincam/license.key && sudo chmod 640 /etc/braincam/license.key
sudo systemctl restart braincam

• Интернет для лицензии не нужен. Ключ передаётся любым способом и переносится флеш-накопителем.
• Срок подходит к концу — присылаем новый ключ заранее; после окончания срока действует льготный период, чтобы работа участка не остановилась ночью.
• Лицензия привязана к сроку и участку, а не к железу: компьютер можно заменить.

14. Обновление

tar -xzf braincam-<новая версия>-linux-x86_64.tar.gz
cd braincam-<новая версия>
sudo ./install.sh --обновление

При обновлении сохраняются: настройка участка, файл лицензии, накопленные кадры, журнал и отчёты. Заменяются программа, среда исполнения и файлы моделей. Службы перезапускаются автоматически, настройка камер не теряется. Обновление приходит от нас файлом — программа сама ничего не скачивает.

15. Перенос на другой компьютер и восстановление

1. Поставить дистрибутив по разделу 4 на новый компьютер.
2. Перенести каталоги /etc/braincam/ (настройка и ключ) и, если нужна история, /var/lib/braincam/ (кадры, журнал, отчёты).
3. Запустить самопроверку (раздел 10) и убедиться, что камеры доступны с нового адреса.

Переустановка программы данных не удаляет: каталоги настройки и данных сохраняются.

16. Что программа отправляет наружу

Ничего. Ни кадр, ни цифра, ни отчёт не покидают объект: программа считает на этом компьютере, хранит результат на нём же и отдаёт его по локальной сети. Исходящих соединений в интернет не устанавливает, облачных служб не использует, обновления получает файлом от нас. Проверить это можно средствами вашей службы безопасности — исходящий трафик у программы отсутствует.

17. Удаление

sudo /opt/braincam/bin/uninstall.sh          # программа и службы
sudo /opt/braincam/bin/uninstall.sh --всё    # вместе с настройкой и данными

Без ключа --всё каталоги /etc/braincam/ и /var/lib/braincam/ сохраняются.

18. Поддержка

info@braincam.ru · +7 (927) 820-85-85 · braincam.ru При обращении приложить вывод самопроверки (раздел 10) и последние 100 строк журнала (sudo journalctl -u braincam -n 100). Поддержка ведётся на территории Российской Федерации, на русском языке.