Menyediakan cTrader CLI¶

Artikel ini menerangkan cara memasang cTrader CLI, menyediakan fail kelayakan dan mengesahkan sambungan pada Windows, macOS atau Linux, melalui terminal atau kontena Docker.

Prasyarat ¶

• cTrader ID dengan sekurang-kurangnya satu akaun dagangan.
• Pengurus pakej yang disokong: WinGet pada Windows serta Homebrew pada macOS dan Linux.
• Untuk cBot, .NET 8 diperlukan. Kompil semula cBot lama dalam versi terkini aplikasi desktop cTrader sebelum menjalankannya melalui cTrader CLI.
• Untuk menggunakan kemahiran, anda memerlukan Node.js versi 22.20.0 atau lebih baharu.

Pasang menggunakan pengurus pakej ¶

Pemasangan melalui pengurus pakej ialah kaedah yang disyorkan. Pengurus pakej memuat turun binaan yang sesuai dengan sistem pengendalian anda dan menambahkan perintah ctrader-cli pada PATH, supaya anda boleh menjalankannya dari mana-mana folder.

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

Pasang menggunakan imej Docker ¶

cTrader CLI diterbitkan sebagai imej Docker untuk Linux, yang memudahkan pengehosan cBot pada VPS Linux, pelayan berprestasi tinggi atau platform awan. Imej ini juga boleh dijalankan pada Windows melalui Docker Desktop dengan WSL.

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

Panduan menjalankan cBot menerangkan cara melekapkan folder hos dan menghantar konfigurasi melalui pemboleh ubah persekitaran.

Pasang secara manual pada Windows ¶

Jika anda tidak mahu menggunakan pengurus pakej pada Windows, fail boleh laksana ctrader-cli sudah disertakan dalam aplikasi desktop cTrader. Fail tersebut biasanya terletak di:

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

Untuk menjalankan cTrader CLI dari mana-mana folder, tambahkan direktori ini pada PATH:

1. Salin laluan folder yang mengandungi ctrader-cli.
2. Dalam menu Mula Windows, cari Pemboleh ubah persekitaran, kemudian pilih Edit pemboleh ubah persekitaran sistem.
3. Dalam tetingkap Sifat Sistem, pilih Pemboleh Ubah Persekitaran.
4. Di bawah Pemboleh ubah pengguna, klik dua kali Path.
5. Pilih Baharu, tampal laluan yang disalin, kemudian pilih OK dalam setiap kotak dialog untuk menyimpan.

Sahkan pemasangan ¶

Selepas pemasangan, pastikan cTrader CLI boleh digunakan. Kedua-dua perintah tidak memerlukan anda log masuk.

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

Jika terminal melaporkan bahawa perintah tidak ditemui, tutup dan buka semula terminal supaya PATH yang dikemas kini digunakan, kemudian cuba lagi.

Cipta fail kelayakan ¶

Kebanyakan perintah beroperasi pada akaun, jadi tiga nilai diperlukan: cTrader ID, kata laluan dan nombor akaun.

Atas sebab keselamatan, jangan taip kata laluan cTrader ID anda terus dalam perintah. Simpan kata laluan dalam fail dan gunakan --pwd-file untuk merujuk kepada fail itu.

1. Buka penyunting teks biasa, seperti Notepad.
2. Taip kata laluan cTrader ID pada satu baris, tanpa ruang kosong di awal atau akhir.
3. Simpan fail dengan sambungan .pwd atau .txt, contohnya password.pwd.
4. Rujuk fail dalam perintah anda: --pwd-file=C:/test/password.pwd.

Setelah fail kelayakan disediakan, hantarkannya kepada perintah menggunakan salah satu daripada dua kaedah pengesahan.

Contoh menjalankan Docker ¶

Di dalam kontena, laluan hos dilekapkan ke dalam kontena melalui --mount, manakala nilai konfigurasi dihantar melalui -e. Contoh ringkas untuk memulakan cBot dalam kontena:

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

Untuk panduan Docker yang lengkap, termasuk cara setiap pilihan dipetakan, lihat cara menjalankan dan mengurus cBot.