Bedrud مستندات

این راهنما تمام روش‌های نصب package manager و باینری در دسترس برای 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   # رفع وابستگی‌های گم‌شده
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 برای جزئیات کامل شامل سوار کردن حجم و تنظیم reverse proxy ببینید.


نصب کلاینت دسکتاپ

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 که از daemon 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

tarball‌های قابل حمل از پیش ساخته‌شده برای هر دو Intel و Apple Silicon موجود هستند. برنامه امضانشده نیست - پس از استخراج ممکن است نیاز باشد آن را در System Settings → Privacy & Security مجاز کنید.

curl -L https://github.com/bedrud-ir/bedrud/releases/latest/download/bedrud-desktop-macos-arm64.tar.gz \
  | tar xz
# اجازه دادن به باینری اگر macOS آن را مسدود کند:
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 بالا را اجرا کنید، یا System Settings → Privacy & Security را باز کنید و پس از اولین تلاش راه‌اندازی مسدود شده، Open Anyway را کلیک کنید.


Windows

نصب‌کننده را از آخرین انتشار دانلود و اجرا کنید:

معماریفایل
x86_64bedrud-desktop-windows-x86_64-setup.exe
ARM64bedrud-desktop-windows-arm64-setup.exe

نصب‌کننده برنامه را در منوی Start و Add/Remove Programs ثبت می‌کند.

نیازی به نصب نیست - استخراج و اجرا:

معماریفایل
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
هر Linuxباینری AppImage / tar.xzAppImage / Flatpak / Snap / tar.xz
macOSباینری tar.xztap Homebrew / tar.gz قابل حمل
Windows-WinGet / Chocolatey / نصب‌کننده NSIS / .zip قابل حمل
Dockerghcr.io/bedrud-ir/bedrud-

مرجع اسرار

این اسرار GitHub Actions کانال‌های توزیع اختیاری را باز می‌کنند:

مخفیکانالتوضیحات
AUR_SSH_PRIVATE_KEYAURکلید SSH برای push aur.archlinux.org
APT_GPG_PRIVATE_KEYمخزن aptکلید GPG برای امضای فایل Release
APT_GPG_KEY_IDمخزن aptشناسه کلید بالا
RPM_GPG_PRIVATE_KEYمخزن DNFکلید GPG برای امضای بسته‌های RPM
SNAPCRAFT_STORE_CREDENTIALSفروشگاه Snapورود از snapcraft export-login
CHOCOLATEY_API_KEYChocolateyکلید API از chocolatey.org
HOMEBREW_TAP_TOKENtap HomebrewGitHub PAT با دسترسی نوشتن به bedrud-ir/homebrew-bedrud
WINGET_GITHUB_TOKENWinGetGitHub PAT برای ارسال PR به microsoft/winget-pkgs
MACOS_CERTIFICATEامضای macOSگواهی .p12 شناسه توسعه‌دهنده کدگذاری شده Base64
MACOS_CERTIFICATE_PWDامضای macOSرمز عبور برای فایل .p12
MACOS_TEAM_IDامضای macOS / تأییدشناسه تیم Apple Developer
MACOS_APPLE_IDتأیید macOSآدرس ایمیل Apple ID
MACOS_APP_PWDتأیید macOSرمز عبور اختصاصی برنامه برای notarytool
IOS_P12_BASE64IPA iOSگواهی توزیع iOS
TELEGRAM_BOT_TOKENTelegramتوکن ربات برای اعلان‌های انتشار
TELEGRAM_CHAT_IDTelegramشناسه کانال/گروه هدف

همه اسرار اختیاری هستند - اگر غایب باشند، کار آن کانال به طور خاموش رد می‌شود.