Konfiguracja cTrader CLI¶

W tym artykule opisano instalację cTrader CLI, tworzenie pliku z danymi uwierzytelniającymi oraz sprawdzanie połączenia w systemach Windows, macOS i Linux, z terminala lub kontenera Docker.

Wymagania wstępne ¶

• cTrader ID z co najmniej jednym kontem handlowym.
• Obsługiwany menedżer pakietów: WinGet w systemie Windows lub Homebrew w systemach macOS i Linux.
• W przypadku cBotów wymagany jest .NET 8. Przed uruchomieniem starszych cBotów przez cTrader CLI skompiluj je ponownie w najnowszej wersji aplikacji komputerowej cTrader.
• Do korzystania z umiejętności wymagany jest Node.js w wersji 22.20.0 lub nowszej.

Instalacja za pomocą menedżera pakietów ¶

Zalecaną metodą jest instalacja przez menedżer pakietów. Menedżer pobiera wersję odpowiednią dla Twojego systemu operacyjnego i dodaje polecenie ctrader-cli do zmiennej PATH, dzięki czemu możesz uruchamiać je z dowolnego folderu.

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

Instalacja z obrazu Docker ¶

cTrader CLI jest udostępniany jako obraz Docker dla Linuksa, który ułatwia hostowanie cBotów na VPS z Linuksem, serwerze o dużej wydajności lub platformie chmurowej. Obraz działa również w systemie Windows przez Docker Desktop z WSL.

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

Instrukcja uruchamiania cBota pokazuje, jak montować foldery hosta i przekazywać konfigurację przez zmienne środowiskowe.

Instalacja ręczna w systemie Windows ¶

Jeśli nie chcesz używać menedżera pakietów w systemie Windows, plik wykonywalny ctrader-cli znajdziesz w aplikacji komputerowej cTrader. Zwykle znajduje się on w lokalizacji:

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

Aby uruchamiać cTrader CLI z dowolnego folderu, dodaj ten katalog do zmiennej PATH:

1. Skopiuj ścieżkę do folderu zawierającego ctrader-cli.
2. W menu Start systemu Windows wyszukaj Zmienne środowiskowe, a następnie wybierz Edytuj zmienne środowiskowe systemu.
3. W oknie Właściwości systemu wybierz Zmienne środowiskowe.
4. W sekcji Zmienne użytkownika kliknij dwukrotnie Path.
5. Wybierz Nowy, wklej skopiowaną ścieżkę, a następnie kliknij OK w każdym oknie dialogowym, aby zapisać zmiany.

Sprawdzanie instalacji ¶

Po instalacji sprawdź, czy cTrader CLI jest dostępny. Żadne z tych dwóch poleceń nie wymaga logowania.

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

Jeśli terminal zgłasza, że nie znaleziono polecenia, zamknij go i otwórz ponownie, aby wczytać zaktualizowaną zmienną PATH, a następnie spróbuj jeszcze raz.

Tworzenie pliku z danymi uwierzytelniającymi ¶

Większość poleceń dotyczy konta, dlatego wymaga trzech wartości: cTrader ID, hasła i numeru konta.

Ze względów bezpieczeństwa nie wpisuj hasła cTrader ID bezpośrednio w poleceniu. Zapisz hasło w pliku i wskaż ten plik za pomocą --pwd-file.

1. Otwórz edytor zwykłego tekstu, np. Notatnik.
2. Wpisz hasło cTrader ID w jednym wierszu, bez spacji na początku ani na końcu.
3. Zapisz plik z rozszerzeniem .pwd lub .txt, np. password.pwd.
4. Wskaż plik w poleceniu: --pwd-file=C:/test/password.pwd.

Po przygotowaniu pliku z danymi uwierzytelniającymi przekaż go do poleceń, korzystając z jednego z dwóch trybów uwierzytelniania.

Przykład uruchomienia w Dockerze ¶

W kontenerze ścieżki hosta są mapowane za pomocą --mount, a wartości konfiguracyjne przekazywane przez -e. Krótki przykład uruchomienia cBota w kontenerze:

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

Pełną instrukcję dotyczącą Dockera, wraz z opisem działania poszczególnych opcji, znajdziesz w artykule o tym, jak uruchamiać i zarządzać cBotami.