Bedrud التوثيق

يغطي هذا الدليل جميع طرق التثبيت المتاحة عبر مديري الحزم والملفات الثنائية لـ Bedrud - سواء الخادم أو عميل سطح المكتب.


تثبيت الخادم

مستودع apt (Ubuntu / Debian)

أسهل طريقة لتثبيت خادم Bedrud على الأنظمة المبنية على Debian هي عبر مستودع apt المستضاف ذاتيًا على GitHub Pages.

١. أضف المستودع ومفتاح 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

٢. ثبّت:

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)

١. أضف المستودع:

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

تحميل .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

تحميل الملف الثنائي يدويًا

حمّل الأرشيف المضغوط واستخرجه في أي مكان على $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 (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

أرشيفات محمولة مبنية مسبقًا متاحة لكل من 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 مُوقَّعة برمجيًا ومُوثَّقة عند تكوين MACOS_CERTIFICATE في CI (راجع مرجع الأسرار). بدون هذه الأسرار، الملف الثنائي غير مُوقَّع - استخدم الحل البديل 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.xz ثنائيAppImage / Flatpak / Snap / tar.xz
macOSملف tar.xz ثنائيHomebrew tap / ملف tar.gz محمول
Windows-WinGet / Chocolatey / مثبّت NSIS / ملف .zip محمول
Dockerghcr.io/bedrud-ir/bedrud-

مرجع الأسرار

هذه أسرار GitHub Actions تُفعّل قنوات التوزيع الاختيارية:

السرالقناةالوصف
AUR_SSH_PRIVATE_KEYAURمفتاح SSH للدفع إلى aur.archlinux.org
APT_GPG_PRIVATE_KEYمستودع aptمفتاح GPG لتوقيع ملف Release
APT_GPG_KEY_IDمستودع aptمعرّف المفتاح أعلاه
RPM_GPG_PRIVATE_KEYمستودع DNFمفتاح GPG لتوقيع حزم RPM
SNAPCRAFT_STORE_CREDENTIALSSnap Storeبيانات الدخول من snapcraft export-login
CHOCOLATEY_API_KEYChocolateyمفتاح API من chocolatey.org
HOMEBREW_TAP_TOKENHomebrew tapرمز PAT من GitHub مع صلاحية الكتابة إلى bedrud-ir/homebrew-bedrud
WINGET_GITHUB_TOKENWinGetرمز PAT من GitHub لتقديم PR إلى microsoft/winget-pkgs
MACOS_CERTIFICATEتوقيع macOSشهادة Developer ID بصيغة .p12 مشفرة بـ Base64
MACOS_CERTIFICATE_PWDتوقيع macOSكلمة مرور ملف .p12
MACOS_TEAM_IDتوقيع macOS / التوثيقمعرّف فريق مطور Apple
MACOS_APPLE_IDتوثيق macOSالبريد الإلكتروني لـ Apple ID
MACOS_APP_PWDتوثيق macOSكلمة مرور خاصة بالتطبيق لـ notarytool
IOS_P12_BASE64iOS IPAشهادة توزيع iOS
TELEGRAM_BOT_TOKENTelegramرمز بوت لإشعارات الإصدارات
TELEGRAM_CHAT_IDTelegramمعرّف القناة/المجموعة المستهدفة

جميع الأسرار اختيارية - إذا غابت، تُتجاوز مهمة تلك القناة بصمت.