Установка TrueConf Server на ОС Debian Linux за 15 минут

Наша компания предлагает вам воспользоваться преимуществами корпоративной видеосвязи на различных ОС семейства Linux, в т.ч. Debian. Поддерживаются только 64-битные версии ОС.

Если вы обновляете TrueConf Server, который уже ранее был установлен, то воспользуйтесь данной статьёй.

Обязательные предварительные действия

• Так как TrueConf Server содержит свой веб-сервер, используйте вариант установки ОС Linux без предустановленного веб-сервера для предотвращения возможных конфликтов.
• Создайте в ОС пользователя, под которым будет производиться установка и который будет иметь доступ к панели управления сервером. Можно использовать учётную запись, созданную при установке ОС.

  Для успешной установки в ОС не должно быть пользователя с логином или именем trueconf.

• Внимательно заполните все поля в анкете.
• Нажмите на кнопку Скачать, чтобы перейти на страницу выбора ОС и получить регистрационный ключ на указанный адрес электронной почты.

Ключ должен прийти в течение 15 минут. Если он не появился, проверьте папку “Спам” вашего почтового ящика. Если письма с ключом нет — свяжитесь с нами в онлайн-чате или другим удобным способом.

Шаг 1. Установка TrueConf Server на ОС Debian

Выберите вариант установки

Возможны два варианта установки:

• вручную из скачанного файла;
• с помощью добавления в систему репозитория TrueConf.

Установка на Debian из файла вручную

Скачайте deb-пакет для вашей ОС:

Скачать релизный пакет для Debian 12

Скачать релизный пакет для Debian 11

Перейдите в каталог со скачанным deb-пакетом и запустите его установку командой:

где trueconf-server-name.deb – название установочного пакета.

В процессе установки появится поле для ввода имён пользователей ОС, которые будут иметь административный доступ к панели управления сервером. Укажите имя созданного ранее пользователя.

После завершения процесса установки перейдите к шагу 2.

Установка на Debian из репозитория

• Выполните следующую команду, чтобы создать файл /etc/apt/sources.list.d/trueconf.list сразу с нужным содержимым внутри:
  echo "deb [arch=$(dpkg --print-architecture)] https://mirror.trueconf.ru/debian $(lsb_release -cs) non-free" | sudo tee /etc/apt/sources.list.d/trueconf.list > /dev/null

  1	echo "deb [arch=$(dpkg --print-architecture)] https://mirror.trueconf.ru/debian $(lsb_release -cs) non-free" | sudo tee /etc/apt/sources.list.d/trueconf.list > /dev/null

• С помощью учетной записи администратора последовательно выполните команды:
  wget -O- https://mirror.trueconf.ru/deb.trueconf.pub | sudo gpg --no-default-keyring --keyring gnupg-ring:/etc/apt/trusted.gpg.d/trueconf.gpg --import sudo chmod 644 /etc/apt/trusted.gpg.d/trueconf.gpg sudo apt -y update sudo apt -y install trueconf-server

  1 2 3 4

  wget -O- https://mirror.trueconf.ru/deb.trueconf.pub | sudo gpg --no-default-keyring --keyring gnupg-ring:/etc/apt/trusted.gpg.d/trueconf.gpg --import sudo chmod 644 /etc/apt/trusted.gpg.d/trueconf.gpg sudo apt -y update sudo apt -y install trueconf-server

В случае ошибки с gnupg вам понадобится установить этот пакет вручную.

После завершения процесса установки перейдите к шагу 2.

Шаг 2. Добавление пользователя для доступа к панели управления

Пользователь ОС для доступа к панели управления (веб-админке) указывается в процессе установки пакета из файла или репозитория. При появлении окна ввода просто укажите имя созданного ранее пользователя.

Если вы устанавливаете TrueConf Server на машину, которая заведена в домен, и там уже есть группа пользователей tcadmins то окно ввода логинов для доступа в панель управления не появится. Но вам надо будет убедиться, что в доменной группе tcadmins имеются нужные вам пользователи, чтобы вы смогли зайти в настройки сервера.

Отдельно мы показали как добавить администраторов после процесса установки.

Шаг 3. Проверка установки

В ОС добавится несколько служб (в терминологии Linux демонов) TrueConf. При этом две из них — веб-сервер trueconf-web и менеджер работы с БД и файлами настроек trueconf-manager — должны запуститься автоматически после установки. Проверьте их статус командами:

При необходимости запустить вручную их можно командами:

Основная служба сервера trueconf не может быть запущена, пока вы его не зарегистрируете. Для этого перейдите к шагу 4 и настройте вход в панель управления.

Шаг 4. Вход в панель управления

Если вы находитесь в локальной (корпоративной) сети:

• узнайте IP-адрес компьютера с ОС Linux командой ip a
• с другого компьютера в пределах вашей сети зайдите на страницу установленного сервера по найденному IP и перейдите к регистрации. Если страница не доступна, то попробуйте сменить порт доступа.

