BirdX Docs
راهنما
راهنمای گامبهگام بردایکس — وباپ، تماس، اپ native و نصب سرور self-host (آنلاین یا آفلاین).
شروع کار
بردایکس در مرورگر روی app.birdx.chat اجرا میشود. برای تجربه کامل نصب اجباری نیست؛ اپ ویندوز و اندروید میانبر اختیاری به همان وباپ هستند.
- 1
وباپ را باز کنید
به app.birdx.chat در Chrome، Firefox، Safari یا Edge بروید. در صورت نیاز اعلان مرورگر را اجازه دهید.
- 2
حساب بسازید
نام کاربری یکتا و رمز قوی انتخاب کنید. نام نمایشی و عکس پروفایل اختیاری است. قبل از ورود به گروههای حساس، ورود دو مرحلهای را در تنظیمات → امنیت فعال کنید.
- 3
گفتگو را شروع یا ادامه دهید
از لیست اعضا چت خصوصی باز کنید، با دکمه + گروه بسازید، یا لینک دعوت کانال تیم را وارد کنید.
- 4
نصب PWA (اختیاری)
در Chrome یا Edge از منو «نصب اپ» را بزنید تا بردایکس روی نوار وظیفه یا صفحه اصلی موبایل سنجاق شود.
پیامرسانی
کار و جامعه را در یک محیط منظم نگه دارید.
چت خصوصی
گفتگوی یکبهیک. با E2EE پیام روی دستگاه با X3DH و AES-256-GCM رمز و ارسال میشود.
گروه
دعوت عضو، نقش (مالک، ادمین، مدیر، عضو)، سنجاق پیام و کنترل نحوه پیوستن.
کانال
اطلاعرسانی گسترده بدون نیاز به پاسخ همه در یک رشته.
فایل و رسانه
عکس، ویدیو و سند درون گفتگو. فایل را بکشید و رها کنید یا دکمه پیوست را بزنید.
نظرسنجی و استیکر
نظرسنجی برای تصمیم سریع تیم. استیکر برای واکنش بدون شلوغی چت.
جستجو و منشن
از جستجوی نوار کناری افراد و گفتگو را پیدا کنید. در صورت پشتیبانی با @username منشن کنید.
تماس صوتی و تصویری
تماسها با WebRTC در مرورگر — بدون شماره تلفن جدا.
شروع تماس
در چت خصوصی یا گروه باز، دکمه صوتی یا تصویری را بزنید. اجازه دوربین/میکروفون را بدهید.
اشتراک صفحه
در تماس تصویری صفحه یا پنجره را برای دمو و پشتیبانی به اشتراک بگذارید.
تماس گروهی
وقتی جامعه فعال کرده باشد به جلسه صوتی/تصویری گروهی بپیوندید. سقف شرکتکننده به تنظیمات سرور بستگی دارد.
عیبیابی
اگر رسانه کار نکرد: مجوز مرورگر، افزونه VPN، و شبکه سیمی را بررسی کنید. صفحه را رفرش و دوباره به تماس بپیوندید.
امنیت و حریم خصوصی
بدانید چه چیزی محافظت میشود و چه تنظیماتی با شماست.
رمزنگاری سرتاسری
E2EE برای چت خصوصی واجد شرایط. بردایکس محتوا را رمزگشایی نمیکند. آیکن قفل در هدر گفتگو را ببینید.
ورود دو مرحلهای
تنظیمات → امنیت → TOTP. کدهای پشتیبان را آفلاین نگه دارید.
نشست و دستگاهها
روی کامپیوتر مشترک خارج شوید. در صورت شک به نفوذ رمز را عوض و به support@birdx.chat بنویسید.
تنظیمات و پروفایل
پروفایل
نام نمایشی، قوانین نام کاربری و آواتار در تنظیمات → پروفایل.
زبان
جابهجایی انگلیسی و فارسی. جهت RTL خودکار بهروز میشود.
اعلانها
هشدار دسکتاپ و داخل اپ. در موبایل ممکن است افزودن به صفحه اصلی برای اعلان پایدار لازم باشد.
ظاهر
تم روشن یا تیره.
حریم خصوصی (سیاست DM)
در تنظیمات → حریم خصوصی مشخص کنید چه کسی میتواند چت خصوصی شروع کند.
اپها و دانلود
همگامسازی
پیامها و وضعیت خواندهشده با یک حساب همگام میمانند. تماس و اعلان per-device است.
کمک بیشتر
نصب سرور (self-host)
میزبانی بردایکس چت (سرور + کلاینت وب) روی VPS لینوکس خودتان. اپ رسمی app.birdx.chat جداست — این راهنما برای اپراتورهایی است که دامنه خود را deploy میکنند.
نصبکننده فقط چت را مستقر میکند — نه سایت birdx.chat و نه بیلد فروشگاه ویندوز/اندروید. اپ native با برند اختصاصی با درخواست در تلگرام.
- 1
پیشنیاز
اوبونتو یا دبیان با sudo، IP یا دامنه عمومی، پورت ۸۰/۴۴۳ (و در صورت نیاز TURN برای تماس). حداقل ۲ گیگ RAM برای production پیشنهاد میشود.
- Node.js 24 توسط اسکریپت نصب میشود
- HTTPS برای push notification لازم است
- ادمین bootstrap پیشفرض: birdxchat
- 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
نصب آفلاین (شبکه محدود)
وقتی 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
بعد از نصب
آدرس HTTPS خود را باز کنید، وارد شوید یا ثبتنام کنید، سپس /admin برای مدیریت کاربران. birdx-deploy برای آپدیت، .env، دیتابیس و لاگ.
- مسیر نصب: /opt/birdx
- میرور (npm/apt/Node) اختیاری — گزینه ۸ منو، فقط در صورت نیاز
- متغیرهای env: .env.example در گیتهاب
بسته سورس آفلاین
فایل ZIP شامل server/ و client/ (مثل مخزن GitHub). با هر نسخه self-host جدید اینجا بهروز کنید.
دانلود birdx-selfhost.zipاپ native اختصاصی
معمولاً PWA در مرورگر کافی است. شل ویندوز/اندروید با دامنه شما پروژه جداست.
@birdx_app