BirdX Docs

راهنما

راهنمای گام‌به‌گام بردایکس — وب‌اپ، تماس، اپ native و نصب سرور self-host (آنلاین یا آفلاین).

شروع کار

بردایکس در مرورگر روی app.birdx.chat اجرا می‌شود. برای تجربه کامل نصب اجباری نیست؛ اپ ویندوز و اندروید میانبر اختیاری به همان وب‌اپ هستند.

  1. 1

    وب‌اپ را باز کنید

    به app.birdx.chat در Chrome، Firefox، Safari یا Edge بروید. در صورت نیاز اعلان مرورگر را اجازه دهید.

  2. 2

    حساب بسازید

    نام کاربری یکتا و رمز قوی انتخاب کنید. نام نمایشی و عکس پروفایل اختیاری است. قبل از ورود به گروه‌های حساس، ورود دو مرحله‌ای را در تنظیمات → امنیت فعال کنید.

  3. 3

    گفتگو را شروع یا ادامه دهید

    از لیست اعضا چت خصوصی باز کنید، با دکمه + گروه بسازید، یا لینک دعوت کانال تیم را وارد کنید.

  4. 4

    نصب PWA (اختیاری)

    در Chrome یا Edge از منو «نصب اپ» را بزنید تا بردایکس روی نوار وظیفه یا صفحه اصلی موبایل سنجاق شود.

پیام‌رسانی

کار و جامعه را در یک محیط منظم نگه دارید.

چت خصوصی

گفتگوی یک‌به‌یک. با E2EE پیام روی دستگاه با X3DH و AES-256-GCM رمز و ارسال می‌شود.

گروه

دعوت عضو، نقش (مالک، ادمین، مدیر، عضو)، سنجاق پیام و کنترل نحوه پیوستن.

کانال

اطلاع‌رسانی گسترده بدون نیاز به پاسخ همه در یک رشته.

فایل و رسانه

عکس، ویدیو و سند درون گفتگو. فایل را بکشید و رها کنید یا دکمه پیوست را بزنید.

نظرسنجی و استیکر

نظرسنجی برای تصمیم سریع تیم. استیکر برای واکنش بدون شلوغی چت.

جستجو و منشن

از جستجوی نوار کناری افراد و گفتگو را پیدا کنید. در صورت پشتیبانی با @username منشن کنید.

تماس صوتی و تصویری

تماس‌ها با WebRTC در مرورگر — بدون شماره تلفن جدا.

شروع تماس

در چت خصوصی یا گروه باز، دکمه صوتی یا تصویری را بزنید. اجازه دوربین/میکروفون را بدهید.

اشتراک صفحه

در تماس تصویری صفحه یا پنجره را برای دمو و پشتیبانی به اشتراک بگذارید.

تماس گروهی

وقتی جامعه فعال کرده باشد به جلسه صوتی/تصویری گروهی بپیوندید. سقف شرکت‌کننده به تنظیمات سرور بستگی دارد.

عیب‌یابی

اگر رسانه کار نکرد: مجوز مرورگر، افزونه VPN، و شبکه سیمی را بررسی کنید. صفحه را رفرش و دوباره به تماس بپیوندید.

امنیت و حریم خصوصی

بدانید چه چیزی محافظت می‌شود و چه تنظیماتی با شماست.

رمزنگاری سرتاسری

E2EE برای چت خصوصی واجد شرایط. بردایکس محتوا را رمزگشایی نمی‌کند. آیکن قفل در هدر گفتگو را ببینید.

ورود دو مرحله‌ای

تنظیمات → امنیت → TOTP. کدهای پشتیبان را آفلاین نگه دارید.

نشست و دستگاه‌ها

روی کامپیوتر مشترک خارج شوید. در صورت شک به نفوذ رمز را عوض و به support@birdx.chat بنویسید.

سیاست حریم خصوصی

جمع‌آوری داده، نگهداری و حقوق شما.

سیاست حریم خصوصی

مرور امنیت

توضیح تصویری E2EE در صفحه اصلی.

بخش امنیت

تنظیمات و پروفایل

پروفایل

نام نمایشی، قوانین نام کاربری و آواتار در تنظیمات → پروفایل.

زبان

جابه‌جایی انگلیسی و فارسی. جهت RTL خودکار به‌روز می‌شود.

اعلان‌ها

