إعداد cTrader CLI¶

تشرح هذه المقالة كيفية تثبيت cTrader CLI وإنشاء ملف بيانات الاعتماد والتحقق من الاتصال على Windows أو macOS أو Linux، سواء عبر الطرفية أو حاوية Docker.

المتطلبات المسبقة ¶

• cTrader ID مرتبط بحساب تداول واحد على الأقل.
• مدير حزم مدعوم: WinGet على Windows، أو Homebrew على macOS وLinux.
• بالنسبة إلى روبوتات cBot، يلزم .NET 8. أعِد تجميع روبوتات cBot القديمة في أحدث إصدار من تطبيق cTrader لسطح المكتب قبل تشغيلها باستخدام cTrader CLI.
• لاستخدام المهارات، يلزم توفر Node.js بالإصدار 22.20.0 أو أحدث.

التثبيت باستخدام مدير حزم ¶

التثبيت عبر مدير حزم هو الطريقة الموصى بها. ينزّل مدير الحزم الإصدار المناسب لنظام التشغيل ويضيف الأمر ctrader-cli إلى متغير PATH حتى تتمكن من تشغيله من أي مجلد.

winget install Spotware.cTrader.CLI

brew tap spotware/tap https://github.com/spotware/homebrew-tap
brew install spotware/tap/ctrader-cli

brew tap spotware/tap https://github.com/spotware/homebrew-tap
brew install spotware/tap/ctrader-cli

التثبيت باستخدام صورة Docker ¶

يتوفر cTrader CLI في صورة Docker لنظام Linux، وهي مناسبة لاستضافة روبوتات cBot على خادم VPS بنظام Linux أو خادم عالي الأداء أو منصة سحابية. تعمل الصورة أيضًا على Windows عبر Docker Desktop مع WSL.

docker pull ghcr.io/spotware/ctrader-console:latest

يوضح دليل تشغيل روبوت cBot كيفية ربط مجلدات الجهاز المضيف وتمرير إعدادات التكوين عبر متغيرات البيئة.

التثبيت اليدوي على Windows ¶

إذا كنت تفضّل عدم استخدام مدير حزم على Windows، فإن الملف التنفيذي ctrader-cli مضمّن في تطبيق cTrader لسطح المكتب. يوجد عادةً في المسار التالي:

C:\Users\{username}\AppData\Local\Spotware\cTrader\{installationId}

لتشغيل cTrader CLI من أي مجلد، أضف هذا الدليل إلى PATH:

1. انسخ مسار المجلد الذي يحتوي على ctrader-cli.
2. ابحث عن متغيرات البيئة في قائمة ابدأ على Windows، ثم اختر تحرير متغيرات بيئة النظام.
3. في نافذة خصائص النظام، اختر متغيرات البيئة.
4. ضمن متغيرات المستخدم، انقر نقرًا مزدوجًا على Path.
5. اختر جديد، والصق المسار المنسوخ، ثم اختر موافق في كل مربع حوار لحفظ التغييرات.

التحقق من التثبيت ¶

بعد التثبيت، تأكد من توفر cTrader CLI. لا يتطلب أيٌّ من الأمرين تسجيل الدخول.

ctrader-cli --version
ctrader-cli --help

إذا أظهرت الطرفية رسالة تفيد بعدم العثور على الأمر، فأغلقها وأعد فتحها لتطبيق التحديث على PATH، ثم حاول مجددًا.

إنشاء ملف بيانات الاعتماد ¶

تعمل معظم الأوامر على حساب تداول، لذا تحتاج إلى ثلاث قيم: cTrader ID وكلمة مرور ورقم حساب.

لأسباب أمنية، لا تُدخل كلمة مرور cTrader ID مباشرةً في أي أمر. احفظها في ملف وحدّد هذا الملف باستخدام --pwd-file.

1. افتح محرر نصوص عادية، مثل Notepad.
2. اكتب كلمة مرور cTrader ID في سطر واحد دون مسافات في بدايته أو نهايته.
3. احفظ الملف بالامتداد .pwd أو .txt، مثل password.pwd.
4. حدّد الملف في أمرك: --pwd-file=C:/test/password.pwd.

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

مثال على التشغيل باستخدام Docker ¶

داخل الحاوية، تُربط مسارات الجهاز المضيف باستخدام --mount، وتُمرّر قيم التكوين باستخدام -e. مثال مختصر على بدء تشغيل روبوت cBot داخل حاوية:

docker run -d -it \
  --name ctrader.console.run.mybot \
  --mount type=bind,src=/cAlgo/Robots,dst=/mnt/Robots \
  -e CTID='mycid' \
  -e PWD-FILE='/mnt/Robots/ctrader-cli.pwd' \
  -e ACCOUNT='9102302' \
  -e SYMBOL='EURUSD' \
  -e PERIOD='H1' \
  ghcr.io/spotware/ctrader-console:latest run "/mnt/Robots/My bot.algo" --environment-variables

للاطلاع على دليل Docker الكامل، بما في ذلك كيفية ربط كل خيار، راجع كيفية تشغيل روبوتات cBot وإدارتها.