В этом руководстве описана установка сервера Bedrud (API, веб-интерфейс, медиасервер WebRTC) на Linux-сервер. О настольных и мобильных клиентах см. Установка клиентов.

Предварительные требования

Нет домена? Bedrud работает с IP-адресом, используя самоподписанный TLS. Браузер покажет предупреждение о сертификате, но видео и аудио будут работать. Для доверенных сертификатов во внутренних сетях см. Руководство по внутреннему TLS.

1. Установка одной командой (Рекомендуется)

Скачивает и устанавливает бинарный файл Bedrud CLI в ваш PATH. Работает на Linux, macOS и Windows.

curl -fsSL https://get.bedrud.org | bash

source ~/.bashrc  # или ~/.zshrc

irm https://get.bedrud.org/install.ps1 | iex

Проверьте:

bedrud --version

2. Установка через пакетный менеджер

Установите через пакетный менеджер вашего дистрибутива.

curl -fsSL https://bedrud-ir.github.io/bedrud/bedrud.gpg.key \
  | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/bedrud.gpg
 
echo "deb https://bedrud-ir.github.io/bedrud stable main" \
  | sudo tee /etc/apt/sources.list.d/bedrud.list
 
sudo apt update && sudo apt install bedrud

sudo bedrud install

yay -S bedrud-bin
sudo bedrud install

sudo curl -fsSL https://bedrud-ir.github.io/bedrud/dnf/bedrud.gpg.key \
  -o /etc/pki/rpm-gpg/RPM-GPG-KEY-bedrud
 
sudo curl -fsSL https://bedrud-ir.github.io/bedrud/dnf/bedrud.repo \
  -o /etc/yum.repos.d/bedrud.repo
 
sudo dnf install bedrud
sudo bedrud install

3. Docker

Запустите Bedrud в контейнере - не требуется настройка Linux-сервера, systemd или загрузка бинарного файла.

Готовый образ (быстро)

docker pull ghcr.io/bedrud-ir/bedrud:latest
 
docker run -d --name bedrud \
  -p 8090:8090 \
  -p 7880:7880 \
  -p 50000-60000:50000-60000/udp \
  -v bedrud-data:/var/lib/bedrud \
  ghcr.io/bedrud-ir/bedrud:latest

Docker Compose

services:
  bedrud:
    image: ghcr.io/bedrud-ir/bedrud:latest
    ports:
      - "8090:8090"
      - "7880:7880"
      - "50000-60000:50000-60000/udp"
    volumes:
      - bedrud-data:/var/lib/bedrud
    restart: unless-stopped
 
volumes:
  bedrud-data:

Порты

Конфигурация

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

docker run -d --name bedrud \
  -p 8090:8090 \
  -p 7880:7880 \
  -e JWT_SECRET=change-this-to-a-random-string \
  -e LIVEKIT_API_KEY=prodkey \
  -e LIVEKIT_API_SECRET=prodsecret \
  -v bedrud-data:/var/lib/bedrud \
  ghcr.io/bedrud-ir/bedrud:latest

Полная документация по Docker, включая тома, обратный прокси и настройку TLS: Руководство по Docker.

4. Интерактивная установка

Если бинарный файл bedrud уже есть на сервере:

sudo ./bedrud install

Установщик автоматически определяет IP сервера и запрашивает:

Все запросы пропускаются при передаче данных через канал (неинтерактивный режим) - используются флаги и значения по умолчанию.

5. Неинтерактивная установка (через флаги)

Пропустите все запросы, передавая флаги.

Let’s Encrypt (требуется домен)

Требуется: DNS A-запись для вашего домена уже указывает на IP этого сервера.

sudo ./bedrud install --tls --domain meet.example.com --email webmaster@example.com

Самоподписанный TLS (по IP)

Требуется: Ничего дополнительного. Работает сразу.

sudo ./bedrud install --tls --ip 1.2.3.4

Обычный HTTP (только для разработки / внутренние сети)

Требуется: localhost или 127.0.0.1. Браузеры блокируют камеру/микрофон по не-HTTPS, кроме localhost.

sudo ./bedrud install --ip 1.2.3.4

Самоподписанный для домена (тестирование до настройки DNS)

Требуется: Имя домена (DNS пока не обязан разрешаться).

sudo ./bedrud install --tls --domain meet.example.com

Пользовательский порт

Требуется: Порт не занят другими службами.

sudo ./bedrud install --tls --port 8443 --domain meet.example.com