هشدار دسکتاپ و داخل اپ. در موبایل ممکن است افزودن به صفحه اصلی برای اعلان پایدار لازم باشد.

ظاهر

تم روشن یا تیره.

حریم خصوصی (سیاست DM)

در تنظیمات → حریم خصوصی مشخص کنید چه کسی می‌تواند چت خصوصی شروع کند.

اپ‌ها و دانلود

وب‌اپ

برای استفاده روزانه پیشنهاد می‌شود؛ همیشه به‌روز بدون نصب دستی.

app.birdx.chat

ویندوز

birdx-setup.exe از birdx.chat/downloads — پنجره native روی app.birdx.chat.

دانلود ویندوز

اندروید

birdx.apk از birdx.chat/downloads — فقط از سایت رسمی نصب کنید.

دانلود APK

همگام‌سازی

پیام‌ها و وضعیت خوانده‌شده با یک حساب همگام می‌مانند. تماس و اعلان per-device است.

کمک بیشتر

سوالات متداول

پاسخ سوالات رایج.

مشاهده FAQ

تماس با پشتیبانی

مشکل حساب، گزارش سوءاستفاده و امنیت.

تماس با ما

تلگرام

اخبار و نسخه‌ها.

@birdx_app

گیت‌هاب

سورس و issueهای BirdX.Chat.

BirdX.Chat در GitHub

نصب سرور (self-host)

میزبانی بردایکس چت (سرور + کلاینت وب) روی VPS لینوکس خودتان. اپ رسمی app.birdx.chat جداست — این راهنما برای اپراتورهایی است که دامنه خود را deploy می‌کنند.

نصب‌کننده فقط چت را مستقر می‌کند — نه سایت birdx.chat و نه بیلد فروشگاه ویندوز/اندروید. اپ native با برند اختصاصی با درخواست در تلگرام.

  1. 1

    پیش‌نیاز

    اوبونتو یا دبیان با sudo، IP یا دامنه عمومی، پورت ۸۰/۴۴۳ (و در صورت نیاز TURN برای تماس). حداقل ۲ گیگ RAM برای production پیشنهاد می‌شود.

    • Node.js 24 توسط اسکریپت نصب می‌شود
    • HTTPS برای push notification لازم است
    • ادمین bootstrap پیش‌فرض: birdxchat
  2. 2

    نصب آنلاین (پیشنهادی)

    اسکریپت رسمی را دانلود می‌کند و منوی birdx-deploy باز می‌شود. Install → ویزارد (دامنه، TLS، آپلود، coturn اختیاری).

    curl -fsSL https://raw.githubusercontent.com/iPmartNetwork/BirdX.Chat/master/scripts/install.sh | sudo bash
    # بعداً:
    sudo birdx-deploy
  3. 3

    نصب آفلاین (شبکه محدود)

    وقتی GitHub یا npm در دسترس نیست، بسته سورس را دانلود کنید، روی سرور بگذارید و در birdx-deploy حالت Offline را انتخاب کنید.

    • فایل birdx-selfhost.zip را از همین سایت دانلود کنید
    • روی سرور به مسیر /birdx.zip (یا ~/birdx.zip) کپی کنید
    • یک‌بار اسکریپت نصب (حتی با USB)، سپس birdx-deploy → Install → Offline
    scp birdx-selfhost.zip root@SERVER:/birdx.zip
    ssh root@SERVER
    sudo birdx-deploy  # → نصب → آفلاین
  4. 4

    بعد از نصب

    آدرس HTTPS خود را باز کنید، وارد شوید یا ثبت‌نام کنید، سپس /admin برای مدیریت کاربران. birdx-deploy برای آپدیت، .env، دیتابیس و لاگ.

    • مسیر نصب: /opt/birdx
    • میرور (npm/apt/Node) اختیاری — گزینه ۸ منو، فقط در صورت نیاز
    • متغیرهای env: .env.example در گیت‌هاب

بسته سورس آفلاین

فایل ZIP شامل server/ و client/ (مثل مخزن GitHub). با هر نسخه self-host جدید اینجا به‌روز کنید.

دانلود birdx-selfhost.zip

گیت‌هاب

مخزن عمومی BirdX.Chat — clone برای بیلد دستی یا مشارکت.

BirdX.Chat در GitHub

اپ native اختصاصی

معمولاً PWA در مرورگر کافی است. شل ویندوز/اندروید با دامنه شما پروژه جداست.

@birdx_app