🇬🇧 English · 🇮🇷 فارسی

این ویکی توضیح می‌دهد سیستم چطور کار می‌کند، هر نقش چه کاری انجام می‌دهد، و گام‌به‌گام چطور نصب/اتصال/استفاده شود.

یک سامانه‌ی فروش نود بر پایه‌ی فورک PasarGuard/node:

• NodeAgent (repo): نودِ چند-مستأجری. یک Xray مشترک، چند مشتری (tenant) را با کاربرهایشان سرویس می‌دهد؛ سهمیه‌ی حجم/انقضا را محلی enforce می‌کند.
• NodePanel (repo): پنل کنترل مرکزی که چند نود، مشتری، پلن و اشتراک را مدیریت می‌کند و مصرف را برای ربات فروش expose می‌کند.

┌────────────┐      Bearer API        ┌──────────────┐   master key (HTTPS :8090)   ┌───────────────┐
│ ربات فروش   │ ───────────────────▶ │  NodePanel    │ ───────────────────────────▶ │   NodeAgent    │
│ (پول/کیف‌پول)│ ◀─ webhook (HMAC) ── │ (نود/مشتری/پلن)│                              │ (Xray مشترک)   │
└────────────┘                        └──────────────┘                              └───────┬───────┘
                                                                                            │ customer key
                                       پنلِ PasarGuard مشتری ──── gRPC (:62050) ─────────────┘
                                       (کاربرهای نهایی را می‌سازد)

• پنل پول ندارد. کیف‌پول/قیمت/پرداخت در ربات فروشِ بیرونی است؛ پنل فقط بایت/زمان/وضعیت را مدیریت و مصرف/overage را گزارش می‌کند.
• جداسازی مستأجرها بر اساس کاربر؛ یکتایی credential در کل نود enforce می‌شود.
• اتمام حجم/انقضا → کاربرهای آن مشتری از هسته حذف و کلیدش رد می‌شود (suspend ≠ delete؛ تمدید داده‌ها را برمی‌گرداند).

• اپراتور: نصب پنل → نصب نود → افزودن نود و فروش
• تنظیم هسته‌ی Xray نود (فروشنده): تنظیم هسته
• مشتری: اتصال از پنل PasarGuard
• استفاده‌ی شخصی هم‌زمان با فروش: استفاده‌ی شخصی
• نگهداری/آپدیت: آپدیت و نگهداری
• مشکلات: عیب‌یابی
• توسعه‌دهنده‌ی ربات: API و Webhook