⚡ تثبيت Valkey — بديل Redis المفتوح المصدر وفائق السرعة للذاكرة المؤقتة على Docker
نشر محرك Valkey على Ubuntu باستخدام Docker — البديل المباشر ومفتوح المصدر بالكامل لـ Redis المدعوم من مؤسسة Linux Foundation للتخزين بالذاكرة الحية على المنفذ 6381.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/databases/valkey/valkey-ubuntu.sh
chmod +x valkey-ubuntu.sh
sudo bash valkey-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/databases/valkey/valkey-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x valkey-ubuntu.sh
3 تشغيل المثبت
يقوم السكريبت بتثبيت Docker وتجهيز مجلد التخزين الدائم (`./data`) وضبط كلمة المرور وتشغيل حاوية Valkey الرسمية على المنفذ 6381 (المحول من 6379 الداخلي).
sudo bash valkey-ubuntu.sh
4 التحقق من الاتصال وبدء التخزين المؤقت
اتصل عبر الطرفية بأمر `valkey-cli` أو `redis-cli` على المنفذ 6381، وسجل الدخول بكلمة المرور، وابدأ استخدام الكاش فائق السرعة وإدارة الجلسات والرسائل الفورية.
docker exec -it valkey valkey-cli -a <your-password> PING
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 6381 | Valkey RESP protocol (host → container 6379) — never expose publicly |
| ./data | Appendonly persistence files (--appendonly yes) |
نظرة عامة
تعد Valkey قاعدة بيانات وهياكل بيانات بالذاكرة الحية (In-Memory Key-Value Store) مفتوحة المصدر وفائقة الأداء تخضع لإشراف مؤسسة Linux Foundation. تم تأسيسها من قبل المطورين الأساسيين لـ Redis وشركات كبرى (مثل AWS وGoogle Cloud وOracle) كبديل حر ومفتوح المصدر 100% بعد تغيير تراخيص Redis الأصلية لتراخيص تجارية مقيدة. تعمل Valkey عبر المنفذ 6381 باستخدام بروتوكول RESP القياسي، وتدعم كافة هياكل البيانات (النصوص، والقوائم، والـ Hashes، والـ Sets، والجداول المرتبة، والـ Streams) مع دعم سكريبتات Lua والحفظ الدائم بالقرص.
لماذا تستخدمه
يفرض تغيير تراخيص Redis إلى تراخيص مغلقة مخاطر قانونية وقيوداً تجارية على الشركات والمطورين. تضمن لك Valkey برمجية حرة مفتوحة المصدر بنسبة 100% (بترخيص BSD-3-Clause) للأبد تحت إدارة مؤسسة محايدة، مع توافق كامل 100% مع كافة مكتبات وأدوات ومشاريع Redis الحالية، وأداء معالجة أسرع في التعامل مع المدخلات والمخرجات على سيرفرك الخاص.
متى تحتاجه
- تحتاج إلى بديل مفتوح المصدر 100% ومطابق تماماً لـ Redis بدون أي مخاطر تراخيص تجارية
- تريد كاش مؤقت فائق السرعة بزمن استجابة أقل من 1 ميلي ثانية لتسريع استعلامات قواعد البيانات والـ APIs
- تحتاج لتخزين وإدارة جلسات المستخدمين (Sessions) المشتركة لتطبيقات Node.js وبايثون وPHP
- تعتمد على طوابير معالجة المهام الخلفية (مثل Celery وBullMQ وSidekiq) أو البث اللحظي للرسائل (Pub/Sub)
- تريد تحديد معدل الطلبات (Rate Limiting)، أو بناء لوحات الصدارة، أو إدارة حالات الألعاب التفاعلية
من يحتاجه
- مهندسو ومطورو الخلفية لاستبدال قواعد Redis الحالية في بيئات الإنتاج بدون تعديل الأكواد
- مهندسو الـ DevOps لإدارة طوابير المهام الخلفية السريعة والخدمات المصغرة عالية الكثافة
- مديرو قواعد البيانات لتخفيف الضغط الهائل عن قواعد PostgreSQL وMySQL عبر طبقة كاش سريعة
- الشركات الناشئة والمؤسسات الملتزمة بالمعايير الصارمة للبرمجيات مفتوحة المصدر الحرة
- أصحاب السيرفرات المنزلية لتسريع استجابة سحابة Nextcloud ومواقع WordPress وتطبيقاتهم الخاصة
حالات الاستخدام الشائعة
- استبدال Redis في تطبيقك القائم فورياً عبر توجيه رابط `REDIS_URL` إلى `valkey://:password@server-ip:6381`
- تسريع استجابة مواقع WordPress أو Nextcloud بتخزين استعلامات الـ SQL وكاش الـ PHP في Valkey
- تشغيل طوابير معالجة المهام غير المتزامنة مع BullMQ (في Node.js) أو Celery (في بايثون)
- تطبيق حماية الـ Rate Limiting للواجهات البرمجية عبر أوامر الزيادة الذرية `INCR` وتعيين وقت الصلاحية `EXPIRE`
- بناء غرف محادثة وإشعارات فورية تعتمد على بث الرسائل عبر قنوات الـ Pub/Sub وخوادم الـ WebSockets
الميزات الرئيسية
- حر ومفتوح المصدر 100%: تحت مظلة Linux Foundation وبترخيص BSD-3-Clause المرن للأبد
- توافق كامل كبديل لـ Redis على المنفذ 6381: يعمل بسلاسة مع كافة مكتبات وأدوات وعملاء Redis بدون تعديل
- استجابة بالغة السرعة بالذاكرة الحية: تنفيذ أكثر من 100,000 عملية في الثانية لكل نواة معالجة بلغة C
- هياكل بيانات متقدمة ومتنوعة: دعم كامل للنصوص والـ Hashes والـ Sets والجداول المرتبة ومسارات الـ Streams
- حفظ دائم مزدوج على القرص: لقطات RDB الزمنية بالإضافة لسجلات التعديل المستمرة (AOF Logging)
- نظام بث ورسائل متطور (Pub/Sub): دعم قنوات البث الفوري ومجموعات المستهلكين لطوابير المهام
- حماية متقدمة بكلمات المرور والـ ACL: صلاحيات دقيقة على مستوى الأوامر وأنماط المفاتيح
- معمارية Docker Compose تجمع Valkey مع ربط مجلد `./data` لحفظ سجلات وبيانات الكاش على القرص
كيفية الاستخدام بعد التثبيت
- اختبر الاتصال بأداة الطرفية: `redis-cli -h ip-سيرفرك -p 6381 -a كلمة_المرور ping` (يجب أن يعيد `PONG`)
- خزن واسترجع قيمة تجريبية: `SET mykey "Hello Valkey"` ثم `GET mykey`
- حدّث إعدادات الربط في تطبيقك (اضبط `REDIS_HOST=ip-سيرفرك` والمنفذ `6381`)
- اضبط سياسات إفراغ الذاكرة بملف الإعدادات (مثل `maxmemory 512mb` و`maxmemory-policy allkeys-lru`)
- أعد سكريبت نسخ احتياطي دوري لمجلد البيانات `./data`
أفضل ممارسات الأمان
- تنبيه أمني حاسم: عيّن كلمة مرور قوية ومعقدة لخيار `requirepass`؛ فالسيرفرات بدون كلمة مرور تُخترق في دقائق
- لا تكشف منفذ Valkey 6381 للإنترنت العام مباشرة نهائياً
- اقصر الاتصال بالمنفذ 6381 على سيرفرات التطبيقات بالشبكة الداخلية عبر جدار الحماية (`ufw allow from 192.168.1.0/24`)
- أعد تسمية أو عطّل الأوامر الخطيرة بملف الإعدادات (مثل `FLUSHALL` و`CONFIG` و`KEYS`)
- احمِ مجلد البيانات `./data` بصلاحيات نظام صارمة بالسيرفر (`chmod 700`)
- حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وإصلاحات الأداء
المنافذ وإعدادات جدار الحماية
يتواصل Valkey عبر منفذ TCP 6381 (المحول من 6379 الداخلي باستخدام بروتوكول RESP؛ ولا يحتوي على واجهة ويب). اسمح بالمنفذ 6381 فقط للشبكة المحلية الموثوقة (`ufw allow from 192.168.1.0/24 to any port 6381`). وتجنب فتح المنفذ للإنترنت العام تماماً.
النسخ الاحتياطي والصيانة
- انسخ مجلد `./data` احتياطياً، والذي يحتوي على لقطة القرص `dump.rdb` وسجلات الـ AOF في `appendonlydir`
- استخرج لقطة فورية قبل إجراء الصيانة بأمر: `redis-cli -p 6381 -a كلمة_المرور BGSAVE`
- احتفظ بنسخة من ملف `docker-compose.yml` وملف المتغيرات `.env`
- أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
- اختبر الاستعادة بنسخ ملف `dump.rdb` بحاوية تجريبية والتأكد من استرجاع المفاتيح بنجاح
الأخطاء الشائعة
- تشغيل Valkey بدون تعيين كلمة مرور قوية مما يعرض السيرفر للاختراق الفوري واستغلاله في التعدين
- كشف المنفذ 6381 للإنترنت العام مباشرة دون تقييد جدار الحماية
- نسيان ضبط حد أقصى للذاكرة `maxmemory` مما يسبب استهلاك السيرفر لكامل الرام وتوقف الخدمات
- عدم ربط مجلد التخزين الدائم `./data`، مما يسبب فقدان الجلسات والمفاتيح عند إعادة تشغيل الحاوية
- استخدام أمر `KEYS *` الثقيل في كود الإنتاج بدلاً من أمر `SCAN` غير الحاجب للمعالجة
استكشاف الأخطاء وإصلاحها
- رفض الاتصال بالمنفذ 6381 — تأكد من عمل الحاوية بالأمر `docker compose ps` وافحص السجلات: `docker logs valkey -f`
- خطأ المصادقة (NOAUTH Authentication required) — تأكد من تمرير كلمة المرور المضبوطة في `requirepass`
- أخطاء نفاد الذاكرة (OOM) — اضبط `maxmemory 1gb` وسياسة الإفراغ `allkeys-lru` في ملف الإعدادات
- تلف سجلات الـ AOF بعد إغلاق مفاجئ — أصلح السجل بأمر: `valkey-check-aof --fix ./data/appendonlydir/*`
- أوامر بطيئة تحجب المعالجة — افحص الأوامر البطيئة بأمر: `SLOWLOG GET 10`
البدائل
محرك Redis الأصلي (الذي أصبح بتراخيص تجارية). محرك KeyDB متعدد الخيوط. محرك Dragonfly عالي الكثافة للعتاد الضخم. نظام Memcached الكلاسيكي للكاش البسيط. منصة Apache Ignite للحوسبة بالذاكرة.
متى لا تستخدمه
تجنب استخدام Valkey كقاعدة بيانات رئيسية دائمة للمعاملات المالية المعقدة والـ SQL JOINs (حيث صُممت PostgreSQL أو MySQL للتخزين الأساسي، بينما يعمل Valkey ككاش وطوابير مهام). وإذا كنت تحتاج حصراً لقاعدة مستندات NoSQL مع هيكلة وثائق مرنة، فإن MongoDB أو PostgreSQL JSONB أكثر ملاءمة.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هو محرك Valkey ولماذا تم إنشاؤه؟
تعد Valkey قاعدة بيانات بالذاكرة الحية مفتوحة المصدر تم إنشاؤها تحت مظلة Linux Foundation بواسطة مجتمع المطورين وكبرى شركات السحابة كبديل حر ومفتوح المصدر 100% لـ Redis بعد تحول الأخير لتراخيص تجارية في 2024.
هل يتوافق Valkey تماماً مع مكتبات وتطبيقات Redis الحالية؟
نعم! يتوافق Valkey بنسبة 100% مع بروتوكول Redis 7.2. ويمكنك استخدام كافة مكتبات وعملاء Redis في Node.js وبايثون وPHP وGo وجافا دون أي تعديل في كود تطبيقك البرمجي.
هل يحفظ Valkey البيانات على القرص عند إعادة تشغيل الحاوية؟
نعم! بفضل ربط مجلد التخزين الدائم `./data` وتفعيل خيار `--appendonly yes`، يسجل Valkey كافة عمليات التعديل على القرص الصلب لضمان بقاء البيانات بعد إعادة التشغيل.
ما الفرق بين Valkey ومحرك Memcached؟
يقدم Memcached كاشاً بسيطاً للنصوص فقط بدون حفظ بالقرص. بينما تدعم Valkey هياكل بيانات معقدة (قوائم، جداول مرتبة، مجموعات، مسارات)، والحفظ الدائم بالقرص، وبث الرسائل Pub/Sub، وسكريبتات Lua.
كم يستهلك Valkey من الذاكرة العشوائية (RAM)؟
يتميز Valkey بحجم أساسي ضئيل للغاية يبلغ حوالي 15 إلى 30 ميجابايت فقط داخل Docker، ويتناسب إجمالي استهلاك الرام مباشرة مع كمية البيانات والمفاتيح المخزنة فيه.