تسريع استجابة البيانات باستخدام Redis (اختياري)
تصل البيانات الخارجية التي تستخدمها الاستراتيجية افتراضيًا عبر **الاستعلام الدوري**. عند ربط Redis يستيقظ الوكيل لحظة وصول قيمة جديدة ويعيد قراءتها فورًا. أما القيم نفسها فتأتي دائمًا من استعلام قاعدة البيانات — ولا يمرّ عبر Redis إلا إشارة "وصلت قيمة جديدة".
1. ما هو إعدادك
يجب أن يتمكن الطرف الناشر (المُجمِّع) والطرف المشترك (الوكيل) من الوصول إلى Redis نفسه. أي ترتيب يحقق هذا الشرط يعمل.
كل شيء على جهاز واحد — تثبيت ذاتي (الأبسط، مجاني)
إذا كان المُجمِّع والوكيل على الخادم نفسه، فيكفي تثبيت Redis على ذلك الخادم. لا تمر البيانات عبر الشبكة، لذا فهو الخيار الأسرع، ولا يغادر العنوان الجهاز أبدًا. الإعداد الافتراضي يستمع إلى 127.0.0.1 فقط، لذا لا يكون مكشوفًا للخارج حتى دون كلمة مرور.
sudo apt install -y redis-server sudo systemctl enable --now redis-server redis-cli ping # PONG
redis://127.0.0.1:6379لديك عدة خوادم — شغّله على واحد واربط البقية عبر الشبكة الخاصة
إذا كان المُجمِّع والوكيل على خادمين مختلفين فشغّل Redis على أحدهما فقط ودع البقية تتصل به. وإذا كانا في السحابة نفسها والمنطقة نفسها فالاتصال عبر IP الشبكة الخاصة هو الأكثر أمانًا. ★ إذا فتحت bind على 0.0.0.0 دون كلمة مرور فستكتشفه أدوات المسح على الإنترنت بسرعة. وإذا كان لا بد من المرور عبر الشبكة العامة فطبّق الثلاثة جميعًا: كلمة مرور طويلة + جدار حماية + TLS (rediss://).
# /etc/redis/redis.conf bind 10.0.0.5 127.0.0.1 # ★ 0.0.0.0 금지 requirepass <긴-무작위-비밀번호> # 방화벽: 내 서버 IP 만 6379 허용
redis://:비밀번호@10.0.0.5:6379الشبكات منفصلة — فئة مجانية مُدارة
إذا كان المُجمِّع والوكيل في أماكن لا يصل أحدهما إلى الآخر (سحابات مختلفة، المنزل، المكتب)، فضع Redis مُدارًا بينهما. عمليات الإيقاظ لا تكاد تخزن شيئًا، لذا تكفي الحدود المجانية عادةً.
rediss://…جهة أخرى تنشر — الفرق والمؤسسات ترسل مباشرة
لا يلزم استخدام المُجمِّع الخاص بنا. يمكن لأي برنامج النشر ما دام يلتزم باسم القناة وشكل الحمولة. القناة هي sori:data:v1: متبوعة باسم الجدول (دون المخطط). الحمولة مجرد تلميح للمؤشر — حتى لو وضعت فيها قيمًا فلن تُستخدم؛ إذ يعيد الطرف الذي استيقظ تشغيل استعلامه.
PUBLISH sori:data:v1:fear_greed '{"v":1,"last":1757462400000,"n":1}'2. ترتيب التفعيل — يجب أن تتوافق الأماكن الثلاثة
إذا نقص أي منها فسيعمل النظام بالاستعلام الدوري **دون أي خطأ**. تبقى القيم صحيحة ويطول التأخير فقط، لذا من السهل ألا تلاحظ أن الميزة لم تُفعَّل أصلًا.
جهة النشر — أبلغ المُجمِّع بالعنوان
ينشر المُجمِّع بعد إدراج الصفوف الجديدة. إذا لم يوجد عنوان فإنه يتخطى النشر ويسجّل ذلك في نتيجة التشغيل.
# ~/soritrading-fetchers/.env SORI_WAKE_REDIS_URL=redis://127.0.0.1:6379
جهة الاشتراك — احفظ الخانة في الوكيل
أدخل الاسم المستعار والعنوان في الويب ثم اضغط [اختبار الاتصال]، فيجيب ذلك الجهاز فورًا عمّا إذا كان يتصل فعلًا. يُحفظ العنوان في مخزن المفاتيح على ذلك الجهاز فقط — لا يُرسل إلى الخادم ولا يُسجَّل في السجلات.
الإعلان — حدّد أي جدول يُستمع إليه عبر أي خانة
في أسفل الشاشة نفسها، ضمن [إعلانات مجموعات البيانات]، غيّر الطريقة إلى redis واملأ اسم الخانة واسم الجدول. اسم الجدول مطلوب لأن اسم القناة يُشتق منه.
mode: redis · redisAlias: main · tableName: fear_greed
- Redis للإيقاظ فقط. حتى لو فُقدت رسالة (أثناء إعادة تشغيل الوكيل مثلًا) فإن الاستعلام الدوري التالي يعوّضها، فلا تختل القيم.
- لا يمكن الاشتراك عبر نقطة نهاية REST لدى مزوّدي الخدمات بدون خادم. أدخل عنوان TCP الذي يبدأ بـ redis:// أو rediss://.
- إذا كانت الفئة المجانية تقطع الاتصالات الخاملة فقد يستمر العمل بصمت عبر الاستعلام الدوري فقط. يكتشف الوكيل الانقطاع ويعيد الاتصال، لكن إذا تكرر الانقطاع فهذه الفئة لا تناسب هذا الاستخدام.
- أسماء الخانات والأسماء المستعارة لقواعد البيانات نطاقا أسماء منفصلان. حتى لو كان كلاهما 'main' فإنهما يشيران إلى خادمين مختلفين.
- يُحفظ عنوان الاتصال على جهاز الوكيل فقط. خادمنا ليس في هذا المسار ولا يتلقى العنوان لا عند الحفظ ولا عند القراءة.
- حتى لو حذفت الخانة، فإن الاشتراك المفتوح بالفعل لا ينقطع إلا عند إعادة الاتصال التالية. وحتى ذلك الحين تبقى القيم نفسها، والتأخير أقصر فقط.
كل الوثائق هنا — دليل الاستخدام