cTrader CLI 설정¶

이 문서에서는 Windows, macOS 또는 Linux에서 cTrader CLI를 설치하고, 인증 정보 파일을 생성하고, 터미널이나 Docker 컨테이너에서 연결을 확인하는 방법을 설명합니다.

사전 요구 사항 ¶

하나 이상의 거래 계정이 연결된 cTrader ID.
지원되는 패키지 관리자: Windows의 WinGet, macOS와 Linux의 Homebrew.
cBot을 사용하려면 .NET 8이 필요합니다. 이전 버전의 cBot은 cTrader CLI에서 실행하기 전에 최신 cTrader 데스크톱 애플리케이션에서 다시 컴파일하세요.
스킬을 사용하려면 Node.js 22.20.0 이상이 필요합니다.

패키지 관리자로 설치 ¶

패키지 관리자를 통한 설치를 권장합니다. 운영체제에 맞는 빌드를 다운로드하고 ctrader-cli 명령어를 PATH에 추가하므로 어느 폴더에서나 실행할 수 있습니다.

WindowsmacOSLinux

Windows PowerShell을 관리자 권한으로 열고 다음 명령어를 실행하세요:

winget install Spotware.cTrader.CLI

터미널을 열고 다음 명령어를 실행하세요:

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

Homebrew가 설치되지 않은 경우 먼저 Homebrew 웹사이트의 안내에 따라 설치하세요.

터미널을 열고 다음 명령어를 실행하세요:

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

Homebrew가 설치되지 않은 경우 먼저 Homebrew 웹사이트의 안내에 따라 설치하세요.

경고

위에 안내된 Spotware의 공식 패키지 식별자로만 cTrader CLI를 설치하세요. 확인되지 않은 출처에서 설치하면 인증 정보와 자금이 위험에 노출될 수 있습니다.

Docker 이미지로 설치 ¶

cTrader CLI는 Linux용 Docker 이미지로 제공되며, Linux VPS, 고성능 서버 또는 클라우드 플랫폼에서 cBot을 호스팅할 때 편리합니다. 이 이미지는 WSL을 사용하는 Docker Desktop을 통해 Windows에서도 실행할 수 있습니다.

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

cBot 실행 가이드에서는 호스트 폴더를 마운트하고 환경 변수를 통해 설정을 전달하는 방법을 설명합니다.

팁

cTrader CLI는 cTrader 데스크톱 애플리케이션에 포함되어 있어 별도 설치 없이 외부 프로세스에서 cBot을 시작할 수 있습니다.

Windows에서 수동 설치 ¶

Windows에서 패키지 관리자를 사용하지 않으려면 cTrader 데스크톱 애플리케이션에 포함된 ctrader-cli 실행 파일을 사용할 수 있습니다. 일반적으로 다음 위치에 있습니다:

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

어느 폴더에서나 cTrader CLI를 실행하려면 이 디렉터리를 PATH에 추가하세요:

ctrader-cli가 있는 폴더의 경로를 복사하세요.
Windows 시작 메뉴에서 환경 변수를 검색한 다음 시스템 환경 변수 편집을 선택하세요.
시스템 속성 창에서 환경 변수를 선택하세요.
사용자 변수에서 Path를 두 번 클릭하세요.
새로 만들기를 선택해 복사한 경로를 붙여넣고 각 대화 상자에서 확인을 클릭하여 저장하세요.

참고

폴더를 PATH에 추가하면 어느 위치에서나 ctrader-cli 뒤에 원하는 명령어를 입력해 실행할 수 있습니다.

설치 확인 ¶

설치 후 cTrader CLI를 사용할 수 있는지 확인하세요. 두 명령어 모두 로그인할 필요가 없습니다.

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

터미널에서 명령어를 찾을 수 없다고 표시되면 터미널을 닫았다가 다시 열어 업데이트된 PATH를 적용한 후 다시 시도하세요.

인증 정보 파일 생성 ¶

대부분의 명령어는 계정을 대상으로 실행되므로 cTrader ID, 비밀번호, 계정 번호의 세 가지 값이 필요합니다.

항목	옵션	설명
cTrader ID	`--ctid` 또는 `-c`	cTID 사용자 이름 또는 이메일 주소
비밀번호	`--pwd-file`	cTID 비밀번호가 저장된 파일의 경로
계정	`--account` 또는 `-a`	거래 계정 번호

보안을 위해 cTrader ID 비밀번호를 명령어에 직접 입력하지 마세요. 비밀번호를 파일에 저장하고 --pwd-file로 해당 파일을 지정하세요.

메모장과 같은 일반 텍스트 편집기를 여세요.
cTrader ID 비밀번호를 앞뒤에 공백 없이 한 줄로 입력하세요.
파일을 .pwd 또는 .txt 확장자로 저장하세요. 예: password.pwd.
명령어에서 파일을 참조하세요: --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 실행 및 관리를 참조하세요.