يغطي هذا الدليل تثبيت خادم بدرود (واجهة برمجة التطبيقات، واجهة الويب، خادم وسائط WebRTC) على خادم لينكس. لتطبيقات العميل على سطح المكتب والهاتف المحمول، راجع تثبيت العميل.

المتطلبات الأساسية

لا تملك نطاقاً؟ يعمل بدرود مع عنوان IP باستخدام TLS موقّع ذاتياً. ستُظهر المتصفحات تحذير شهادة لكن الفيديو والصوت يعملان. للحصول على شهادات موثوقة على الشبكات الداخلية، راجع دليل TLS الداخلي.

١. التثبيت بأمر واحد (موصى به)

يُنزّل ويُثبّت ملف Bedrud CLI الثنائي في مسار PATH الخاص بك. يعمل على لينكس وماك‌أو‌إس وويندوز.

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

source ~/.bashrc  # أو ~/.zshrc

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

تحقّق:

bedrud --version

٢. التثبيت عبر مدير الحزم

ثبّت عبر مدير حزم توزيعتك.

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

شغّل بدرود في حاوية - بدون إعداد خادم لينكس، بدون 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.

٤. التثبيت التفاعلي

إذا كان لديك الملف الثنائي bedrud بالفعل على الخادم:

sudo ./bedrud install

يكتشف المثبّت تلقائياً عنوان IP لخادمك ويطلب:

يتم تخطي جميع المطالبات عند توجيه stdin (الوضع غير التفاعلي) - تُستخدم العلامات والقيم الافتراضية بدلاً من ذلك.

٥. غير تفاعلي (بالعلامات)

تخطَّ جميع المطالبات بتمرير العلامات.

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 أمام بدرود.

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 تحتاج اتصالاً مباشراً.

مرجع جميع العلامات

٦. مؤتمت بالكامل (CLI Python)

ابنِ، ارفع، وتهيّئ خادمك من جهازك المحلي.

يتطلب: 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

ما يفعله:

١. يبني الملف الثنائي للخلفية (dist/bedrud) ٢. يضغطه إلى bedrud.tar.xz ٣. يرفعه إلى الخادم عبر rsync ٤. يزيل الخدمات المتعارضة (Nginx، Apache، Caddy) ٥. يهيّئ جدار الحماية (UFW) ٦. يشغّل منطق 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

التحقق من واجهة برمجة التطبيقات

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

إزالة التثبيت

لإزالة بدرود بالكامل:

sudo bedrud uninstall

يُوقف الخدمات، يزيل وحدات systemd، يحذف الملف الثنائي من /usr/local/bin، وينظّف /etc/bedrud، /var/lib/bedrud، و /var/log/bedrud.

استكشاف الأخطاء وإصلاحها