این راهنما نصب سرور بدرود (API، Web UI، media server WebRTC) روی لینوکس را پوشش می‌دهد. برای کلاینت دسکتاپ و موبایل نصب کلاینت را ببینید.

پیش‌نیازها

دامنه ندارید؟ بدرود با آدرس IP و self-signed TLS کار می‌کند. مرورگرها هشدار گواهی نشان می‌دهند اما ویدیو و صدا کار می‌کنند. برای گواهی‌های قابل اعتماد در شبکه‌های داخلی، به راهنمای TLS داخلی ببینید.

۱. نصب با یک دستور (توصیه‌شده)

باینری CLI بِدْرود را دانلود و در PATH شما نصب می‌کند. روی لینوکس، مک‌او‌اس و ویندوز کار می‌کند.

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

source ~/.bashrc  # یا ~/.zshrc

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

بررسی:

bedrud --version

۲. نصب از طریق package manager

از طریق package manager توزیع خود نصب کنید.

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

۳. Docker

بدرود را در یک container اجرا کنید — بدون نصب مستقیم روی سرور لینوکس، بدون 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 شامل حجم‌ها، reverse proxy، و تنظیمات TLS: راهنمای Docker.

۴. نصب تعاملی

اگر فایل باینری bedrud را قبلاً روی سرور دارید:

sudo ./bedrud install

نصب‌کننده IP سرور را خودکار تشخیص می‌دهد و سوالات زیر را می‌پرسد:

وقتی stdin به pipe تبدیل شود (حالت غیرتعاملی)، هیچ سوالی پرسیده نمی‌شود و از فلگ‌ها و پیش‌فرض‌ها استفاده می‌شود.

۵. غیرتعاملی (مبتنی بر فلگ)

با فلگ، تمام سوالات را رد کنید.

Let’s Encrypt (دامنه مورد نیاز)

نیاز: رکورد DNS A که به IP سرور اشاره می‌کند.

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

self-signed TLS (مبتنی بر IP)

نیاز: هیچ‌چیز اضافی. فوراً کار می‌کند.

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

HTTP ساده (فقط توسعه / localhost)

نیاز: localhost یا 127.0.0.1. مرورگر دوربین/میکروفون را بدون HTTPS مسدود می‌کند (به‌جز localhost).

sudo ./bedrud install --ip 1.2.3.4

self-signed برای دامنه (تست قبل از DNS)

نیاز: نام دامنه (DNS لازم نیست فعال باشد).

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

پورت سفارشی

نیاز: پورت آزاد.

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

Certificateهای خارجی

نیاز: فایل‌های 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

پشت reverse proxy

نیاز: یک reverse proxy (Nginx، Caddy، Traefik، Cloudflare) که TLS را terminate کند.

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

behindProxy: true در config تنظیم می‌شود و trusted proxy headerها پیکربندی می‌شوند.

LiveKit خارجی

نیاز: سرور LiveKit جداگانه‌ای که در حال اجرا باشد و از این ماشین قابل دسترسی باشد.

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

LiveKit داخلی نصب نمی‌شود. API Key و Secret باید در هر دو config مطابقت داشته باشند.

دامنه جداگانه LiveKit

نیاز: دامنه‌ای که مستقیماً به IP سرور resolve شود (از CDN عبور نکند).

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

وقتی دامنه اصلی پشت Cloudflare است اما WebRTC به اتصال مستقیم نیاز دارد، مفید است.

مرجع تمام فلگ‌ها

۶. کاملاً خودکار (CLI Python)

سرور را از ماشین локального build، آپلود و پیکربندی کنید.

نیاز: Python 3.12+، uv، دسترسی 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

مراحل:

۱. باینری backend (dist/bedrud) را build می‌کند ۲. به bedrud.tar.xz فشرده می‌کند ۳. با rsync به سرور آپلود می‌کند ۴. سرویس‌های متضاد را حذف می‌کند (Nginx، Apache، Caddy) ۵. فایروال را پیکربندی می‌کند (UFW) ۶. install را روی سرور اجرا می‌کند

نقاط ورود سرویس

bedrud --run --config /etc/bedrud/config.yaml       # API + سرور وب
bedrud --livekit --config /etc/bedrud/livekit.yaml   # media server

پس از نصب

			
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

ارتقاء

package manager

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

سرویس‌ها پس از ارتقاء بسته به طور خودکار restart می‌شوند.

دانلود باینری

آخرین نسخه را دانلود کنید و نصب را دوباره اجرا کنید. نصب‌کننده امن است که دوباره اجرا شود - باینری و تنظیمات را بازنویسی می‌کند در حالی که دیتابیس را حفظ می‌کند:

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

حذف نصب

برای حذف کامل بدرود:

sudo bedrud uninstall

این سرویس‌ها را متوقف می‌کند، واحدهای systemd را حذف می‌کند، باینری را از /usr/local/bin حذف می‌کند، و /etc/bedrud، /var/lib/bedrud، و /var/log/bedrud را پاک می‌کند.

عیب‌یابی