Thiết lập cTrader CLI¶

Bài viết này hướng dẫn cài đặt cTrader CLI, tạo tệp thông tin đăng nhập và kiểm tra kết nối trên Windows, macOS hoặc Linux, từ terminal hoặc container Docker.

Điều kiện tiên quyết ¶

• Một cTrader ID liên kết với ít nhất một tài khoản giao dịch.
• Trình quản lý gói được hỗ trợ: WinGet trên Windows, Homebrew trên macOS và Linux.
• Đối với cBot, cần có .NET 8. Hãy biên dịch lại các cBot cũ trong phiên bản mới nhất của ứng dụng cTrader trên máy tính trước khi chạy chúng bằng cTrader CLI.
• Để sử dụng các kỹ năng, cần có Node.js phiên bản 22.20.0 trở lên.

Cài đặt bằng trình quản lý gói ¶

Nên cài đặt thông qua trình quản lý gói. Trình quản lý gói sẽ tải bản dựng phù hợp với hệ điều hành và thêm lệnh ctrader-cli vào PATH, để bạn có thể chạy lệnh từ bất kỳ thư mục nào.

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

Cài đặt bằng image Docker ¶

cTrader CLI được phát hành dưới dạng image Docker cho Linux, thuận tiện để lưu trữ và chạy cBot trên VPS Linux, máy chủ hiệu năng cao hoặc nền tảng đám mây. Image này cũng chạy trên Windows thông qua Docker Desktop với WSL.

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

Hướng dẫn chạy cBot giải thích cách gắn các thư mục của máy chủ host và truyền cấu hình qua biến môi trường.

Cài đặt thủ công trên Windows ¶

Nếu không muốn dùng trình quản lý gói trên Windows, bạn có thể sử dụng tệp thực thi ctrader-cli đi kèm ứng dụng cTrader trên máy tính. Tệp thường nằm tại:

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

Để chạy cTrader CLI từ bất kỳ thư mục nào, hãy thêm thư mục này vào PATH:

1. Sao chép đường dẫn đến thư mục chứa ctrader-cli.
2. Trong menu Start của Windows, tìm Biến môi trường, rồi chọn Chỉnh sửa biến môi trường hệ thống.
3. Trong cửa sổ Thuộc tính hệ thống, chọn Biến môi trường.
4. Trong mục Biến người dùng, nhấp đúp vào Path.
5. Chọn Mới, dán đường dẫn đã sao chép, rồi chọn OK trong từng hộp thoại để lưu.

Kiểm tra cài đặt ¶

Sau khi cài đặt, hãy kiểm tra xem cTrader CLI đã sẵn sàng sử dụng chưa. Cả hai lệnh đều không yêu cầu đăng nhập.

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

Nếu terminal báo không tìm thấy lệnh, hãy đóng rồi mở lại terminal để cập nhật PATH, sau đó thử lại.

Tạo tệp thông tin đăng nhập ¶

Hầu hết các lệnh đều thao tác với tài khoản, vì vậy cần ba giá trị: cTrader ID, mật khẩu và số tài khoản.

Để bảo mật, đừng nhập trực tiếp mật khẩu cTrader ID vào lệnh. Hãy lưu mật khẩu trong tệp và dùng --pwd-file để trỏ đến tệp đó.

1. Mở trình soạn thảo văn bản thuần túy, chẳng hạn Notepad.
2. Nhập mật khẩu cTrader ID trên một dòng, không có khoảng trắng ở đầu hoặc cuối.
3. Lưu tệp với phần mở rộng .pwd hoặc .txt, ví dụ password.pwd.
4. Tham chiếu đến tệp trong lệnh: --pwd-file=C:/test/password.pwd.

Sau khi chuẩn bị tệp thông tin đăng nhập, hãy truyền tệp cho các lệnh theo một trong hai phương thức xác thực.

Ví dụ chạy bằng Docker ¶

Trong container, các đường dẫn trên máy chủ host được gắn vào container bằng --mount, còn các giá trị cấu hình được truyền qua -e. Ví dụ ngắn về cách khởi chạy cBot trong container:

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

Để xem hướng dẫn Docker đầy đủ, bao gồm ý nghĩa của từng tùy chọn, hãy tìm hiểu cách chạy và quản lý cBot.