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

Это руководство охватывает все доступные способы установки через менеджеры пакетов и бинарники для Bedrud - как сервера, так и десктопного клиента.


Установка сервера

Репозиторий apt (Ubuntu / Debian)

Самый простой способ установить сервер Bedrud на Debian-системах - через собственный apt-репозиторий, размещённый на GitHub Pages.

1. Добавьте репозиторий и GPG-ключ:

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

2. Установите:

sudo apt update && sudo apt install bedrud

Пакет устанавливает бинарник в /usr/local/bin/bedrud и регистрирует сервис systemd. После установки запустите интерактивный установщик:

sudo bedrud install

См. Руководство по установке для всех параметров конфигурации.


AUR (Arch Linux)

yay -S bedrud-bin

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

sudo bedrud install

Репозиторий DNF / RPM (Fedora / RHEL / openSUSE)

1. Добавьте репозиторий:

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

2. Установите:

sudo dnf install bedrud

Прямая загрузка .deb

Скачайте .deb-пакет напрямую из последнего релиза на GitHub:

wget https://github.com/bedrud-ir/bedrud/releases/latest/download/bedrud_amd64.deb
sudo dpkg -i bedrud_amd64.deb
sudo apt-get install -f   # resolve any missing dependencies
wget https://github.com/bedrud-ir/bedrud/releases/latest/download/bedrud_arm64.deb
sudo dpkg -i bedrud_arm64.deb
sudo apt-get install -f

Прямая загрузка .rpm

Скачайте .rpm-пакет из последнего релиза на GitHub:

sudo dnf install https://github.com/bedrud-ir/bedrud/releases/latest/download/bedrud-*.x86_64.rpm
sudo dnf install https://github.com/bedrud-ir/bedrud/releases/latest/download/bedrud-*.aarch64.rpm

Ручная загрузка бинарника

Скачайте сжатый tarball и распакуйте в любое место на вашем $PATH:

curl -L https://github.com/bedrud-ir/bedrud/releases/latest/download/bedrud_linux_amd64.tar.xz \
  | tar xJ
sudo mv bedrud /usr/local/bin/
curl -L https://github.com/bedrud-ir/bedrud/releases/latest/download/bedrud_linux_arm64.tar.xz \
  | tar xJ
sudo mv bedrud /usr/local/bin/

Docker

Скачайте готовый образ из GitHub Container Registry:

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

См. Руководство по Docker для полной информации, включая монтирование томов и настройку обратного прокси.


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

Linux

Сначала добавьте apt-репозиторий (см. Сервер - репозиторий apt выше), затем:

sudo apt install bedrud-desktop

Пакет устанавливает .desktop-лаунчер и регистрирует приложение в меню приложений.

yay -S bedrud-desktop-bin

Сначала добавьте DNF-репозиторий (см. Сервер - репозиторий DNF выше), затем:

sudo dnf install bedrud-desktop
sudo snap install bedrud-desktop

Snap доступен на любом дистрибутиве Linux, поддерживающем Snap daemon (snapd).

Установите из Flatpak-пакета:

flatpak install https://github.com/bedrud-ir/bedrud/releases/latest/download/bedrud-desktop-linux-x86_64.flatpak
flatpak run ir.bedrud.Desktop

AppImage автономен и работает на любом дистрибутиве Linux без установки.

wget https://github.com/bedrud-ir/bedrud/releases/latest/download/bedrud-desktop-linux-x86_64.AppImage
chmod +x bedrud-desktop-linux-x86_64.AppImage
./bedrud-desktop-linux-x86_64.AppImage

Для интеграции AppImage в лаунчер приложений используйте инструмент вроде AppImageLauncher.

Распакуйте и запустите из любой директории:

tar xf bedrud-desktop-linux-x86_64.tar.xz
./bedrud-desktop

macOS

Готовые портативные tarball’ы доступны для Intel и Apple Silicon. Приложение без подписи - после распаковки может потребоваться разрешить его в Системные настройки → Конфиденциальность и безопасность.

