Rayno DocsRayno Cloud v2.2.0
docsarchitecture

معماری و زیرساخت پلتفرم

معماری Control Plane، Node Agent، شبکه WireGuard و موتور صورت‌حساب PAYG.

# معماری پلتفرم ابری Rayno Cloud

راینو کلاد بر پایه یک معماری ماژولار، ایزوله و توزیع‌شده طراحی شده است که تضمین‌کننده پایداری ۹۹.۹۹٪، محاسبات مالی دقیق و استقرار سریع است.

graph TD
    Client["توسعه‌دهنده / CLI / Console"] -->|"HTTPS / REST / WebSocket"| CP["Control Plane (api.rayno.cloud)"]
    CP -->|"Advisory Lock 0x5061617350"| DB[("PostgreSQL Master (NUMERIC 16,4)")]
    CP -->|"gRPC / WireGuard (10.100.0.0/16)"| Agent1["Node Agent (Worker Node 1)"]
    CP -->|"gRPC / WireGuard (10.100.0.0/16)"| Agent2["Node Agent (Worker Node 2)"]
    Registry["OCI Container Registry (GHCR/Docker)"] -.->|"Pull-Only Immutable Image"| Agent1
    Registry -.->|"Pull-Only Immutable Image"| Agent2
    Agent1 -->|"Private Network"| S3[("MinIO S3 Object Storage")]
    DNS["Anycast DNS (ns1 / ns2)"] -->|"Route Traffic"| Agent1

۱. لایه کنترل‌پلن (Control Plane)

کنترل‌پلن مغز متفکر راینو کلاد است که با زبان Go 1.26.6 توسعه یافته و وظایف زیر را به عهده دارد:

  • مدیریت نشست‌ها، احراز هویت دوعاملی (TOTP) و کلیدهای API با پیشوند psk_live_.
  • اعمال قفل‌های مشاوره‌ای پستگرس (0x5061617350) در هنگام مهاجرت‌ها و بوت‌استرپ برای جلوگیری از Race Condition.
  • ثبت تمام رخدادهای حساس در جدول Audit Log با امضای دیجیتال و آدرس IP مبدأ.
  • زمان‌بندی جاب‌های پس‌زمینه و لغو خودکار Leaseهای مرده پس از ۱۲۰ ثانیه.

۲. نود ایجنت و اصل Pull-Only (Node Agent)

نود ایجنت به عنوان یک دیمن مستقل و فوق‌سبک روی تمام سرورهای پردازشی (Worker Nodes) اجرا می‌شود:

  • قانون عدم کامپایل در Worker: نود ایجنت‌ها تحت هیچ شرایطی دستورات ساخت (مانند docker build یا go build) اجرا نمی‌کنند. تمام ایمیج‌ها در محیط CI ساخته و در رجیستری معتبر ثبت می‌شوند.
  • ایزولاسیون کامل: هر اپلیکیشن در cgroup و namespace اختصاصی با سهمیه دقیق vCPU و حافظه RAM اجرا می‌شود.
  • ارسال ضربان قلب (Heartbeat): هر ۳۰ ثانیه وضعیت سلامت نود، بار پردازنده، میزان مصرف دیسک و کانتینرهای فعال به کنترل‌پلن گزارش می‌شود.

۳. موتور مالی و حسابداری دوطرفه (Double-Entry PAYG)

موتور صورت‌حساب ساعتی راینو کلاد از اصول سخت‌گیرانه ریاضیات مالی پیروی می‌کند:

  • عدم استفاده از اعشار شناور: تمام محاسبات مالی در سطح دیتابیس با نوع داده NUMERIC(16, 4) و در کد Go با کتابخانه اختصاصی pkg/toman با مقیاس دقیق انجام می‌پذیرد.
  • اصل بقای کیف پول: موجودی کیف پول کاربر دقیقاً برابر است با مجموع جبری ردیف‌های جدول تراکنش‌ها:
  • $$\text{wallets.balance} = \sum \text{wallet\_transactions.amount}$$

  • ماه استاندارد تجاری: طول ماه تجاری بر روی ۷۲۰ ساعت (۳۰ روز تقویمی) فیکس شده و کلیه پنجره‌های تجمیع مصرف بر اساس منطقه زمانی UTC ارزیابی می‌گردند.

۴. شبکه مش ایزوله WireGuard

تمام سرورهای پردازشی و سرویس‌های کاربر در یک شبکه مش اختصاصی با محدوده آدرس 10.100.0.0/16 قرار دارند:

  • ترافیک بین برنامه‌ها و دیتابیس‌ها مستقیماً در بستر تونل رمزنگاری‌شده ChaCha20-Poly1305 عبور می‌کند.
  • دسترسی عمومی دیتابیس‌ها به طور پیش‌فرض مسدود است و تنها از طریق IPهای داخلی WireGuard امکان‌پذیر می‌باشد.
  • معافیت‌های مالی ترافیک داخلی تنها با توکن‌های HMAC معتبر بین ایجنت‌ها شناسایی می‌شود و هدرهای HTTP کاربر ملاک قرار نمی‌گیرند.

۵. سیستم Anycast DNS و سهمیه‌بندی تراکنشی

زیرساخت DNS راینو کلاد بر روی دو سرور معتبر ns1.rayno.cloud و ns2.rayno.cloud مستقر است:

  • ساخت زون و رکورد در تراکنش‌های ایزوله با قفل سطر مالک (SELECT 1 FROM users WHERE id = $1 FOR UPDATE) انجام می‌شود تا از تجاوز از سهمیه پلن کاربر جلوگیری شود.
  • پلن‌های پایه (dns-free) دارای سقف ۱ زون و ۱۰۰ رکورد هستند که با ارتقای اشتراک سازمانی بلافاصله افزایش می‌یابند.
آخرین به‌روزرسانی: مستندات نسخه پلتفرم (Rayno Cloud v2.2.0)مشکلی در مستندات پیدا کردید؟ تیکت بزنید