Обзор развертывания Owncast на сервере¶
Предварительные требования¶
Для корректной работы приложения требуются следующие условия:
-
Операционная система: Ubuntu.
-
Права доступа: права суперпользователя (root).
-
Установленные пакеты:
unzip,ffmpeg. -
Доступ к сети для загрузки компонентов и получения SSL-сертификатов.
FQDN итоговой панели на домене hostkey.in¶
| Параметр | Значение |
|---|---|
| Префикс | owncast |
| Домен | hostkey.in |
| Полный шаблон | owncast{Server_ID_from_Invapi}.hostkey.in |
Структура файлов и каталогов¶
В системе используются следующие пути для хранения данных и конфигураций:
-
/root/nginx— рабочая директория для управления контейнером прокси-сервера. -
/data/nginx/user_conf.d— каталог с конфигурационными файлами Nginx. -
/etc/systemd/system/owncast.service— файл службы системного менеджера. -
/root/owncast— рабочая директория приложения Owncast.
Процесс установки приложения¶
Процесс развертывания включает в себя несколько этапов:
-
Подготовка системы: обновление кэша пакетов
apt, установка утилитыunzipи мультимедийного фреймворкаffmpeg. -
Установка основного компонента: выполнение установочного скрипта через команду:
curl -s https://owncast.online/install.sh | bash -
Настройка системной службы: создание файла конфигурации для автоматического запуска приложения в фоновом режиме с использованием
systemd. -
Развертывание прокси-сервера: настройка и запуск контейнера Nginx для обеспечения доступа к приложению через защищенное соединение.
Права доступа и безопасность¶
-
Приложение Owncast работает от имени пользователя
root. -
Конфигурационные файлы Nginx имеют права доступа
0644. -
Директория
/root/nginxимеет права доступа0755. -
Для обеспечения безопасности используется контейнерный прокси-сервер, который перенаправляет трафик на локальный порт приложения.
Контейнеры Docker и их запуск¶
Для работы веб-интерфейса и получения SSL-сертификатов используется следующий контейнер:
| Параметр | Значение |
|---|---|
| Имя образа | jonasal/nginx-certbot:latest |
| Режим сети | host |
| Политика перезапуска | unless-stopped |
| Тома (volumes) | nginx_secrets:/etc/letsencrypt, /data/nginx/user_conf.d:/etc/nginx/user_conf.d |
| Переменные окружения | CERTBOT_EMAIL=hkadm@hostkey.com |
Кастомные скрипты и дополнительные настройки¶
В процессе установки выполняются следующие действия:
-
Загрузка и выполнение внешнего установочного скрипта Owncast для автоматической сборки и подготовки бинарного файла.
-
Настройка конфигурации Nginx: в файлы конфигурации домена автоматически добавляется директива
proxy_pass http://127.0.0.1:8080;для перенаправления входящего трафика на внутренний порт приложения.
Инструкция по обновлению приложения¶
Для обновления основного приложения необходимо выполнить перезапуск системной службы: systemctl restart owncast
Если обновление требует обновления бинарных файлов, рекомендуется повторно запустить установочный скрипт: curl -s https://owncast.online/install.sh | bash
Расположение конфигурационных файлов и данных¶
-
Исполняемый файл приложения:
/root/owncast/owncast. -
Конфигурация проксирования:
/data/nginx/user_conf.d/owncast{Server_ID_from_Invapi}.hostkey.in.conf. -
Файл окружения Docker:
/data/nginx/nginx-certbot.env.
Доступные порты для подключения¶
| Порт | Назначение | Протокол |
|---|---|---|
| 443 | Внешний доступ к приложению (HTTPS) | TCP |
| 8080 | Внутренний порт приложения | TCP |
Запуск, остановка приложения¶
Управление сервисом Owncast осуществляется через systemctl:
-
Запуск:
systemctl start owncast -
Остановка:
systemctl stop owncast -
Проверка статуса:
systemctl status owncast -
Включение автозагрузки:
systemctl enable owncast