https://github.com/ipmartnetwork/birdx.chat

https://github.com/ipmartnetwork/birdx.chat

Last synced: 2 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/ipmartnetwork/birdx.chat
• Owner: iPmartNetwork
• License: mit
• Created: 2026-06-02T04:32:39.000Z (2 months ago)
• Default Branch: master
• Last Pushed: 2026-06-03T07:29:27.000Z (2 months ago)
• Last Synced: 2026-06-03T08:28:07.471Z (2 months ago)
• Language: JavaScript
• Size: 3.87 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.fa.md
  • Changelog: CHANGELOG.fa.md
  • License: LICENSE

Awesome Lists containing this project

README

          


  





  بردایکس چت — پیام‌رسانی امن self-hosted


  چت آنی · تماس صوتی/تصویری · E2EE · پنل مدیریت · فارسی و انگلیسی (RTL)





  گیت‌هاب ·

  شروع ·

  تصاویر ·

  یادداشت انتشار ·

  English



---

## معرفی

این مخزن **اپلیکیشن بردایکس چت** است: `client/` (PWA با React) و `server/` (API با Node.js). روی **دامنهٔ خودتان** برای تیم یا جامعه deploy کنید.

شامل **سایت birdx.chat**، فایل‌های آماده ویندوز/اندروید، یا iOS **نیست**. آن‌ها بخش محصول **BirdX میزبانی‌شده** توسط [iPmart Network](https://github.com/iPmartNetwork) است. نصب‌کنندهٔ شخصی معمولاً فقط مرورگر/PWA روی آدرس سرور خود را استفاده می‌کند.

### سرویس رسمی BirdX

| سرویس | توضیح |

|--------|--------|

| [birdx.chat](https://birdx.chat) | وب‌سایت و دانلود رسمی (دیپلوی خصوصی) |

| [app.birdx.chat](https://app.birdx.chat) | وب‌اپ رسمی کاربران BirdX |

### سفارشی‌سازی (در صورت درخواست)

خارج از این repo عمومی:

- **سایت معرفی** با برند شما

- اپ **ویندوز / اندروید / iOS** متصل به URL دلخواه

- آیکن و شناسهٔ استور

برای پروژه اختصاصی: [@birdx_app](https://t.me/birdx_app) یا [Issues گیت‌هاب](https://github.com/iPmartNetwork/BirdX.Chat/issues).

---

## نمای رابط



  

  





  



تصاویر را در docs/screenshots/ قرار دهید. تا قبل از آپلود، ممکن است در گیت‌هاب خالی دیده شوند.

---

## شروع سریع

```bash

git clone https://github.com/iPmartNetwork/BirdX.Chat.git

cd BirdX.Chat

npm install

cp .env.example .env

npm run build

npm start

```

نصب خودکار لینوکس:

```bash

bash <(curl -fsSL https://raw.githubusercontent.com/iPmartNetwork/BirdX.Chat/master/scripts/install.sh)

```

منوی تعاملی **birdx-deploy**: نصب، آپدیت، `.env`، دیتابیس، لاگ و TURN. هر زمان: `sudo birdx-deploy`.

دامنه با **HTTPS** (مثلاً `https://chat.example.com`). ادمین bootstrap: `birdxchat`.

| دستور | کار |

|--------|-----|

| `npm run dev` | توسعه محلی |

| `npm run build` | بیلد کلاینت |

| `npm start` | اجرای production |

---

## امکانات (خلاصه)

- پیام‌رسانی: DM، گروه، کانال، واکنش، فوروارد، نظرسنجی، استیکر، زمان‌بندی، بایگانی

- امنیت: E2EE، 2FA، رمزنگاری ذخیره‌سازی

- تماس: WebRTC، تاریخچه، تماس گروهی

- پنل `/admin`: کاربران، moderation، آمار، پشتیبان DB

- وب‌هوک، Bot API، FA/EN + RTL

---

## ساختار مخزن

```

BirdX.Chat/

├── client/       اپ وب

├── server/       API

├── deploy/nginx/ نمونه Nginx

├── docs/         مستندات و اسکرین‌شات README

└── data/         دیتابیس runtime

```

---

## دیپلوی و پیکربندی

- [`.env.example`](./.env.example)

- [`deploy/README.md`](./deploy/README.md)

**تماس صوتی/تصویری:** برای صدای پایدار روی موبایل و NATهای سخت‌گیر، `APP_TURN_URLS` / `APP_TURN_USERNAME` / `APP_TURN_CREDENTIAL` را تنظیم کنید. رفتار تماس گروهی با `GROUP_CALL_MODE` (پیش‌فرض `mesh` یا `sfu`)، `GROUP_CALL_MIN_MEMBERS` و `GROUP_CALL_MAX_PARTICIPANTS` کنترل می‌شود. اگر reverse proxy یا اپ موبایل (Capacitor) از origin متفاوتی وصل می‌شود، originهای مجاز را در `APP_ALLOWED_ORIGINS` فهرست کنید (خالی = مجاز بودن همه؛ احراز هویت نشست همیشه اجباری است).

---

## پشتیبانی

- باگ و پیشنهاد: [GitHub Issues](https://github.com/iPmartNetwork/BirdX.Chat/issues)

- اطلاعیه BirdX: [@birdx_app](https://t.me/birdx_app)

- سایت/اپ اختصاصی: تماس از تلگرام یا Issues

---

## قدردانی و مجوز

**iPmart Network** · سپاس از **پویا خلیلی** ([@bllackbull](https://github.com/bllackbull))

[MIT](./LICENSE)