← العودة إلى دليل الاستخدام
الإيقاظ اللحظي

تسريع استجابة البيانات باستخدام Redis (اختياري)

تصل البيانات الخارجية التي تستخدمها الاستراتيجية افتراضيًا عبر **الاستعلام الدوري**. عند ربط Redis يستيقظ الوكيل لحظة وصول قيمة جديدة ويعيد قراءتها فورًا. أما القيم نفسها فتأتي دائمًا من استعلام قاعدة البيانات — ولا يمرّ عبر Redis إلا إشارة "وصلت قيمة جديدة".

أولًا: قد لا تحتاج إلى هذا — بياناتك صحيحة حتى دون Redis. الفرق الوحيد هو زمن التأخير. للمؤشرات اليومية أو الساعية يكفي الاستعلام الدوري؛ لا تحتاج هذه الصفحة إلا إذا كان على الاستراتيجية أن تستجيب خلال ثوانٍ. الإشارة الفائتة يلتقطها الاستعلام الدوري التالي.

1. ما هو إعدادك

يجب أن يتمكن الطرف الناشر (المُجمِّع) والطرف المشترك (الوكيل) من الوصول إلى Redis نفسه. أي ترتيب يحقق هذا الشرط يعمل.

A

كل شيء على جهاز واحد — تثبيت ذاتي (الأبسط، مجاني)

إذا كان المُجمِّع والوكيل على الخادم نفسه، فيكفي تثبيت 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
B

لديك عدة خوادم — شغّله على واحد واربط البقية عبر الشبكة الخاصة

إذا كان المُجمِّع والوكيل على خادمين مختلفين فشغّل 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
C

الشبكات منفصلة — فئة مجانية مُدارة

إذا كان المُجمِّع والوكيل في أماكن لا يصل أحدهما إلى الآخر (سحابات مختلفة، المنزل، المكتب)، فضع Redis مُدارًا بينهما. عمليات الإيقاظ لا تكاد تخزن شيئًا، لذا تكفي الحدود المجانية عادةً.

العنوان الذي يوضع في الخانة:rediss://…
تم التحقق في سبتمبر 2026 — قد يغيّر المزوّدون الحدود، فتحقق مجددًا من الرابط.
Upstash256MB · 월 50만 명령يمكن البدء دون بطاقة. حتى النشر مرة كل دقيقة يعادل 40–50 ألف أمر شهريًا، وهذا هامش واسع. لكن حد الاتصالات المتزامنة غير معلن، ولا يعمل SUBSCRIBE إلا عبر عنوان TCP (redis://) وليس REST.
Aiven1GB · 단일 노드مبني على Valkey (نسخة متفرعة متوافقة مع Redis). ولأن pub/sub ميزة أساسية فلا يتأثر استخدام الإيقاظ.
Redis Cloud30MBتبدو السعة صغيرة، لكن الإيقاظ لا يستخدم التخزين، لذا فإن 30MB كافية.
D

جهة أخرى تنشر — الفرق والمؤسسات ترسل مباشرة

لا يلزم استخدام المُجمِّع الخاص بنا. يمكن لأي برنامج النشر ما دام يلتزم باسم القناة وشكل الحمولة. القناة هي sori:data:v1: متبوعة باسم الجدول (دون المخطط). الحمولة مجرد تلميح للمؤشر — حتى لو وضعت فيها قيمًا فلن تُستخدم؛ إذ يعيد الطرف الذي استيقظ تشغيل استعلامه.

PUBLISH sori:data:v1:fear_greed '{"v":1,"last":1757462400000,"n":1}'

2. ترتيب التفعيل — يجب أن تتوافق الأماكن الثلاثة

إذا نقص أي منها فسيعمل النظام بالاستعلام الدوري **دون أي خطأ**. تبقى القيم صحيحة ويطول التأخير فقط، لذا من السهل ألا تلاحظ أن الميزة لم تُفعَّل أصلًا.

1

جهة النشر — أبلغ المُجمِّع بالعنوان

ينشر المُجمِّع بعد إدراج الصفوف الجديدة. إذا لم يوجد عنوان فإنه يتخطى النشر ويسجّل ذلك في نتيجة التشغيل.

# ~/soritrading-fetchers/.env
SORI_WAKE_REDIS_URL=redis://127.0.0.1:6379
2

جهة الاشتراك — احفظ الخانة في الوكيل

أدخل الاسم المستعار والعنوان في الويب ثم اضغط [اختبار الاتصال]، فيجيب ذلك الجهاز فورًا عمّا إذا كان يتصل فعلًا. يُحفظ العنوان في مخزن المفاتيح على ذلك الجهاز فقط — لا يُرسل إلى الخادم ولا يُسجَّل في السجلات.

3

الإعلان — حدّد أي جدول يُستمع إليه عبر أي خانة

في أسفل الشاشة نفسها، ضمن [إعلانات مجموعات البيانات]، غيّر الطريقة إلى redis واملأ اسم الخانة واسم الجدول. اسم الجدول مطلوب لأن اسم القناة يُشتق منه.

mode: redis   ·   redisAlias: main   ·   tableName: fear_greed
التحقق من التفعيل — إذا أظهرت الشارة بجانب الإعلان 'لحظي · Redis(الاسم المستعار)' فهي مفعّلة. وإذا ظهرت 'استعلام دوري' فيُكتب في الموضع نفسه سبب ما ينقص.
ما يجب معرفته
  • Redis للإيقاظ فقط. حتى لو فُقدت رسالة (أثناء إعادة تشغيل الوكيل مثلًا) فإن الاستعلام الدوري التالي يعوّضها، فلا تختل القيم.
  • لا يمكن الاشتراك عبر نقطة نهاية REST لدى مزوّدي الخدمات بدون خادم. أدخل عنوان TCP الذي يبدأ بـ redis:// أو rediss://.
  • إذا كانت الفئة المجانية تقطع الاتصالات الخاملة فقد يستمر العمل بصمت عبر الاستعلام الدوري فقط. يكتشف الوكيل الانقطاع ويعيد الاتصال، لكن إذا تكرر الانقطاع فهذه الفئة لا تناسب هذا الاستخدام.
  • أسماء الخانات والأسماء المستعارة لقواعد البيانات نطاقا أسماء منفصلان. حتى لو كان كلاهما 'main' فإنهما يشيران إلى خادمين مختلفين.
  • يُحفظ عنوان الاتصال على جهاز الوكيل فقط. خادمنا ليس في هذا المسار ولا يتلقى العنوان لا عند الحفظ ولا عند القراءة.
  • حتى لو حذفت الخانة، فإن الاشتراك المفتوح بالفعل لا ينقطع إلا عند إعادة الاتصال التالية. وحتى ذلك الحين تبقى القيم نفسها، والتأخير أقصر فقط.
أدلة أخرى

كل الوثائق هنا — دليل الاستخدام