Документация · версия 1.0.0
Программа для ЭВМ «Тембр»
Руководство администратора
Установка, настройка и эксплуатация
| Наименование программы | «Тембр» — программа расшифровки аудио- и видеозаписей в текст с разделением по говорящим |
| Версия | 1.0.0 |
| Класс ПО | 07.04 «Средства распознавания и синтеза речи» |
| Правообладатель | ООО «Веб 3.0», ИНН 5027321593, ОГРН 1235000127218 |
| Техническая поддержка | veb3.0@yandex.ru, по будням с 10:00 до 19:00 (МСК) |
| Сайт | https://tembr.web3-0.ru |
| Дата документа | 17.10.2026 |
Содержание
- Назначение и состав
- Требования к оборудованию и программному окружению
- Состав дистрибутива
- Установка на Linux
- Первый запуск: заведение администратора 5а. Лицензия: активация, проверка, отвязка, корпоративная поставка
- Учётные записи и роли
- Расписание работы
- Защищённое соединение (HTTPS) и сертификат
- Служба и автозапуск
- Параметры запуска и переменные окружения
- Где хранятся данные
- Обновление
- Резервное копирование и восстановление
- Журналы и диагностика
- Удаление
- Типичные неполадки
- Учётная запись для проверки экспертами
- Дополнительные платформы: Windows и macOS
- Обращение в поддержку
1. Назначение и состав
«Тембр» — сервис расшифровки записей, который работает внутри организации. Он ставится на сервер (или рабочую станцию) организации; пользователи открывают его в браузере, отправляют записи, получают текст с разметкой говорящих. Записи и результаты хранятся только на этом сервере, в интернет и в сторонние сервисы не передаются. В интернет программа обращается только для проверки лицензии — на сервер ООО «Веб 3.0» в России (раздел 5а); корпоративная поставка (тариф «Enterprise», для компьютеров без интернета) работает без ключа, и обращений нет вовсе.
Состав программы:
| часть | назначение |
|---|---|
transcriber_web.py | веб-сервер: страницы, вход, приём файлов, выдача результатов |
transcriber_core.py | ядро: чтение звука, распознавание, разметка говорящих, хранение |
transcriber_jobs.py | очередь задач: расчёт идёт по одной записи |
transcriber_users.py | учётные записи, пароли, сеансы |
transcriber_schedule.py | расписание работы и журнал нагрузки |
transcriber_export.py | выгрузка в Word (.docx) и субтитры (.srt) |
transcriber_platform.py | выбор файла и описание оборудования |
transcriber_window.py | настольное окно (используется в поставке для macOS) |
transcriber_license.py, transcriber_ed25519.py | лицензия: ключ, активация, проверка подписи жетона |
web/ | интерфейс: HTML, CSS, JavaScript без внешних библиотек |
models/ | веса моделей распознавания и разметки говорящих, тексты их лицензий |
Распознавание речи выполняется локально моделью large-v3 (движок
faster-whisper на Linux и Windows), разметка говорящих — локальной моделью
pyannote. Авторы и лицензии моделей показаны на странице «О программе».
Базы данных нет: каждая расшифровка — отдельный файл JSON в папке пользователя, от имени которого работает сервис (раздел 11).
2. Требования к оборудованию и программному окружению
2.1. Операционная система
Основная платформа — Linux:
- Astra Linux Special Edition 1.8 (x86-64);
- РЕД ОС 7.3 и 8.
Проверка 13.10.2026 (протокол — 40-протоколы/), облачные серверы
Рег.облака, 4 vCPU Intel Xeon (Cascadelake), 4 ГБ ОЗУ + 4 ГБ подкачки:
| РЕД ОС 7.3.6 «Муром» | Astra Linux SE 1.8.2 «Орёл» | |
|---|---|---|
| ядро / glibc | 6.1.143 / 2.28 | 6.1.124 / 2.36 |
| установка из архива без сети | да, 71 с | да, 34 с |
| расшифровка с ролями без сети | да, 104,3 с | да, 105,5 с |
| служба systemd | ставится | ставится и запускается |
| веб-интерфейс | работает | работает |
Сеть на время установки и расчёта отключалась на уровне ядра
(unshare -n). Результат расшифровки на обеих ОС совпал слово в слово.
Замкнутая программная среда Astra в облачном образе выключена — работу с
включённой ЗПС проверить на машине заказчика. РЕД ОС 8 отдельно не
проверялась.
Дополнительные платформы — Windows 10/11 x64 и macOS 13+ на процессорах Apple — описаны кратко в разделе 18.
2.2. Оборудование
| минимально | рекомендуется | |
|---|---|---|
| процессор | 4 ядра | 8 ядер |
| оперативная память | 8 ГБ | 16 ГБ |
| видеокарта | не обязательна | NVIDIA с видеопамятью от 8 ГБ |
| диск | 40 ГБ | 60 ГБ |
Штатный режим — расчёт на процессоре. Видеокарта NVIDIA ускоряет расчёт в несколько раз; её драйвер и библиотеки CUDA — собственность NVIDIA, в поставку программы не входят и устанавливаются заказчиком при желании.
Ориентиры по времени (замер 25.09.2026, Apple M4, модель large-v3): на графическом процессоре расчёт с разделением по говорящим занимает около 0,3 длительности записи, на процессоре — около 1,7 (час записи — полтора–два часа; без разделения по говорящим — около часа). Подсказка на экране новой расшифровки называет время по тому, есть ли видеокарта. На стендах проверки (13.10.2026, 4 vCPU Intel Xeon, режим процессора, модель large-v3 с разделением по говорящим) запись 41,0 с считалась 104,3 с на РЕД ОС 7.3.6 и 105,5 с на Astra Linux SE 1.8.2 — около 2,5 длительности записи. При 4 ГБ ОЗУ без подкачки расчёт завершается ядром по нехватке памяти, поэтому минимум — 8 ГБ.
Место на диске складывается из: программы с окружением (PyTorch — около 2,5 ГБ, модели — около 3 ГБ), присылаемых записей (до 5 ГБ каждая, хранятся только на время расчёта), копий звука для плеера (около 30 МБ на час записи) и расшифровок (около 100 КБ на час).
2.3. Программное окружение
- Python 3.10–3.13. Устанавливать заранее не нужно: установщик берёт его из дистрибутива (офлайн-вариант) или ставит рядом с программой, не трогая системный.
- systemd — для работы в виде службы (без него программу можно запускать вручную).
- Права root нужны только для однократных действий: включение
loginctl enable-linger(автозапуск без входа в систему) и, при необходимости, драйвер NVIDIA. Сама программа ставится и работает от имени обычного пользователя, в его домашней папке.
2.4. Сеть
- Порт сервиса по умолчанию — 7870/TCP; при работе по HTTPS служба слушает 8443/TCP, а старый адрес на 7870 переадресует на https (раздел 8.3).
- Для расчёта выход в интернет программе не нужен: веса моделей
входят в дистрибутив, служба при их наличии запрещает обращения к
внешним хранилищам моделей (переменная
TRANSCRIBER_OFFLINE=1). - Для лицензии нужен исходящий доступ по HTTPS (порт 443) к
tembr.web3-0.ru: при активации и затем раз в сутки; без связи лицензия действует 14 дней. Корпоративной поставке (Enterprise) доступ в интернет не нужен совсем (раздел 5а.4). - Если выход в интернет — через прокси-сервер организации, проверка
лицензии использует системные переменные
HTTPS_PROXY/HTTP_PROXY(стандартный механизм Python): их нужно задать в окружении службы. Если выхода нет совсем — корпоративная поставка (Enterprise) без сети. - Для установки без офлайн-склада нужен доступ в интернет (см. 4.3).
2.5. Рабочие места пользователей
Браузер текущей версии: Chrome, Edge, Safari или Firefox; поддерживаются и телефоны. Установка программ на рабочие места не требуется. Извлечение звука из видео в браузере перед отправкой работает только по HTTPS (раздел 8).
3. Состав дистрибутива
Дистрибутив для Linux — архив tembr-1.0.0-linux.zip (в общем виде
tembr-<версия>-linux.zip). Внутри всё лежит в папке tembr/ без
номера версии — чтобы новая версия распаковывалась поверх прежней.
| файл или папка | назначение |
|---|---|
transcriber_*.py, web/ | программа |
models/ | веса моделей и папка models/лицензии/ с текстами лицензий |
склад/ | офлайн-склад: Python, пакеты, чтение звука (может отсутствовать — см. 4.3) |
tools/uv-x86_64, tools/uv-aarch64 | установщик Python для архитектур x86-64 и ARM64 |
УСТАНОВИТЬ.sh | установщик |
служба.sh | установка, удаление и проверка службы systemd |
проверка-видеокарты.py | проверка: на чём считает программа |
сертификат.py | выпуск самоподписанного сертификата |
КАК ПОДНЯТЬ СЕРВЕР.md | краткая памятка по установке |
token.txt | служебный файл; при поставке с весами моделей заполнять не нужно |
Номер установленной версии:
venv/bin/python transcriber_web.py --version
Выводит строку вида Тембр 1.0.0, ООО «Веб 3.0». Тот же номер — на
странице «О программе».
4. Установка на Linux
4.1. Подготовка (с правами root, один раз)
-
Завести обычную учётную запись, от имени которой будет работать сервис (без прав sudo). Далее она называется «пользователь службы».
-
Включить автозапуск пользовательских служб без входа в систему:
sudo loginctl enable-linger <пользователь службы> -
Только для ускорения на видеокарте: установить драйвер NVIDIA и убедиться, что
nvidia-smiпоказывает карту. -
Только для установки без офлайн-склада (4.3): установить заголовки FFmpeg и компилятор.
Astra Linux (и другие на основе Debian):
sudo apt install build-essential pkg-config libavformat-dev \ libavcodec-dev libavdevice-dev libavutil-dev libswscale-dev \ libswresample-dev libavfilter-devРЕД ОС: пакеты
ffmpeg-devel(илиlibavformat-devel) иgcc.Выпуск 1.0.0 поставляется со складом: при установке из архива на x86-64 эти пакеты не нужны.
-
Открыть в межсетевом экране порт сервиса, чтобы коллеги могли подключиться к серверной установке (7870/TCP; при HTTPS — также 8443/TCP).
РЕД ОС:
sudo firewall-cmd --permanent --add-port=7870/tcp && sudo firewall-cmd --reloadAstra Linux (если включён ufw):
sudo ufw allow 7870/tcp
4.2. Установка (от имени пользователя службы)
unzip tembr-1.0.0-linux.zip -d ~
cd ~/tembr
bash УСТАНОВИТЬ.sh
На минимальных образах РЕД ОС и Astra нет unzip. Распаковать архив
можно самим Python (cd ~ && python3 -m zipfile -e tembr-1.0.0-linux.zip .)
или поставить unzip: sudo dnf install unzip (РЕД ОС),
sudo apt install unzip (Astra).
Установщик выполняет шесть шагов и пишет о каждом:
| шаг | что происходит |
|---|---|
[0/6] | проверяет, что файлы программы на месте, и сообщает, есть ли офлайн-склад |
[1/6] | находит подходящий Python (3.10–3.13) или берёт/ставит Python 3.12 рядом с программой |
[2/6] | создаёт окружение venv в папке программы |
[3/6] | ставит PyTorch |
[4/6] | ставит чтение звука (PyAV) |
[5/6] | ставит движок распознавания и веб-сервер |
[6/6] | проверяет, что веса моделей на месте, и ставит службу (раздел 9) |
В конце выводится «Установка завершена.» Если веса моделей найдены, установщик пишет «веса моделей установлены — интернет для работы не нужен».
Системные папки и системный Python установщик не изменяет: всё ставится
внутрь ~/tembr.
4.3. Варианты установки: офлайн и из сети
Офлайн (рекомендуется). Если в архиве есть папка склад/ и машина
имеет архитектуру x86-64, установщик берёт Python, все пакеты и чтение
звука из архива и в сеть не обращается. Чтение звука в складе собрано
со своей сборкой FFmpeg под лицензией LGPL, поэтому заголовки FFmpeg и
компилятор не нужны. PyTorch в складе — вариант для процессора.
Склад входит в выпуск 1.0.0: архив tembr-1.0.0-linux.zip (3,4 ГБ),
внутри папка склад/. Расчёт при полностью отключённой сети проверен
13.10.2026 на РЕД ОС 7.3 и Astra Linux SE 1.8.
Ускорение на видеокарте после офлайн-установки ставится отдельно, при разовом доступе в сеть и установленном драйвере NVIDIA:
venv/bin/python -m pip install --force-reinstall torch torchaudio \
--index-url https://download.pytorch.org/whl/cu126
(cu126, cu128 или cu130 — по версии CUDA, которую показывает
nvidia-smi).
Из сети. Если склада нет (или машина не x86-64), установщик:
- ищет системный Python 3.10–3.13, а если его нет — ставит Python 3.12
рядом с программой (установщик
uvлежит в архиве); - скачивает PyTorch: при наличии
nvidia-smi— сборку с поддержкой видеокарты (перебираяcu126,cu128,cu130), иначе — для процессора; - собирает чтение звука против системного FFmpeg (нужны заголовки — 4.1, п. 4). Если собрать не удалось, установщик предупредит и поставит готовый пакет, в котором есть компоненты под лицензией GPL; для поставки в составе продукта такой вариант не используется;
- скачивает остальные библиотеки.
Для этого варианта нужен доступ к PyPI и download.pytorch.org на время установки (около 2,5 ГБ).
4.4. Проверка установки
cd ~/tembr
venv/bin/python transcriber_web.py --version
venv/bin/python -c "import transcriber_core as c; print(c.где_модели())"
venv/bin/python проверка-видеокарты.py
- вторая команда должна начинаться с «привезены в дистрибутиве: …»;
проверка-видеокарты.pyпечатает, что видит PyTorch, и в конце строку «ИТОГ: …» — на видеокарте или на процессоре идёт разметка говорящих.
Результат на стендах 13.10.2026: установщик отработал без сети от
обычного пользователя (РЕД ОС 7.3.6 — 71 с, Astra Linux SE 1.8.2 — 34 с);
вторая команда вывела «привезены в дистрибутиве: /home/expert/tembr/models
(в сеть за ними не ходим)»; разметка говорящих — на процессоре (cpu),
видеокарты на стендах нет. Снимки экрана — в протоколе проверки
(40-протоколы/).
5. Первый запуск: заведение администратора
Программа не открывается в сеть без учётных записей: пока не заведён ни один пользователь, наружу отдаётся только страница входа.
-
Запустите службу (если она ещё не запущена):
systemctl --user start transcriber -
Найдите в журнале службы код первого запуска — шесть знаков:
journalctl --user -u transcriber -n 50Рядом будет текст «Пользователей ещё нет. Откройте адрес выше и заведите администратора. Понадобится код первого запуска». Код действует до перезапуска программы.
-
Откройте в браузере
http://<адрес сервера>:7870/. Страница называется «Первый запуск». Введите имя, пароль (не короче шести знаков) и «Код первого запуска», нажмите «Завести администратора». -
Программа войдёт под новым администратором. Все записи, сделанные до появления учётных записей, становятся его.
Код нужен, чтобы администратором стал тот, у кого есть доступ к серверу, а не тот, кто первым открыл адрес.
При локальном запуске (сервис слушает только 127.0.0.1) код не
спрашивается, а пока пользователей нет, вход не требуется вовсе.
5а. Лицензия: активация, проверка, отвязка, корпоративная поставка
Без действующей лицензии программа открывается и показывает готовые расшифровки, но новые расшифровки не запускаются. Лицензией управляет администратор на странице «Лицензия» (пункт бокового меню); обычные пользователи видят только её состояние.
Тарифы и места. Ключ определяет тариф («Личный» или «Команда»), число мест и срок — один год. Место — один компьютер либо одна учётная запись на серверной установке. Серверная установка занимает все места ключа, а учётных записей на ней можно завести не больше, чем мест. Нужны и сервер, и отдельные компьютеры с программой — это два ключа. Тариф «Enterprise» ключом не оформляется: по договору организация получает отдельную корпоративную поставку (раздел 5а.4).
5а.1. Активация
- Заведите администратора (раздел 5) и войдите под ним.
- Откройте «Лицензия», вставьте ключ из письма вида
TMBR-XXXX-XXXX-XXXX-XXXXв поле «Ключ из письма» и нажмите «Активировать». - Программа отправит на сервер лицензий ООО «Веб 3.0»
(
https://tembr.web3-0.ru/api/lic, Россия) ключ, отпечаток сервера (хэш системного идентификатора, а не сам идентификатор), имя компьютера и номер версии. В ответ придёт жетон лицензии, подписанный ключом ООО «Веб 3.0»; программа проверяет подпись сама и хранит жетон в~/Transcriber/лицензия.json. - Состояние сменится на «Активна»; на странице появятся тариф, число мест, владелец, дата окончания («Действует до») и имя компьютера с пометкой «серверная установка».
Записи, тексты расшифровок, имена говорящих, имена файлов и учётные записи на сервер лицензий не передаются.
Если сервер лицензий отказал, программа показывает его ответ на странице. Причины отказа: ключа нет, он не оплачен, срок истёк или свободных мест не осталось.
5а.2. Проверка
Раз в сутки, если есть связь, программа сама обновляет жетон — в фоне, без задержки страниц и расчёта. Кнопка «Проверить сейчас» делает это сразу. Без связи последний жетон действует 14 дней; после этого пользователи увидят «Лицензию не удавалось проверить больше 14 дней…», и достаточно восстановить связь — проверка пройдёт сама при следующей попытке расшифровки.
Программа отклоняет жетон, если часы сервера переведены назад больше чем на сутки: держите на сервере точное время.
5а.3. Отвязка и перенос на другой сервер
На странице «Лицензия» в блоке «Обслуживание» нажмите «Отвязать» и подтвердите. Место освободится на сервере лицензий, ключ можно активировать на другом компьютере; на этом новые расшифровки перестанут запускаться. Отвязывайте до переустановки или замены сервера: жетон привязан к отпечатку компьютера и на другой машине недействителен.
5а.4. Корпоративная поставка (тариф Enterprise, без интернета)
Для организаций, где у компьютеров нет интернета, ООО «Веб 3.0» по договору Enterprise выпускает корпоративную поставку — дистрибутив, собранный для этой организации. Устанавливается он так же, как обычный (раздел 4), но:
- ключ не нужен: активации, ежедневной проверки и отвязки нет, к серверу лицензий программа не обращается;
- на странице «Лицензия» написано «Корпоративная поставка для <название организации> по договору Enterprise: ключ и интернет не нужны»; то же название стоит на странице «О программе» рядом с номером версии;
- название берётся из файла
поставка.jsonв папке программы — файл не удаляйте и не правьте: без него программа станет обычной поставкой и попросит ключ; - число компьютеров и срок использования определяются договором; корпоративную поставку не передают за пределы организации.
Отдельный компьютер без интернета в обычной поставке. Если по договору лицензию нужно выдать такому компьютеру файлом: на странице «Лицензия» перепишите «Код устройства» и передайте его в ООО «Веб 3.0» (veb3.0@yandex.ru); полученный файл загрузите в поле «Файл лицензии». Состояние сменится на «Активна», в строке проверки — «офлайн-лицензия, связь с сервером не нужна». Файл действует только на том компьютере, для которого выпущен.
5а.5. Окончание срока и продление
По истечении срока новые расшифровки не запускаются; список, страницы записей, плеер и выгрузка остаются доступны. Продление оформляется на сайте https://tembr.web3-0.ru или по договору; ключ остаётся прежним, к сроку прибавляется год. После оплаты нажмите «Проверить сейчас» (для лицензии, полученной файлом, — загрузите новый файл). Корпоративная поставка продлевается по договору Enterprise.
6. Учётные записи и роли
6.1. Роли
| пользователь | администратор | |
|---|---|---|
| отправлять записи и получать расшифровки | да | да |
| видеть записи | только свои | все, с именем заказчика |
| очередь | своё место и число задач впереди, без имён | все задачи с именами |
| отменять задачи | свои | любые (чужие — с подтверждением) |
| ограничение по расписанию | действует | не действует |
| страница «Люди и расписание» | нет | да |
Чужая запись для обычного пользователя выглядит как несуществующая («Запись не найдена»). О том, что администратор видит все записи, пользователь предупреждён на странице входа.
6.2. Управление пользователями
Страница «Люди и расписание» (пункт меню виден только администратору).
- Блок «Кто может входить» — список пользователей с отметкой
«администратор» и кнопками:
- «Новый пароль» — задать пароль; все сеансы этого человека закрываются;
- «Удалить» — удалить учётную запись. Его расшифровки остаются на сервере и видны администратору. Последнего администратора удалить нельзя.
- Блок «Завести человека» — поля «Имя», «Пароль», флажок «Администратор», кнопка «Завести». Пароль показывается открыто, чтобы его можно было передать человеку; после заведения программа один раз повторяет его на экране.
Правила:
- пароль — не короче шести знаков;
- на серверной установке учётных записей можно завести не больше, чем мест в лицензии; при превышении программа ответит «По лицензии на этом сервере можно завести N учётных записей…» (раздел 5а);
- имена не различаются по регистру: «Иванов» и «иванов» — одно имя;
- самостоятельной регистрации и восстановления пароля по почте нет намеренно: пароль задаёт только администратор;
- сеанс живёт 14 дней.
Пароли хранятся в виде хэша PBKDF2-HMAC-SHA256 с индивидуальной солью и
240 000 итераций; файл users.json доступен только владельцу (права 600).
6.3. Забыт пароль администратора
-
Остановите службу:
systemctl --user stop transcriber. -
От имени пользователя службы выполните:
cd ~/tembr venv/bin/python transcriber_web.py --reset-admin <имя>Без имени используется «администратор». Если такого пользователя нет, он будет заведён.
-
Программа напечатает временный пароль. Запустите службу, войдите с ним и сразу задайте свой на странице «Люди и расписание».
Все прежние сеансы этого пользователя закрываются; событие записывается в
~/Transcriber/migration.log.
7. Расписание работы
Блок «Часы работы» на странице «Люди и расписание»:
- флажок «Ограничивать по часам»;
- дни недели Пн … Вс;
- поля «С» и «До»;
- кнопка «Сохранить».
По умолчанию ограничение включено: понедельник–пятница, с 09:00 до 22:00 по времени сервера.
Вне этих часов новые расшифровки не принимаются; пользователь видит сообщение вида «Сервис работает по будням с 09:00 до 22:00. Уже поставленные расшифровки досчитаются и ночью — приходите утром за результатом.» Задачи, уже стоящие в очереди и считающиеся, досчитываются. Администратор может ставить задачи в любое время. Праздничные дни не учитываются.
Блок «Ночная нагрузка» показывает сводку журнала нагрузки: сколько задач всего и вне рабочих часов, сколько часов шёл расчёт, какие форматы записей присылают, какую долю видео браузер разобрал сам, сколько места занимают копии звука для плеера.
8. Защищённое соединение (HTTPS) и сертификат
8.1. Зачем
Без сертификата сервис работает по http://, и:
- пароли пользователей идут по сети открытым текстом (об этом предупреждает страница входа);
- браузер не даёт извлекать звук из видео перед отправкой — видео передаётся целиком.
8.2. Где взять сертификат
Предпочтительно — сертификат на имя сервера от центра сертификации организации: тогда браузеры пользователей доверяют ему без предупреждений. Подходят любые файлы сертификата и ключа в формате PEM.
Временный вариант — самоподписанный сертификат:
cd ~/tembr
venv/bin/python сертификат.py [имя-или-адрес …]
Нужная скрипту библиотека cryptography есть в складе и ставится
установщиком; в закрытом контуре отдельно ставить её не нужно.
Без аргументов скрипт выписывает сертификат на имя и адреса этой машины;
срок действия — 825 дней. Файлы сертификат.crt и ключ.key скрипт
кладёт рядом с программой (в ~/tembr) и печатает полные пути к ним.
Самоподписанному сертификату браузер не доверяет и показывает предупреждение. Чтобы его не было, корневой сертификат нужно распространить на рабочие места средствами организации.
8.3. Запуск с сертификатом
Служба сама поднимает https, если рядом с программой лежат
сертификат.crt и ключ.key: положите файлы (или выпустите их
сертификат.py) и переустановите службу:
cd ~/tembr
bash служба.sh установить
Служба слушает https на порту 8443 (порт 443 пользовательской службе
недоступен — порты ниже 1024 на Linux открыты только root); адрес для
коллег — https://<имя сервера>:8443/. Файлы проверяются при каждой
установке службы, поэтому повторный запуск служба.sh установить или
установщика https не снимает.
Ручной запуск — с теми же ключами:
venv/bin/python transcriber_web.py --host 0.0.0.0 --port 8443 \
--cert /путь/к/сертификат.crt --key /путь/к/ключ.key \
--redirect-from 7870 --no-browser
--certи--keyнужны оба; если файла нет, программа скажет об этом и не запустится;--redirect-from 7870— на прежнем порту поднимается переадресация наhttps://, сохраняющая путь: старые ссылки пользователей продолжают работать.
Проверка: адрес https://<имя сервера>:8443/ открывается; на странице входа
вместо предупреждения о пароле написано «Соединение защищено
сертификатом…»; при отправке видео появляется строка «Готовлю запись к
отправке…».
9. Служба и автозапуск
Установщик ставит пользовательскую службу systemd transcriber.service
(файл ~/.config/systemd/user/transcriber.service) и включает её в
автозапуск. Служба:
- запускает
venv/bin/python transcriber_web.py --host 0.0.0.0 --no-browserиз папки программы, то есть слушает все сетевые интерфейсы на порту 7870; - работает в серверном режиме (
TRANSCRIBER_SERVER=1): записи приходят по сети, окна выбора файла нет; - при наличии всех весов в дистрибутиве работает без обращений в
интернет (
TRANSCRIBER_OFFLINE=1); - перезапускается при сбое — не более пяти попыток за минуту, затем останавливается;
- на остановку даёт две минуты, чтобы корректно завершить текущий расчёт.
Управление:
| действие | команда |
|---|---|
| запустить | systemctl --user start transcriber |
| остановить | systemctl --user stop transcriber |
| перезапустить | systemctl --user restart transcriber |
| состояние | systemctl --user status transcriber или bash служба.sh состояние |
| журнал | journalctl --user -u transcriber -n 100 или bash служба.sh журнал |
| поставить заново | bash служба.sh установить |
| снять | bash служба.sh удалить |
Если loginctl enable-linger не включён, установщик напомнит об этом:
без него служба работает, только пока пользователь вошёл в систему.
Если systemd на машине нет, программу запускают вручную:
cd ~/tembr
TRANSCRIBER_SERVER=1 venv/bin/python transcriber_web.py --host 0.0.0.0 --no-browser
Перезапуск и задачи. Очередь хранится в памяти и перезапуск не переживает: стоявшие в очереди задачи нужно отправить заново. Если в момент остановки шла разметка говорящих, а текст уже был распознан, запись сохранится с пометкой «прервана — только текст».
10. Параметры запуска и переменные окружения
10.1. Ключи командной строки transcriber_web.py
| ключ | значение |
|---|---|
--version | показать версию и правообладателя |
--port ПОРТ | порт; по умолчанию 7870 (или значение TRANSCRIBER_PORT) |
--host АДРЕС | адрес прослушивания; по умолчанию 127.0.0.1 (только этот компьютер), 0.0.0.0 — открыть для сети |
--no-browser | не открывать браузер при запуске |
--cert ФАЙЛ | сертификат (PEM), включает HTTPS |
--key ФАЙЛ | закрытый ключ сертификата |
--redirect-from ПОРТ | переадресация с этого порта по http на https (работает только вместе с --cert) |
--reset-admin [ИМЯ] | выдать администратору временный пароль; выполнять при остановленной службе |
10.2. Переменные окружения
| переменная | назначение |
|---|---|
TRANSCRIBER_SERVER | серверный режим: приём записей по сети, без системного окна выбора файла (служба ставит 1) |
TRANSCRIBER_PORT | порт по умолчанию вместо 7870 |
TRANSCRIBER_OFFLINE | 1 — не обращаться в интернет за моделями; 0 — разрешить, даже если веса привезены (нужно, чтобы скачать модель, которой нет в поставке) |
TRANSCRIBER_MODELS | путь к папке с весами моделей, если она лежит не рядом с программой |
TRANSCRIBER_MAX_UPLOAD | предел размера присылаемого файла в байтах; по умолчанию 5 ГБ (5368709120) |
TRANSCRIBER_ENGINE | принудительный выбор движка распознавания (faster); по умолчанию выбирается сам |
TRANSCRIBER_DIAR_DEVICE | устройство для разметки говорящих: cpu или cuda; по умолчанию выбирается само |
TRANSCRIBER_NO_BROWSER | то же, что --no-browser |
TRANSCRIBER_BRAND | служебная, задаётся службой (тембр); менять не требуется |
Переменные службы задаются строками Environment=… в файле службы; после
правки — systemctl --user daemon-reload и перезапуск.
10.3. Предел размера и место на диске
Перед приёмом файла программа проверяет свободное место: после приёма на диске должно остаться не менее 2 ГБ. Иначе файл не принимается, а пользователь видит сообщение о нехватке места. Принятая запись удаляется сразу после расчёта (успешного, отменённого или с ошибкой).
11. Где хранятся данные
Все данные — в домашней папке пользователя службы, в ~/Transcriber/.
Папка программы (~/tembr) пользовательских данных не содержит.
| путь | что это |
|---|---|
history/ | расшифровки, по файлу JSON на запись |
audio/ | копии звука для плеера (.m4a, 64 кбит/с); удаляются вместе с записью |
incoming/ | записи, принимаемые по сети; удаляются после расчёта |
uploads/ | временные файлы для скачивания |
users.json | пользователи и хэши паролей (права 600) |
sessions.json | действующие сеансы (права 600) |
расписание.json | настройки расписания |
нагрузка.jsonl | журнал нагрузки: приём файлов, начало и конец задач |
словарь.json | словарь замен (см. 11.1) |
лицензия.json | жетон лицензии и дата последней проверки (права 600) — раздел 5а |
migration.log | журнал служебных событий, в том числе --reset-admin |
.hf_token | токен доступа к хранилищу моделей — нужен, только если весов моделей нет в дистрибутиве |
history-backup-* | копия истории, которую программа делает перед обновлением формата записей |
11.1. Словарь замен
Файл ~/Transcriber/словарь.json исправляет в готовом тексте термины,
которые модель устойчиво искажает. Формат — список правил:
[
{"было": "изи", "стало": "ИЗЗЗИ", "почему": "название организации"}
]
Замены выполняются по целым словам, без учёта регистра, длинные правила раньше коротких. Все сделанные замены записываются в саму расшифровку и показываются пользователю на странице записи («Замены по словарю»). Повреждённый файл словаря игнорируется и не мешает расчёту. Правка в интерфейсе не предусмотрена; изменения действуют для новых расшифровок.
Заносите в словарь только устойчивые ошибки — один и тот же неверный вариант, повторяющийся в разных записях. Разовые описки заносить не нужно: неверная замена хуже отсутствия замены.
12. Обновление
-
Дождитесь окончания текущих расшифровок (или предупредите пользователей: стоящие в очереди задачи при перезапуске пропадут).
-
Сделайте резервную копию (раздел 13).
-
Остановите службу:
systemctl --user stop transcriber. -
Распакуйте новый архив поверх прежней установки:
unzip -o tembr-<новая версия>-linux.zip -d ~ -
Запустите установщик:
cd ~/tembr && bash УСТАНОВИТЬ.sh. Существующее окружениеvenvне пересоздаётся; установщик доставит новые зависимости и заново поставит службу. Повторный запуск обязателен. Если в новом архиве есть склад, установщик и при обновлении в сеть не обращается. -
Запустите службу и проверьте версию:
systemctl --user start transcriber venv/bin/python transcriber_web.py --version
Расшифровки, учётные записи, настройки и лицензия лежат в ~/Transcriber
и при обновлении не затрагиваются; повторная активация не нужна. При изменении формата записей программа
переводит историю на новый формат сама, предварительно сохранив копию в
~/Transcriber/history-backup-<дата>.
Если служба запускалась с HTTPS, проверьте после шага 5, что ключи
--cert, --key остались в файле службы (раздел 8.3).
13. Резервное копирование и восстановление
Что копировать: папку ~/Transcriber целиком. Папку программы
копировать не нужно — она восстанавливается из дистрибутива.
Как: при остановленной службе или когда расчёт не идёт:
systemctl --user stop transcriber
tar -czf transcriber-backup-$(date +%Y%m%d).tar.gz -C ~ Transcriber
systemctl --user start transcriber
Папки incoming/ и uploads/ содержат только временные файлы, их можно
исключить (--exclude=Transcriber/incoming --exclude=Transcriber/uploads).
Восстановление: остановить службу, распаковать архив в домашнюю папку
пользователя службы (tar -xzf … -C ~), запустить службу. При
восстановлении на другой машине лицензия из копии не действует (она
привязана к компьютеру): отвяжите прежний сервер, если он доступен, и
активируйте ключ заново (раздел 5а).
Резервная копия содержит записи совещаний и хэши паролей: храните её с той же степенью защиты, что и сам сервер.
14. Журналы и диагностика
| источник | что там |
|---|---|
journalctl --user -u transcriber | вывод программы: адрес запуска, код первого запуска, помеченные прерванные расшифровки, на чём идёт распознавание и разметка (видеокарта или процессор), свободная видеопамять после каждой задачи, ошибки |
~/Transcriber/нагрузка.jsonl | по строке на событие: приём файла (формат, размер), начало задачи (длительность записи, вне рабочих часов или нет), конец задачи (время расчёта) |
~/Transcriber/migration.log | обновление формата истории, сброс пароля администратора |
| страница «Люди и расписание», блок «Ночная нагрузка» | сводка по журналу нагрузки |
| страница «О программе» | версия, откуда берутся веса моделей |
Команды для проверки:
cd ~/tembr
venv/bin/python transcriber_web.py --version
venv/bin/python -c "import transcriber_core as c; print(c.где_модели())"
venv/bin/python проверка-видеокарты.py
nvidia-smi -l 5 # загрузка видеокарты во время расчёта
Признак правильной работы на видеокарте: во время определения говорящих
загрузка видеокарты (GPU-Util) высокая, а число «видеопамяти свободно» в
журнале после задач возвращается к одному и тому же значению.
15. Удаление
-
Если лицензия будет использоваться на другом компьютере — сначала отвяжите этот на странице «Лицензия» (раздел 5а.3).
-
Снять службу:
cd ~/tembr bash служба.sh удалить -
Удалить папку программы:
rm -r ~/tembr. -
Данные (
~/Transcriber) — расшифровки, звук, учётные записи — сохраняются. Удаляйте их, только если они больше не нужны и сделана резервная копия:rm -r ~/Transcriber. Это действие необратимо. -
При необходимости отключить автозапуск для пользователя (root):
sudo loginctl disable-linger <пользователь службы>.
16. Типичные неполадки
| что видно | что делать |
|---|---|
| Установщик: «Рядом нет файла …» | Архив распакован не целиком. Распакуйте заново |
| Установщик: «Собрать не вышло: не хватает заголовков FFmpeg или компилятора» | Установка из сети без склада. Поставьте пакеты из 4.1, п. 4, и запустите установщик снова — или используйте архив со складом |
| Установщик: «Не удалось скачать установщик Python» | Нет доступа в интернет при установке без склада. Используйте архив со складом или поставьте python3.12 из репозитория ОС |
| Установщик: «весов моделей рядом нет» | Архив распакован не целиком: должна быть папка models/ с подпапкой hub/ |
| Установщик: «Чтобы служба поднималась после перезагрузки…» | Выполните sudo loginctl enable-linger <пользователь> |
| «systemd не найден — служба не ставится» | Запускайте вручную (раздел 9) |
| Страница не открывается с другого компьютера | Проверьте на самом сервере curl http://127.0.0.1:7870/login. Если отвечает — дело в межсетевом экране или в адресе прослушивания (--host 0.0.0.0) |
| Наружу открывается только страница входа «Первый запуск» | Не заведён администратор. Раздел 5 |
| Не найти код первого запуска | journalctl --user -u transcriber -n 50; после перезапуска службы код новый |
| Забыт пароль администратора | Раздел 6.3 |
| Пользователь видит «Сервис работает … досчитаются и ночью» | Нерабочее время по расписанию. Раздел 7 |
| «Файл больше … — столько мы не принимаем.» | Предел TRANSCRIBER_MAX_UPLOAD (раздел 10.2). Сначала проверьте свободное место |
| Файл не принимается из-за места на диске | После приёма должно оставаться 2 ГБ. Освободите место |
| Расчёт идёт очень медленно | Считает процессор. проверка-видеокарты.py; при наличии NVIDIA — поставить PyTorch с CUDA (4.3) |
В журнале CUDA out of memory | Не хватило видеопамяти. Временно — TRANSCRIBER_DIAR_DEVICE=cpu; сообщите в поддержку |
| На экране «Модель распознавания не найдена, а выход в интернет закрыт» | Нет весов в models/. Распакуйте дистрибутив целиком или задайте TRANSCRIBER_MODELS |
| Разметка говорящих требует скачать модель (около 30 МБ) | В дистрибутиве нет модели разметки. Нужен разовый доступ в интернет либо полный архив весов |
| Видео грузятся долго, у пользователя объяснение про «защищённый адрес» | Включите HTTPS. Раздел 8 |
| «Нужны оба файла: —cert и —key» / «Не нашёлся сертификат: …» | Проверьте пути к файлам сертификата и ключа |
| «Программа не активирована. Введите ключ лицензии на странице «Лицензия».» | Активируйте ключ (раздел 5а.1) |
| «Нет связи с сервером лицензий. Проверьте интернет и попробуйте ещё раз.» | Нет исходящего доступа по HTTPS к tembr.web3-0.ru. Проверьте межсетевой экран; для компьютеров без интернета — корпоративная поставка или файл лицензии (5а.4) |
| «Срок лицензии закончился…» | Продлите лицензию (5а.5) |
| «Лицензию не удавалось проверить больше 14 дней…» | Восстановите связь сервера с tembr.web3-0.ru |
| «Лицензия выдана для другого компьютера…» | Данные перенесены с другой машины. Активируйте ключ заново; при нехватке мест — отвяжите прежний компьютер (5а.3) или напишите в поддержку |
| «Часы компьютера переведены назад…» | Исправьте время на сервере, затем «Проверить сейчас» |
| «По лицензии на этом сервере можно завести N учётных записей…» | Мест в лицензии меньше, чем нужно учётных записей. Докупите места или удалите ненужную учётную запись |
Служба в состоянии failed после нескольких перезапусков | journalctl --user -u transcriber -n 100 — причина в последних строках. После устранения: systemctl --user reset-failed transcriber и запуск |
17. Проверочный экземпляр для экспертов
Экспертам передаётся дистрибутив версии 1.0.0 для Linux; стенд с выданной учётной записью не используется.
| Дистрибутив | папка на СберДиске: https://files.sberdisk.ru/s/orkQXbBfypX94In — архив tembr-1.0.0-linux.zip (3,4 ГБ, со складом и весами моделей, SHA-256 cb39860d93fb97e01078cb60d5990c0902f8bf41910f898e0e244d9c9d4a8ffb), тестовая запись и краткая инструкция ПРОЧТИ-МЕНЯ.txt |
| Установка | разделы 4.1–4.2 |
| Режим | локальный запуск: venv/bin/python transcriber_web.py, открыть http://127.0.0.1:7870; учётная запись не нужна |
| Серверный режим | эксперт сам заводит администратора на странице первого запуска (раздел 5) |
| ОС проверки | РЕД ОС 7.3.6 и Astra Linux SE 1.8.2 «Орёл» (13.10.2026, раздел 2.1) |
| Режим расчёта | процессор, 8 ГБ оперативной памяти |
| Лицензия | ключ для экспертов (3 места, на год): передаётся в заявлении (в документации не публикуется) |
Тестовая запись — файл совещание-тест.wav (45 с, синтезированная речь, два голоса)
рядом с архивом; эксперт может использовать и свои записи. Записи
заказчиков в проверочный экземпляр не передаются.
Что можно проверить в серверном режиме под администратором, помимо функций пользователя (Руководство пользователя, раздел 12):
- Страница «Люди и расписание»: завести пользователя, задать ему новый пароль, удалить.
- Войти под обычным пользователем в другом браузере и убедиться, что чужие записи не видны.
- Изменить часы работы и проверить отказ обычному пользователю вне расписания.
- Страница «О программе»: версия 1.0.0, правообладатель, авторы и лицензии моделей.
- Страница «Лицензия»: состояние «Активна», срок, число мест; для онлайн-лицензии — «Проверить сейчас».
Снимки экранов стендов — в протоколе проверки: 40-протоколы/redos-7.3/
и 40-протоколы/astra-1.8.2/ (служба после первого запуска, список
расшифровок, страница записи, «О программе»).
18. Дополнительные платформы: Windows и macOS
Программа одна для всех платформ; различаются только установщики.
Windows 10/11 x64. Дистрибутив — tembr-1.0.0-windows-x64.zip (папка
tembr/ внутри) с мастером установки «Тембр» (Inno Setup): по умолчанию программа
ставится в папку пользователя (%LOCALAPPDATA%\Тембр), создаёт ярлыки в
меню «Пуск» и, по выбору, на рабочем столе, удаляется штатно через пункт
«Удалить Тембр». Для серверного режима программа запускается так же, как
на Linux:
set TRANSCRIBER_SERVER=1
venv\Scripts\python transcriber_web.py --host 0.0.0.0 --port 7870 --no-browser
Ключи командной строки, переменные окружения, папка данных
(C:\Users\<пользователь>\Transcriber) и порядок первого запуска те же,
что описаны выше. Служба Windows не поставляется: после перезагрузки сервис
запускается вручную.
macOS 13+ на процессорах Apple (M1 и новее). Дистрибутив —
tembr-1.0.0-macos-arm64 — образ .dmg с приложением «Тембр». Приложение содержит всё
необходимое, включая веса моделей; расчёт идёт без интернета, а для
лицензии нужна активация ключа и связь раз в 14 дней (раздел 5а). Оно
открывается в собственном окне и предназначено для работы одного
пользователя на своём компьютере (запись выбирается кнопкой «Выбрать
файл», учётные записи не требуются). Данные хранятся в
~/Transcriber.
19. Обращение в поддержку
veb3.0@yandex.ru, по будням с 10:00 до 19:00 по московскому времени. Сайт: https://tembr.web3-0.ru.
В обращении укажите:
- вывод
venv/bin/python transcriber_web.py --version; - операционную систему и её версию (
cat /etc/os-release); - вывод
venv/bin/python проверка-видеокарты.py— если вопрос о скорости; - состояние и ключ со страницы «Лицензия» — если вопрос о лицензии;
- последние строки журнала:
journalctl --user -u transcriber -n 200.
Записи совещаний к обращению не прикладывайте.