curl -L https://github.com/bedrud-ir/bedrud/releases/latest/download/bedrud-desktop-macos-arm64.tar.gz \
  | tar xz
# Allow the binary if macOS blocks it:
xattr -d com.apple.quarantine bedrud-desktop
./bedrud-desktop
curl -L https://github.com/bedrud-ir/bedrud/releases/latest/download/bedrud-desktop-macos-x86_64.tar.gz \
  | tar xz
xattr -d com.apple.quarantine bedrud-desktop
./bedrud-desktop
brew tap bedrud-ir/bedrud
brew install bedrud-desktop

Релизы macOS подписываются кодом и нотаризуются, когда в CI настроен MACOS_CERTIFICATE (см. Справочник секретов). Без этих секретов бинарник не подписан - используйте обходной путь с xattr выше или правый клик → Открыть в Finder.

Предупреждение Gatekeeper для неподписанного приложения macOS: выполните команду xattr выше или откройте Системные настройки → Конфиденциальность и безопасность и нажмите Открыть в любом случае после первой заблокированной попытки запуска.


Windows

Скачайте и запустите установщик из последнего релиза:

АрхитектураФайл
x86_64bedrud-desktop-windows-x86_64-setup.exe
ARM64bedrud-desktop-windows-arm64-setup.exe

Установщик регистрирует приложение в меню «Пуск» и в «Установка и удаление программ».

Установка не требуется - распакуйте и запустите:

АрхитектураФайл
x86_64bedrud-desktop-windows-x86_64.zip
ARM64bedrud-desktop-windows-arm64.zip
choco install bedrud-desktop
winget install Bedrud.BedrudDesktop

Сводная таблица

ПлатформаСерверДесктопный клиент
Ubuntu / Debian (apt)apt install bedrudapt install bedrud-desktop
Fedora / RHEL (dnf)dnf install bedruddnf install bedrud-desktop
Arch Linux (AUR)yay -S bedrud-binyay -S bedrud-desktop-bin
Любой LinuxAppImage / бинарник tar.xzAppImage / Flatpak / Snap / tar.xz
macOSБинарник tar.xzHomebrew tap / портативный tar.gz
Windows-WinGet / Chocolatey / NSIS-установщик / портативный .zip
Dockerghcr.io/bedrud-ir/bedrud-

Справочник секретов

Эти секреты GitHub Actions разблокируют дополнительные каналы распространения:

СекретКаналОписание
AUR_SSH_PRIVATE_KEYAURSSH-ключ для пуши в aur.archlinux.org
APT_GPG_PRIVATE_KEYapt-репозиторийGPG-ключ для подписи файла Release
APT_GPG_KEY_IDapt-репозиторийID ключа выше
RPM_GPG_PRIVATE_KEYDNF-репозиторийGPG-ключ для подписи RPM-пакетов
SNAPCRAFT_STORE_CREDENTIALSSnap StoreЛогин из snapcraft export-login
CHOCOLATEY_API_KEYChocolateyAPI-ключ с chocolatey.org
HOMEBREW_TAP_TOKENHomebrew tapGitHub PAT с доступом на запись в bedrud-ir/homebrew-bedrud
WINGET_GITHUB_TOKENWinGetGitHub PAT для отправки PR в microsoft/winget-pkgs
MACOS_CERTIFICATEПодпись macOSBase64-кодированный сертификат Developer ID .p12
MACOS_CERTIFICATE_PWDПодпись macOSПароль для файла .p12
MACOS_TEAM_IDПодпись / нотаризация macOSApple Developer Team ID
MACOS_APPLE_IDНотаризация macOSEmail Apple ID
MACOS_APP_PWDНотаризация macOSПароль для конкретного приложения для notarytool
IOS_P12_BASE64iOS IPAСертификат распространения iOS
TELEGRAM_BOT_TOKENTelegramТокен бота для уведомлений о релизах
TELEGRAM_CHAT_IDTelegramID целевого канала/группы

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