Если вы устанавливаете TrueConf Server на удалённый компьютер вне локальной сети, например, на облачную виртуальную машину (ВМ), то для получения доступа к панели управления сначала надо отредактировать файл настроек. Это связано с тем, что в целях безопасности панель управления сервером доступна только из локальной сети. Чтобы получить доступ извне со своего компьютера, вам нужно:

• узнать внешний IP-адрес своего ПК с помощью какого-то сервиса, например, откройте в браузере ссылку: https://whoer.net/
• под учётной записью администратора открыть в любом имеющемся текстовом редакторе (например, nano) файл /opt/trueconf/server/etc/webmanager/opt/local_only_admin_24.conf
• добавить строку Require ip x.x.x.x/32, где x.x.x.x — ваш внешний IP адрес. В итоге файл должен принять вид:
  <Location /admin> Require local Require ip 10.0.0.0/8 Require ip 192.168.0.0/16 Require ip 172.16.0.0/12 Require ip x.x.x.x/32 <Location>

  1 2 3 4 5 6 7 8 9 10 11 12 13

  <Location /admin> Require local      Require ip 10.0.0.0/8      Require ip 192.168.0.0/16    Require ip 172.16.0.0/12      Require ip x.x.x.x/32      <Location>

• перезагрузить веб-службу TrueConf Server с помощью команды:
  sudo systemctl restart trueconf-web

  1	sudo systemctl restart trueconf-web

Если всё равно панель управления не открывается, возможно, занят порт для доступа к ней. Тогда надо попробовать его сменить как сказано в блоке решения проблем.

Если получилось войти в панель управления, то перейдите к шагу 5.

Шаг 5. Регистрация сервера

• Так как сервер ещё не зарегистрирован, то при переходе по IP (см. шаг 4) сразу откроется страница авторизации с правами администратора. Войдите под учётными данными созданного ранее пользователя:
• На открывшейся странице введите в соответствующее поле полученный на почту регистрационный ключ и зарегистрируйте сервер.

В случае обновления TrueConf Server на новую мажорную версию (меняются первые две цифры, например, с 4.5 на 4.7 или с 4.7 на 5.0) вам понадобится перерегистрация сервера. Для этого свяжитесь с нами любым удобным способом и укажите ID вашего сервера, чтобы мы сбросили привязку. После чего вы сможете опять зарегистрировать его своим ключом.

Шаг 6. Запуск сервера

После регистрации сервер автоматически перезапустится. Вы увидите в строке Статус сервера соответствующую надпись.

Узнать статус сервера также можно непосредственно в ОС Linux командой:

Добавление пользователей и создание конференций

После успешной установки используйте документацию TrueConf Server для дальнейших шагов:

• добавление или импорт по LDAP учётных записей для пользователей;
• создание конференций.

🆘 Решение типовых проблем

Ошибка с gnupg при установке из репозитория на Debian

Если при установке из репозитория на Debian в терминале появится ошибка вида:

это значит что в ОС нет предустановленной криптографической утилиты gnupg.

В этом случае установите недостающий пакет с помощью команды:

Ошибка после ввода логина администратора при установке

Если при вводе логина администратора на ОС Debian вы случайно ошиблись и указали несуществующий логин, то установка может завершиться с ошибкой:

В этом случае вам требуется от имени суперпользователя выполнить команду

Так вы очистите сохранённые в ОС данные о настройках пакета, подробнее смотрите в официальной документации.

После чего запустите процесс установки заново с первого шага.

Как в Debian добавить пользователей для доступа в панель управления после установки

• Выполните команду:
  sudo adduser [user_login]

  1	sudo adduser [user_login]

  где [user_login] – логин добавляемого пользователя.

• После появления строки для ввода пароля укажите и подтвердите его.
• При желании укажите для пользователя дополнительные данные (полное имя, телефон и пр.).

Смена порта доступа к панели управления

По умолчанию панель управления сервером доступна по стандартному HTTP порту 80 и его указывать не обязательно. Но если не получается зайти просто по IP, это значит что порт 80 был занят на момент установки и надо сменить порт на другой (например, 8080 или 8888).

• Перейдите в каталог /opt/trueconf/server/etc/webmanager/ с правами суперпользователя.
• Откройте файл httpd.conf с помощью любого текстового редактора.
• Измените номер порта в параметре Listen <номер порта> (например, Listen 8888), после чего сохраните внесённые изменения.
• Откройте файл /opt/trueconf/server/etc/manager/manager.toml с помощью любого текстового редактора и укажите этот же порт в параметре connection:
  [web] connection = "http://127.0.0.1:8888"

  1 2	[web] connection = "http://127.0.0.1:8888"

• Перезагрузите службы trueconf-manager и trueconf-web, используя команды:
  sudo systemctl restart trueconf-manager sudo systemctl restart trueconf-web

  1 2	sudo systemctl restart trueconf-manager sudo systemctl restart trueconf-web

После смены порта и перезапуска веб-службы попробуйте снова войти в панель управления.

Ещё больше интересного

В нашей базе знаний вы найдёте множество интересных статей об использовании программных решений TrueConf.

Мы готовы ответить на любые ваши вопросы по телефону +7 (495) 698-60-66 или почте sales@trueconf.ru.