ตั้งค่า 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 image ¶

cTrader CLI มีให้ใช้งานในรูปแบบ Docker image สำหรับ Linux ซึ่งเหมาะกับการโฮสต์ cBot บน Linux VPS เซิร์ฟเวอร์ประสิทธิภาพสูง หรือแพลตฟอร์มคลาวด์ image นี้ยังทำงานบน 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