Внешние сертификаты

Требуется: Файлы fullchain и закрытого ключа в формате PEM.

sudo ./bedrud install --tls --cert /path/to/fullchain.pem --key /path/to/privkey.pem

Пользовательские порты LiveKit

Требуется: Все три порта открыты на файрволе.

sudo ./bedrud install --lk-port 9000 --lk-tcp-port 9001 --lk-udp-port 9002

За обратным прокси

Требуется: Обратный прокси (Nginx, Caddy, Traefik, Cloudflare), завершающий TLS перед Bedrud.

sudo ./bedrud install --behind-proxy --domain meet.example.com

Устанавливает behindProxy: true в конфигурации и настраивает доверенные заголовки прокси.

Внешний сервер LiveKit

Требуется: Отдельный сервер LiveKit уже запущен и доступен с этой машины.

sudo ./bedrud install --external-livekit https://livekit.example.com

Пропускает установку встроенного LiveKit. API-ключ и секрет должны совпадать в обеих конфигурациях.

Отдельный домен для LiveKit

Требуется: Домен, который разрешается напрямую на этот сервер, минуя любой CDN.

sudo ./bedrud install --livekit-domain lk.example.com --domain meet.example.com

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

Справка по всем флагам

6. Полностью автоматическая установка (Python CLI)

Соберите, загрузите и настройте сервер с вашего локального компьютера.

Требуется: Python 3.12+, uv (менеджер пакетов Python), SSH-ключ для доступа к целевому серверу, Go 1.24+ и Bun установлены локально.

cd tools/cli
uv run python bedrud.py --auto-config \
  --ip <your-server-ip> \
  --user root \
  --auth-key ~/.ssh/id_rsa \
  --domain meet.example.com \
  --acme-email admin@example.com

Что он делает:

1. Собирает бинарный файл backend (dist/bedrud)
2. Сжимает его в bedrud.tar.xz
3. Загружает на сервер через rsync
4. Останавливает конфликтующие службы (Nginx, Apache, Caddy)
5. Настраивает файрвол (UFW)
6. Запускает внутреннюю логику install на сервере

Точки входа служб

bedrud --run --config /etc/bedrud/config.yaml       # API + веб-сервер
bedrud --livekit --config /etc/bedrud/livekit.yaml   # Медиасервер

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

			
sudo ./bedrud user promote --email admin@example.com
		

Проверка служб

systemctl status bedrud livekit

Проверка API

curl -s -o /dev/null -w "%{http_code}" http://localhost:8090

Ожидаемый результат: 200

Проверка файрвола

sudo ufw status

Убедитесь, что порты 8090/tcp, 7880/tcp и 50000:60000/udp разрешены:

sudo ufw allow 8090/tcp
sudo ufw allow 7880/tcp
sudo ufw allow 50000:60000/udp

Просмотр журналов

tail -f /var/log/bedrud/bedrud.log

Или через journalctl:

journalctl -u bedrud -u livekit -f

Обновление

Через пакетный менеджер

# Ubuntu / Debian
sudo apt update && sudo apt upgrade bedrud
 
# Arch Linux
yay -Syu bedrud-bin
 
# Fedora / RHEL
sudo dnf upgrade bedrud

Службы перезапускаются автоматически после обновления пакета.

Загрузка бинарного файла

Загрузите последний релиз и запустите установку снова. Установщик безопасно запускать повторно - он перезаписывает бинарный файл и конфигурацию, сохраняя базу данных:

curl -fsSL -o bedrud.tar.xz https://github.com/bedrud-ir/bedrud/releases/latest/download/bedrud_linux_amd64.tar.xz
tar -xJf bedrud.tar.xz && chmod +x bedrud
sudo ./bedrud install --fresh

Docker

docker pull ghcr.io/bedrud-ir/bedrud:latest
docker stop bedrud && docker rm bedrud
docker run -d --name bedrud \
  -p 8090:8090 \
  -p 7880:7880 \
  -p 50000-60000:50000-60000/udp \
  -v bedrud-data:/var/lib/bedrud \
  ghcr.io/bedrud-ir/bedrud:latest

С Docker Compose:

docker compose pull
docker compose up -d

Удаление

Для полного удаления Bedrud:

sudo bedrud uninstall

Эта команда останавливает службы, удаляет unit-файлы systemd, удаляет бинарный файл из /usr/local/bin и очищает /etc/bedrud, /var/lib/bedrud и /var/log/bedrud.

Устранение неполадок