Bedrud Документация

Разверните Bedrud и присоединитесь к видеоконференции за 5 минут.

В этом руководстве:

  1. Получите CLI — установка одной командой (или ручная загрузка)
  2. Разверните серверbedrud install настроит всё автоматически
  3. Проверьте — убедитесь, что службы работают
  4. Создайте администратора и подключитесь — откройте браузер, назначьте права, начните конференцию

Дополнительная информация:

Единый бинарный файл, после загрузки интернет не нужен. Включает встроенный медиасервер и SQLite - работает в изолированных сетях. Скопируйте файл, выполните одну команду - готово.


Что вам понадобится

ТребованиеПодробности
Linux-серверamd64 или arm64, с доступом sudo и systemd. Для macOS/Windows: используйте Docker или WSL2 для сервера
Открытые порты8090, 7880, 50000–60000/udp. Для авто-TLS: также 80 и 443
Домен (опционально)С DNS A-записью, указывающей на ваш сервер. Нет домена? Работает с IP - см. альтернативы ниже

Как это работает: Вы запускаете один сервер Bedrud. Люди подключаются к конференциям в своём браузере (без установки) или через нативные приложения (Android, Windows, macOS, Linux).


1. Установите CLI Bedrud

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

Перезагрузите оболочку после установки:

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

Проверьте:

bedrud --version

Для флагов (--version, --install-dir, --skip-shell, автономная установка), см. CLI Установщик.

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

Закройте и снова откройте терминал, затем проверьте:

bedrud --version

Загрузите и распакуйте вручную. Замените linux_amd64 на вашу платформу (linux_arm64, darwin_amd64, darwin_arm64):

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 mv bedrud /usr/local/bin/

Для всех целевых платформ см. CLI Установщик.

Нет интернета на сервере? Загрузите на любой компьютер, перенесите через USB или scp bedrud.tar.xz user@server:/tmp/, затем распакуйте. Бинарный файл полностью автономен — никаких исходящих запросов после переноса.

Загрузка не удалась? Проверьте доступ в интернет или убедитесь, что URL доступен: github.com/bedrud-ir/bedrud/releases.


2. Разверните сервер

Установка сервера требует Linux с systemd. macOS и Windows не поддерживают bedrud install напрямую — используйте Docker или WSL2 вместо этого.

Замените meet.example.com и admin@example.com на свои значения:

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

Устанавливает бинарный файл в /usr/local/bin, генерирует конфигурацию, создаёт службы systemd, подготавливает TLS и запускает всё.

Порт 80 или 443 занят? Остановите конфликтующие службы: sudo systemctl stop nginx apache2 caddy, затем запустите установку снова.

Нет домена? Используйте IP-адрес сервера:

sudo bedrud install --tls --ip 1.2.3.4

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


3. Проверка

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

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

Не 200? Проверьте статус служб: sudo systemctl status bedrud livekit. Проверьте журналы: journalctl -u bedrud -u livekit --no-pager -n 50.


4. Регистрация и создание администратора

Откройте https://meet.example.com (или https://<ваш-ip>:8090) в браузере:

Выдать права администратора

Зарегистрируйтесь через веб-UI, затем выдайте права:

Или создайте админа напрямую:

				
sudo ./bedrud user create --email admin@example.com --password secret --name "Admin"
sudo ./bedrud user promote --email admin@example.com
			
  1. Войдите в систему (или обновите страницу) — в боковой панели появится раздел Администрирование (Обзор, Пользователи, Комнаты, Настройки). Готово - вы администратор.
  2. Создайте комнатуПодключитесьВключите видео/аудио - разрешите доступ к камере и микрофону при запросе

Панель администратора — После назначения роли войдите в систему для доступа к панели администратора по адресу /dashboard/admin. Управляйте пользователями, комнатами, системными настройками и токенами приглашений.

Справка по CLI — Полное управление пользователями: bedrud user promote, demote, create, delete.

Нативные клиенты для Android, Windows, macOS и Linux: GitHub Releases. Или поделитесь ссылкой на конференцию - участники подключатся в любом браузере.


Альтернативные способы установки

Docker

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.

Сборка из исходного кода

Требуется Go 1.24+ и Bun:

git clone https://github.com/bedrud-ir/bedrud.git
cd bedrud
make init
make local-run

make init устанавливает LiveKit, создаёт конфигурацию, загружает зависимости. make local-run собирает и запускает на http://localhost:8090.

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

sudo bedrud install --ip 127.0.0.1

Предупреждение: Браузеры блокируют доступ к камере и микрофону по не-HTTPS, кроме localhost. HTTP - только для разработки.

Системы, отличные от Linux

Команда bedrud install настраивает службы systemd и работает только в Linux. CLI-установщик (шаг 1) работает везде и помещает бинарный файл в PATH. Для установки сервера используйте Docker или WSL2.

ОССпособ
macOSCLI-установщик автоматически устанавливает в ~/bin/
WindowsCLI-установщик автоматически устанавливает в %USERPROFILE%\bin\
DockerРаботает на любой ОС с Docker (см. выше)

Внутренние сети

Нет публичного домена или исходящего интернета? См. Руководство по внутреннему TLS для настройки приватного центра сертификации и конфигурации хранилища доверенных сертификатов на клиентах.


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

Установщик генерирует /etc/bedrud/config.yaml. Значения по умолчанию подходят для большинства конфигураций. Измените jwtSecret и sessionSecret для production, затем перезапустите:

sudo systemctl restart bedrud livekit

Для настройки вместимости комнат, таймаутов или медиапортов см. Раздел LiveKit в Конфигурации.

Полная справка: Конфигурация


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

ПроблемаРешение
Порт 80/443 занятsudo systemctl stop nginx apache2 caddy
Службы не запускаютсяjournalctl -u bedrud -u livekit --no-pager -n 50
Ошибки сертификата TLSПроверьте DNS: dig meet.example.com. Должен указывать на IP сервера
Нет видео / ошибка WebRTCДля камеры требуется HTTPS. Используйте --tls. Откройте UDP 50000–60000 на файрволе
Конфликт портов LiveKitИспользуйте флаги --lk-port, --lk-tcp-port, --lk-udp-port
Файрвол блокирует медиаsudo ufw allow 8090/tcp && sudo ufw allow 7880/tcp && sudo ufw allow 50000:60000/udp
Предупреждения самоподписанного сертификатаСм. Руководство по внутреннему TLS для настройки приватного CA

Удаление

# Установка из бинарного файла
sudo bedrud uninstall
 
# Docker
docker stop bedrud && docker rm bedrud && docker volume rm bedrud-data
 
# Сборка из исходного кода
# Ctrl+C для остановки, затем: make clean

Следующие шаги