⚡ تثبيت NATS Server مع JetStream — نظام الرسائل والتدفق فائق السرعة على Docker
نشر خادم NATS مع محرك JetStream على Ubuntu باستخدام Docker — وسيط الرسائل السحابي فائق الأداء ومنصة تدفق البيانات للخدمات المصغرة والأنظمة الموزعة.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/databases/nats/nats-ubuntu.sh
chmod +x nats-ubuntu.sh
sudo bash nats-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/databases/nats/nats-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x nats-ubuntu.sh
3 تشغيل المثبت
يقوم السكريبت بتثبيت Docker وسحب صورة nats:latest الرسمية وتشغيل خادم NATS مع تفعيل محرك التدفق الدائم JetStream والتخزين على القرص ومراقبة HTTP على المنفذ 8222.
sudo bash nats-ubuntu.sh
4 الوصول لواجهة المراقبة
افتح متصفحك وافحص مسارات المراقبة المدمجة عبر الرابط http://ip-سيرفرك:8222/varz لمتابعة صحة الخادم والاتصالات النشطة وحجم تدفق الرسائل ومحرك JetStream.
curl http://:8222/varz
# Then use the nats CLI against nats://:@:4222
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 4222 | Client connections |
| 8222 | HTTP monitoring (admin only) |
| 6222 | Cluster routing (between nodes) |
| 7422 | Leaf node connections (optional) |
نظرة عامة
يعد NATS أحد أبرز مشاريع الحوسبة السحابية التابعة لمؤسسة CNCF، وهو نظام رسائل فائق الخفة والسرعة مصمم للتطبيقات السحابية الحديثة وأنظمة إنترنت الأشياء والخدمات المصغرة (Microservices). تم بناء NATS بلغة Go وهو قادر على معالجة عشرات الملايين من الرسائل في الثانية الواحدة بزمن تأخير يقل عن جزء من الملي ثانية. يجمع NATS ثلاثة أنماط قوية في ملف تنفيذي واحد: النشر والاشتراك المباشر (Core Pub/Sub)، ونمط الطلب والاستجابة (Request-Reply)، ومحرك التخزين والتدفق الدائم (JetStream) مع دعم تخزين المفتاح-القيمة (Key-Value) وتخزين الكائنات (Object Store).
لماذا تستخدمه
غالباً ما تعاني الأنظمة الموزعة المبنية على المعمارية الموجهة بالأحداث (Event-Driven) من تعقيدات الإدارة واستهلاك الموارد العالي لوسطاء الرسائل التقليديين مثل Apache Kafka أو RabbitMQ. يحل NATS هذه المعضلة بتقديمه بساطة استثنائية دون أي تبعيات خارجية مع استهلاك متناهي الصغر للذاكرة (بين 20 إلى 50 ميجابايت). ومع تفعيل JetStream، يوفر NATS حفظاً دائماً للرسائل، ومتابعة تسليم الرسائل للمستهلكين، وتخزين المفتاح-القيمة الموزع دون الحاجة لتشغيل قواعد بيانات إضافية أو مجموعات ZooKeeper.
متى تحتاجه
- تبني خدمات مصغرة (Microservices) وتحتاج إلى ناقل أحداث فائق السرعة ومنخفض التأخير للتواصل واستدعاء الخدمات
- تحتاج إلى محرك تدفق أحداث دائم (مشابه لـ Kafka) مع تتبع الرسائل وإعادة تشغيلها ولكن دون استهلاك الموارد المعقد
- تحتاج إلى مخزن Key-Value أو Object Store مدمج مباشرة مع منصة بث الأحداث
- تطور شبكات إنترنت الأشياء (IoT) أو حوسبة الحافة وتتطلب تبادلاً موثوقاً للرسائل عبر اتصالات شبكية متقطعة
- ترغب في استبدال أنظمة الرسائل الثقيلة بنظام خفيف وسريع يبدأ عمله في أجزاء من الثانية
من يحتاجه
- مطور الخدمات الخلفية ومهندسو المعماريات الموزعة الذين يبنون أنظمة قائمة على الأحداث التفاعلية
- مهندسو DevOps والحلول السحابية الذين يديرون عناقيد Kubernetes وشبكات الخدمات (Service Mesh)
- مهندسو إنترنت الأشياء وحوسبة الحافة الذين يحتاجون إلى وسيط رسائل خفيف للأجهزة والمتحكمات البعيدة
- مطور الأنظمة المالية والتداول اللحظي الذين يتطلب عملهم سرعة معالجة فورية بالملي ثانية
- مديرو الأنظمة الذين يبحثون عن ناقل أحداث مستقر وموثوق لأتمتة البنية التحتية والتنبيهات
حالات الاستخدام الشائعة
- تنفيذ نمط Event Sourcing وتدفق الأحداث الدائم للمعاملات المالية والتجارية للخدمات المصغرة
- فصل وتوزيع مهام الخدمات المصغرة بنمط Request-Reply مع توزيع الحمل تلقائياً على طوابير المعالجة
- تخزين إعدادات التكوين المتغيرة ومفاتيح الميزات عبر مخازن Key-Value المدمجة في JetStream
- استقبال تدفقات القراءات والحساسات عالية التردد من آلاف أجهزة IoT مع تأكيد استلام الرسائل
- توزيع الإشعارات والتحديثات الحية لتطبيقات الويب والهواتف عبر بروتوكول NATS WebSockets
الميزات الرئيسية
- نمط النشر والاشتراك (Pub/Sub) الأساسي مع توجيه المواضيع بدعم الرموز البديلة (* و >)
- نمط الطلب والاستجابة (Request-Reply) مع موازنة الحمل وتوزيع الرسائل تلقائياً على طوابير العمال
- محرك JetStream للتخزين الدائم للرسائل مع ضمانات التسليم (مرة واحدة على الأقل أو بالضبط)
- مخزن المفتاح-القيمة (Key-Value Store) ومخزن الكائنات (Object Store) المدمجان مباشرة فوق JetStream
- محرك مراقبة HTTP مدمج على المنفذ 8222 يوفر مقاييس JSON لحظية (/varz و/connz و/jsz)
- أداء استثنائي يعالج ملايين الرسائل في الثانية الواحدة بزمن تأخير بالميكرو ثانية
- مكتبات برمجية رسمية لجميع اللغات: Go وPython وNode.js وJava وC# وRust وC
- نشر خفيف عبر Docker مع ربط المجلدات لضمان بقاء الرسائل والتدفقات المخزنة
كيفية الاستخدام بعد التثبيت
- ثبت أداة NATS CLI الرسمية (عبر حزمة nats-box أو التثبيت المباشر) للتفاعل مع الخادم وإدارته
- اختبر النشر والاشتراك: افتح نافذة طرفية ونفذ 'nats sub my.topic' وفي نافذة أخرى 'nats pub my.topic "Hello NATS!"'
- استعرض مقاييس المراقبة بفتح http://ip-سيرفرك:8222/varz وhttp://ip-سيرفرك:8222/jsz في المتصفح
- أنشئ تدفق JetStream الأول باستخدام سطر الأوامر: nats stream add ORDERS --subjects 'orders.*' --storage file
- أعد ملف الإعداد nats-server.conf لتفعيل المصادقة بكلمات المرور أو رموز NKey/JWT الرقمية
- اربط تطبيقاتك البرمجية باستخدام مكتبات NATS الرسمية عبر الاتصال بالعنوان nats://ip-سيرفرك:4222
أفضل ممارسات الأمان
- يبدأ خادم NATS بدون مصادقة افتراضياً؛ يجب إعداد المصادقة عبر الرموز أو NKeys أو الحسابات قبل بيئة الإنتاج
- اقصر منفذ المراقبة 8222 على الشبكة المحلية أو localhost، حيث يكشف بيانات السيرفر والاتصالات وأسماء المواضيع
- فعل تشفير TLS/SSL على منفذ العملاء 4222 إذا كانت حركة مرور الرسائل تمر عبر شبكات عامة أو سحابية
- استخدم حسابات NATS وصلاحيات المواضيع (ACLs) لتقييد الخدمات ومنعها من قراءة أو نشر مواضيع غير مخصصة لها
- لا تكشف المنفذ 4222 للإنترنت العام مباشرة دون مصادقة قوية وحماية جدار الحماية
- حدّث حاوية NATS دورياً للحصول على التحديثات الأمنية وإصلاحات الثغرات من مشروع CNCF
المنافذ وإعدادات جدار الحماية
يستمع NATS Server لاتصالات العملاء والتطبيقات على منفذ TCP 4222، بينما يستمع خادم المراقبة على منفذ TCP 8222. في حال إعداد عنقود (Cluster) تتواصل الخوادم عبر منفذ 6222، وتتصل العقد الفرعية (Leaf Nodes) على 7422. في بيئة السيرفر الواحد، يجب فتح المنفذ 4222 فقط للخدمات الخلفية، مع إبقاء منفذ المراقبة 8222 داخلياً أو مقيداً عبر UFW لحماية بيانات السيرفر.
النسخ الاحتياطي والصيانة
- انسخ مجلد ./data احتياطياً، حيث يخزن JetStream الرسائل وحالات تسليم المستهلكين وبيانات جداول KV
- استخدم أداة NATS CLI لأخذ نسخ احتياطية حية للتدفقات: nats stream backup <stream_name> <backup_dir>
- احتفظ بنسخة من ملفات التكوين nats-server.conf ومفاتيح NKeys وشهادات TLS
- أتمت النسخ الاحتياطي الدوري لمجلد التخزين وارفعه إلى مساحة تخزين سحابية باستخدام restic أو rsync
- اختبر دورياً استعادة التدفقات في خادم تجريبي باستخدام 'nats stream restore' للتحقق من سلامة البيانات
الأخطاء الشائعة
- التشغيل في بيئة الإنتاج بدون تفعيل المصادقة، مما يتيح لأي شخص على الشبكة قراءة ونشر الرسائل
- نسيان تثبيت مجلد التخزين الدائم لمسار --store_dir، مما يسبب ضياع جميع تدفقات JetStream ومخازن KV عند إعادة تشغيل الحاوية
- فتح منفذ المراقبة 8222 للإنترنت العام دون جدار حماية، مما يكشف عناوين IP وأسماء المواضيع النشطة
- إنشاء تدفقات بدون قيود حفظ (Retention Policy) مما قد يؤدي لامتلاء قرص السيرفر تدريجياً مع تزايد الرسائل
- الخلط بين Core NATS وJetStream: رسائل Core NATS لا تحفظ في الذاكرة أو القرص، ويجب أن يكون المشترك متصلاً لحظة النشر لاستلامها ما لم يُستخدم JetStream
استكشاف الأخطاء وإصلاحها
- فشل اتصال التطبيقات بالمنفذ 4222 — تحقق من عمل الحاوية (docker ps) وافحص المنافذ المستمعة: netstat -tulnp | grep 4222
- خطأ 'JetStream not enabled' — تأكد من احتواء أمر تشغيل الحاوية على وسيط '--jetstream' ومسار التخزين '--store_dir'
- فشل إنشاء التدفق بخطأ 'insufficient storage' — افحص مساحة القرص وصلاحيات الكتابة على مجلد ./data المربوط
- المستهلك لا يستقبل الرسائل القديمة — تأكد من إنشاء المستهلك مع خيار '--deliver all' بدلاً من الافتراضي 'last'
- أخطاء رفض المصادقة — راجع تطابق بيانات الاعتماد في كود التطبيق مع ملف nats-server.conf
البدائل
منصة Apache Kafka هي المعيار في معالجة تدفقات البيانات الضخمة ولكنها تستهلك ذاكرة وموارد كبيرة وتتطلب إدارة معقدة. نظام RabbitMQ وسيط رسائل شهير يدعم بروتوكول AMQP وتوجيهات متقدمة لكنه أبطأ في الأداء. ميزة Redis Streams توفر تدفقاً خفيفاً ولكنها تفتقر لإمكانيات JetStream المتقدمة في تتبع تسليم المستهلكين والتوزيع. منصة Apache Pulsar توفر نظام رسائل سحابي بطبقات تخزين متقدمة ولكن بمعمارية معقدة.
متى لا تستخدمه
تجنب استخدام NATS إذا كان نظامك يعتمد بالكامل على بروتوكول AMQP المعقد وتوجيهات التبادل الخاصة بـ RabbitMQ ومبني بالفعل حوله. وإذا كانت شركتك تعالج بحيرات بيانات بحجم البيتابايت وتعتمد كلياً على تكاملات عميقة مع أنظمة مثل Apache Spark أو Flink، فإن Kafka يوفر بيئة تكاملات أوسع لتلك الحالات. وللتخزين المؤقت البسيط في الذاكرة دون الحاجة للرسائل، فإن Redis كافٍ وبسيط.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما الفرق بين Core NATS وJetStream؟
Core NATS هو نظام نشر واشتراك فوري فائق السرعة يعمل في الذاكرة بدون تخزين دائم، فإذا كان المشترك غير متصل تفوته الرسالة. أما JetStream فهو محرك التخزين الدائم المدمج الذي يحفظ الرسائل على القرص ويتيح إعادة تشغيلها وتتبع استلامها.
ما مدى سرعة NATS مقارنة بـ Kafka أو RabbitMQ؟
NATS مكتوب بلغة Go وبدون أي تبعيات خارجية، ويمكنه معالجة من 10 إلى 18 مليون رسالة في الثانية بزمن تأخير يقل عن جزء من الملي ثانية، وهو أسرع بحوالي 5 إلى 10 مرات من الأنظمة المعتمدة على جافا ويستهلك جزءاً يسيراً من الذاكرة.
ما وظيفة منفذ HTTP 8222؟
يوفر المنفذ 8222 واجهة مراقبة خفيفة ترجع بيانات بصيغة JSON، مثل /varz لمعلومات الخادم و/connz للاتصالات النشطة و/jsz لحالة محرك JetStream لربطها بأنظمة مثل Prometheus.
هل يمكن استخدام NATS كقاعدة بيانات Key-Value؟
نعم، يتضمن NATS JetStream مخزن Key-Value مدمجاً وموزعاً يتيح لك تخزين واسترجاع القيم مع دعم فترات الصلاحية (TTL) وسجل التعديلات ومراقبة التغييرات الفورية دون الحاجة لخادم Redis مستقل.
كم يستهلك NATS Server من الذاكرة العشوائية (RAM)؟
خادم NATS فائق الخفة، حيث يستهلك عادة ما بين 20 إلى 50 ميجابايت فقط من الذاكرة العشوائية في وضع الاستقرار والاستخدام المتوسط.
