اجزای سیستم
مخازن
| مؤلفه | مخزن | ایمیج |
|---|---|---|
| پنل (API + رابط وب) | xray-panel/backend | ghcr.io/xray-panel/backend |
| نود | xray-panel/node | ghcr.io/xray-panel/node |
| صفحه اشتراک | xray-panel/subscription-page | ghcr.io/xray-panel/subscription-page |
| استقرار | xray-panel/deploy | فایل‌های compose و پیکربندی‌های nginx |
فرانت‌اند پنل در ایمیج بک‌اند ساخته می‌شود (frontend-dist درون کانتینر)،
بنابراین کانتینر جداگانه‌ای برای رابط کاربری لازم نیست.
پنل
- HTTP API و رابط وب روی
APP_PORT(به‌طور پیش‌فرض 3000، و به بیرون — فقط از طریق پروکسی معکوس). - PostgreSQL — مخزن اصلی داده. کانتینر
xpanel-db. - Valkey (سازگار با Redis) — صف‌ها، کش، pub/sub. کانتینر
xpanel-redis. - متریک‌های Prometheus روی
METRICS_PORT(به‌طور پیش‌فرض 3001)، محافظت‌شده با basic auth ازMETRICS_USER/METRICS_PASS.
پنل تنها مؤلفه‌ای است که داده‌های شخصی را نگه می‌دارد.
نود
نود پایگاه داده ندارد و خودش به پنل متصل نمی‌شود. پنل با mutual TLS و
JWT از طریق NODE_PORT (به‌طور پیش‌فرض 2222) به آن متصل می‌شود.
نتیجه مهم این است: NODE_PORT باید از سرور پنل در دسترس باشد،
نه از مرورگر مدیر.
نود چه چیزی را نگه می‌دارد و به کجا متصل می‌شود:
- داده‌های کاربر روی دیسک نوشته نمی‌شوند — فقط لاگ‌های Xray در
/var/log/xray(محدود به 10 مگابایت، بدون آرشیو)؛ - در حافظه مجموعه‌ای از UUID کلاینت‌ها برای کنترل تغییرات پیکربندی نگه داشته می‌شود؛
- اتصال خروجی به پنل وجود ندارد — فقط ورودی؛
- تنها درخواست خروجی با داده‌های کاربر — webhook مربوط به torrent-blocker است، و فقط اگر در پلاگین فعال شده باشد.
صفحه اشتراک
کانتینر جداگانه‌ای که داده‌ها را با API-توکن از پنل می‌خواند و فهرست آراسته
اتصال‌ها را به کاربر نهایی ارائه می‌دهد. روی APP_PORT (به‌طور پیش‌فرض 3010)
کار می‌کند و برای بیرون — زیردامنه جداگانه با HTTPS.
نام متغیرهای REMNAWAVE_PANEL_URL و REMNAWAVE_API_TOKEN برای سازگاری حفظ
شده‌اند: به این ترتیب صفحه اشتراک با پنل قدیمی هم کار می‌کند.
پورت‌ها
| پورت | مؤلفه | دسترسی |
|---|---|---|
| 3000 | پنل | فقط 127.0.0.1، بیرون از طریق nginx |
| 3001 | متریک‌های پنل | فقط 127.0.0.1 |
| 3010 | صفحه اشتراک | فقط 127.0.0.1، بیرون از طریق nginx |
| 2222 | نود | در دسترس از سرور پنل |
| دلخواه | پروکسی Xray | باز برای کلاینت‌ها |
مجوز و انتساب
XLADA تحت AGPL-3.0-only منتشر می‌شود و اثری مشتق‌شده از Remnawave است. بند §13 مجوز AGPL ایجاب می‌کند که کاربران سرویس بتوانند کد منبع را دریافت کنند: مطمئن شوید که پیوند مخازن سازمان برای کاربران شما در دسترس است.