Bedrud مستندات

بدرود را راه‌اندازی کنید و در کمتر از ۵ دقیقه به جلسه ویدیویی بپیوندید.

در این راهنما:

۱. دریافت CLI — نصب با یک دستور (یا دانلود دستی) ۲. استقرار سرورbedrud install همه‌چیز را تنظیم می‌کند ۳. تأیید — مطمئن شوید سرویس‌ها اجرا هستند ۴. ایجاد ادمین و پیوستن — مرورگر را باز کنید، خودتان را ارتقا دهید، جلسه را شروع کنید

اطلاعات بیشتر:

یک باینری، بدون نیاز به اینترنت پس از دانلود. media server و SQLite داخلی دارد — در شبکه‌های ایزوله هم کار می‌کند.


آنچه نیاز دارید

نیازجزئیات
سرور لینوکسیamd64 یا arm64، با دسترسی sudo و systemd. macOS/Windows: از Docker یا WSL2 برای سرور استفاده کنید
پورت‌های باز8090، 7880، 50000–60000/udp. برای TLS خودکار: 80 و 443 هم باز باشد
دامنه (اختیاری)رکورد DNS A به IP سرور. بدون دامنه؟ با IP هم کار می‌کند

نحوه کار: شما یک سرور بدرود اجرا می‌کنید. افراد در مرورگر خود join می‌شوند (بدون نصب) یا از اپلیکیشن بومی (Android، Windows، macOS، Linux) استفاده می‌کنند.


۱. دریافت CLI بِدْرود

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/ منتقل کنید، سپس extract کنید. باینری کاملاً self-contained است — بدون درخواست خروجی پس از انتقال.

دانلود شکست خورد؟ اتصال اینترنت را بررسی کنید، یا URL را در GitHub Releases تأیید کنید.


۲. استقرار سرور

راه‌اندازی سرور به لینوکس با 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 نصب می‌کند، config تولید می‌کند، سرویس‌های systemd ایجاد می‌کند، TLS تأمین و همه‌چیز را شروع می‌کند.

پورت ۸۰ یا ۴۴۳ اشغال است؟ سرویس‌های متضاد را متوقف کنید: sudo systemctl stop nginx apache2 caddy، سپس دوباره اجرا کنید.

دامنه ندارید؟ از IP سرور استفاده کنید:

sudo bedrud install --tls --ip 1.2.3.4

از self-signed certificate استفاده می‌شود. مرورگر هشدار می‌دهد اما ویدیو کار می‌کند. برای certificate معتبر در شبکه داخلی راهنمای TLS داخلی را ببینید.


۳. تأیید

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

انتظار: 200

۲۰۰ نیست؟ وضعیت سرویس: sudo systemctl status bedrud livekit. لاگ‌ها: journalctl -u bedrud -u livekit --no-pager -n 50.


۴. ثبت‌نام و ایجاد ادمین

https://meet.example.com (یا https://<your-ip>:8090) را در مرورگر خود باز کنید:

ارتقای کاربر به مدیر

از طریق رابط وب در آدرس سرورتان ثبت‌نام کنید، سپس کاربر را به مدیر ارتقا دهید:

همچنین می‌توانید مستقیماً یک کاربر مدیر جدید بسازید:

				
sudo ./bedrud user create --email admin@example.com --password secret --name "Admin"
sudo ./bedrud user promote --email admin@example.com
			

۱. وارد شوید (یا رفرش کنید) — بخش Admin در نوار کناری ظاهر می‌شود (نمای کلی، کاربران، اتاق‌ها، تنظیمات). موفقیت: شما ادمین هستید. ۲. ایجاد اتاقپیوستناشتراک‌گذاری ویدیو/صدا - هنگام درخواست، اجازه دوربین/میکروفون را بدهید

داشبورد ادمین — پس از ارتقاء، وارد شوید و به /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 فقط برای توسعه است.

سیستم‌های غیر لینوکسی

دستور bedrud install سرویس‌های systemd ایجاد می‌کند و فقط برای لینوکس است. نصب‌کننده CLI (مرحله ۱) همه‌جا کار می‌کند و باینری را در PATH قرار می‌دهد. برای راه‌اندازی سرور، از Docker یا WSL2 استفاده کنید.

سیستم‌عاملنحوه انجام
macOSنصب‌کننده CLI به صورت خودکار در ~/bin/ نصب می‌کند
Windowsنصب‌کننده CLI به صورت خودکار در %USERPROFILE%\bin\ نصب می‌کند
Dockerروی هر سیستم‌عاملی با Docker کار می‌کند (بالا را ببینید)

شبکه‌های داخلی

بدون دامنه عمومی یا اینترنت خروجی؟ به راهنمای TLS داخلی برای تنظیم CA خصوصی و پیکربندی ذخیره‌سازی اعتماد کلاینت ببینید.


پیکربندی

نصب‌کننده /etc/bedrud/config.yaml تولید می‌کند. پیش‌فرض‌ها برای اکثر موارد مناسب‌اند. در تولید، jwtSecret و sessionSecret را تغییر دهید و restart کنید:

sudo systemctl restart bedrud livekit

برای تنظیم ظرفیت اتاق، زمان‌های انقضا، یا پورت‌های مدیا، به بخش LiveKit در پیکربندی ببینید.

مرجع کامل: پیکربندی


عیب‌یابی

مشکلرفع
پورت ۸۰/۴۴۳ در استفاده استsudo systemctl stop nginx apache2 caddy
سرویس‌ها شروع نمی‌شوندjournalctl -u bedrud -u livekit --no-pager -n 50
خطاهای گواهی TLSDNS را تأیید کنید: dig meet.example.com. باید به IP سرور اشاره کند
بدون ویدیو / WebRTC شکست خوردبرای دوربین HTTPS لازم است. از --tls استفاده کنید. UDP ۵۰۰۰۰–۶۰۰۰۰ را روی فایروال باز کنید
تداخل پورت 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
هشدارهای self-signed certificateبه راهنمای TLS داخلی برای تنظیم CA خصوصی ببینید

حذف

# نصب باینری
sudo bedrud uninstall
 
# Docker
docker stop bedrud && docker rm bedrud && docker volume rm bedrud-data
 
# ساخت از منبع
# برای توقف Ctrl+C، سپس: make clean

مراحل بعدی