ما هو application.yaml في MagicTradeBot؟

ما هو ملف application.yaml؟

application.yaml هو ملف التكوين الأساسي الذي يتحكم في كيفية بدء تشغيل MagicTradeBot، واتصاله بمنصات التداول، وتعريف نفسه، وتشغيله على مستوى النظام.

اعتقد أنه بمثابة تكوين الإقلاع لـ MagicTradeBot — قبل تشغيل أي استراتيجية أو مراقبة السوق أو منطق محرك القرار، يقرأ البوت هذا الملف ليفهم:

  • أي منصة تداول يتصل بها
  • كيفية المصادقة بشكل آمن
  • ما إذا كان يجب تشغيله في وضع العرض التوضيحي أم المباشر
  • أي ترخيص يستخدم
  • السلوك الأساسي لوقت التشغيل (التصحيح، التسمية، البيئة)

بدون ملف application.yaml صالح، لا يمكن لـ MagicTradeBot التهيئة أو العمل بشكل صحيح.

ماذا يتحكم application.yaml؟

ملف application.yaml مسؤول عن الإعدادات العامة غير المرتبطة بالاستراتيجية، بما في ذلك:

  • اختيار منصة التداول وقواعد التوافق
  • مصادقة API (أو تعيين متغيرات البيئة)
  • التحقق من صحة الترخيص
  • هوية البوت وإشارات وقت التشغيل
  • سلوك الأمان والنشر

لا يحدد:

  • استراتيجيات التداول
  • قواعد وقف الخسارة / جني الأرباح
  • منطق مراقبة السوق
  • قواعد قرار DCA أو الدماغ

يتم التعامل مع هذه في ملفات تكوين منفصلة خاصة بالميزات، مما يحافظ على المسؤوليات نظيفة ومعيارية.

شرح الأقسام الرئيسية

1. تكوين منصة التداول

يخبر هذا القسم MagicTradeBot بمنصة التداول التي يجب الاتصال بها وكيف.

المسؤوليات الرئيسية:

  • يختار منصة التداول (binance, bybit, okx, bitget, hyperliquid)
  • يفرض توافق وضع المركز الخاص بمنصة التداول
  • يقوم بتحميل بيانات اعتماد API بأمان

يقوم MagicTradeBot بإجراء تحقق صارم هنا لمنع:

  • أوضاع مركز غير صحيحة (مثل Hedge مقابل One-Way)
  • فشل تنفيذ الأوامر
  • حسابات PnL غير صحيحة
  • عدم تطابق إدارة المخاطر

إذا تم تكوين منصة تداول غير مدعومة، سيرفض البوت العمل.

2. بيانات اعتماد API والأمان

يدعم application.yaml طريقتين آمنتين لبيانات الاعتماد:

الخيار أ: YAML مباشر (موصى به فقط للعرض التوضيحي/الاختبار)

APIKEY: ""
APISECRET: ""
Passphrase: ""

الخيار ب: متغيرات البيئة (موصى به للإنتاج)

تقوم متغيرات البيئة تلقائيًا بتجاوز قيم YAML.

هذا التصميم:

  • يمنع التعرض العرضي للمفاتيح
  • يعمل بسلاسة مع Docker و VPS والنشر السحابي
  • يتوافق مع أفضل ممارسات الأمان للمؤسسات

لا يتطلب MagicTradeBot أبدًا أذونات السحب ويحذر صراحةً منها.

3. توافق وضع المركز (حرج)

تدعم منصات التداول المختلفة أوضاع مركز مختلفة، ويفرض MagicTradeBot ذلك عند بدء التشغيل.

أمثلة:

  • Bybit → وضع One-Way فقط
  • Binance / OKX / Bitget → وضع Hedge مطلوب

إذا تم تكوين حساب منصة التداول الخاص بك بشكل خاطئ:

  • قد يتم رفض الأوامر
  • قد يفشل TP/SL
  • قد يتم إغلاق المراكز بشكل غير صحيح

يوجد هذا التحقق لحماية رأس المال وضمان سلوك حتمي.

4. تكوين الترخيص

يقوم قسم الترخيص بتنشيط تثبيت MagicTradeBot الخاص بك.

License:
  Key: ""

الترخيص:

  • يفتح الميزات بناءً على خطتك
  • يتحكم في تفويض المثيل
  • يتم التحقق من صحته أثناء بدء التشغيل

بدون مفتاح ترخيص صالح، لن يدخل البوت في وضع التشغيل.

5. إعدادات التطبيق العامة

يتحكم هذا القسم في كيفية تصرف البوت في وقت التشغيل — وليس كيفية تداوله.

الخيارات الرئيسية:

  • BotName – يساعد في تحديد هذا المثيل في السجلات ولوحات المعلومات والتنبيهات
  • DemoMode – يمكن التداول المحاكي دون أموال حقيقية
  • DebugMode – يمكن التسجيل التفصيلي للتشخيص

هذه الإعدادات مفيدة بشكل خاص عند تشغيل:

  • عدة مثيلات بوت
  • بيئات التدريج مقابل الإنتاج
  • تحقيقات التصحيح أو الدعم

وضع العرض التوضيحي مقابل الوضع المباشر

واحدة من أهم الإشارات في application.yaml هي:

DemoMode: true
  • DemoMode = true → لا يتم وضع أوامر حقيقية
  • DemoMode = false → التداول المباشر مفعل

يسمح هذا للمستخدمين بـ:

  • اختبار التكوينات بأمان
  • التحقق من صحة الاستراتيجيات قبل المخاطرة برأس المال
  • تشغيل البوت في المحاكاة على بيانات السوق الحقيقية

لماذا يستخدم MagicTradeBot application.yaml

يستخدم MagicTradeBot application.yaml لأنه يوفر:

  • هيكل يمكن قراءته بواسطة الإنسان
  • فصل قوي للاهتمامات
  • إعدادات افتراضية آمنة للمستخدمين الجدد
  • أتمتة سهلة عبر متغيرات البيئة
  • التوافق مع Docker والسحابة والنشر المحلي

الأهم من ذلك، أنه يضمن سلوك بدء تشغيل يمكن التنبؤ به، وهو أمر ضروري لنظام تداول آلي.

أفضل الممارسات

  • ✔ استخدم متغيرات البيئة لمفاتيح API في الإنتاج
  • ✔ أبق DemoMode مفعلًا أثناء الاختبار
  • ✔ تحقق مرة أخرى من وضع مركز منصة التداول قبل التداول المباشر
  • ✔ لا تقم أبدًا بتمكين أذونات السحب على مفاتيح API
  • ✔ تعامل مع application.yaml كتكوين بنية تحتية، وليس تكوين استراتيجية

ملخص

application.yaml هو أساس بيئة تشغيل MagicTradeBot.

يحدد:

  • أين يتصل البوت
  • كيف يتحقق من هويته
  • ما إذا كان يتداول بشكل مباشر أم في وضع العرض التوضيحي
  • أي ترخيص نشط
  • مدى أمان تشغيله

جميع الذكاءات المتقدمة — مثل Smart SL/TP و Market Watch و DCA ودماغ MagicTradeBot — مبنية فوق هذا الملف، مما يجعله أحد أهم المكونات في النظام بأكمله.

📎 Related Topics