معماری و زیرساخت پلتفرم
معماری 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با مقیاس دقیق انجام میپذیرد. - اصل بقای کیف پول: موجودی کیف پول کاربر دقیقاً برابر است با مجموع جبری ردیفهای جدول تراکنشها:
- ماه استاندارد تجاری: طول ماه تجاری بر روی ۷۲۰ ساعت (۳۰ روز تقویمی) فیکس شده و کلیه پنجرههای تجمیع مصرف بر اساس منطقه زمانی UTC ارزیابی میگردند.
$$\text{wallets.balance} = \sum \text{wallet\_transactions.amount}$$
۴. شبکه مش ایزوله 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) دارای سقف ۱ زون و ۱۰۰ رکورد هستند که با ارتقای اشتراک سازمانی بلافاصله افزایش مییابند.