# 命令列 OpenD
# 第一步 下載
命令列 OpenD 支援 Windows、MacOS、CentOS、Ubuntu 四種系統（點擊完成下載）。
# 第二步 解壓
- 解壓上一步下載的文件，在文件夾中找到 OpenD 設定檔 FutuOpenD.xml 和程式打包數據文件 Appdata.dat。
- FutuOpenD.xml 用於配置 OpenD 程式啟動參數，若不存在則程式無法正常啟動。
- Appdata.dat 是程式需要用到的一些數據量較大的資訊，打包數據減少啟動下載該數據的耗時，若不存在則程式無法正常啟動。
- 命令列 OpenD 支援用户自定義文件路徑，詳見 命令列啟動參數。
# 第三步 參數配置
- 打開並編輯設定檔 FutuOpenD.xml，如下圖所示。普通使用僅需修改賬號和登入密碼，其他高階選項可以根據下表的提示進行修改。
配置項列表：
| 配置項 | 說明 |
|---|---|
| ip | 監聽地址 |
| api_port | API 協議接收連接埠 |
| login_account | 登入帳號 |
| login_pwd | 登入密碼明文 |
| login_pwd_md5 | 登入密碼密文（32 位 MD5 加密 16 進制） |
| lang | 中英語言 |
| log_level | OpenD 日誌級別 |
| push_proto_type | 推送協議類型 |
| qot_push_frequency | API 訂閲數據推送頻率控制 |
| telnet_ip | 遠端操作命令監聽地址 |
| telnet_port | 遠端操作命令監聽連接埠 |
| rsa_private_key | API 協議 RSA 加密私鑰（PKCS#1）文件絕對路徑 |
| price_reminder_push | 是否接收到價提醒推送 |
| auto_hold_quote_right | 被踢後是否自動搶權限 |
| future_trade_api_time_zone | 期貨交易 API 時區 |
| websocket_ip | WebSocket 服務監聽地址 |
| websocket_port | WebSocket 服務監聽連接埠 |
| websocket_key_md5 | 密鑰密文（32 位 MD5 加密 16 進制） |
| websocket_private_key | WebSocket 證書私鑰文件路徑 |
| websocket_cert | WebSocket 證書文件路徑 |
| pdt_protection | 是否開啟 防止被標記為日內交易者 的功能 |
| dtcall_confirmation | 是否開啟 日內交易保證金追繳預警 的功能 |
提示
為保證您的證券業務賬户安全，如果監聽地址不是本地，您必須配置私鑰才能使用交易接口。行情接口不受此限制。
當 WebSocket 監聽地址不是本地，需配置 SSL 才可以啟動，且證書私鑰生成不可設置密碼。
密文是明文經過 32 位 MD5 加密後用 16 進製表示的數據，搜索在線 MD5 加密（注意，通過第三方網站計算可能有記錄撞庫的風險）或下載 MD5 計算工具可計算得到。32 位 MD5 密文如下圖紅框區域（e10adc3949ba59abbe56e057f20f883e）：
OpenD 預設讀取同目錄下的 FutuOpenD.xml。在 MacOS 上，由於系統保護機制，OpenD.app 在運行時會被分配一個隨機路徑，導致無法找到原本的路徑。此時有以下方法：
- 執行 tar 包下的 fixrun.sh
- 用命令列參數
-cfg_file指定設定檔路徑，見下面說明
日誌級別預設 info 級別，在系統開發階段，不建議關閉日誌或者將日誌修改到 warning，error，fatal 級別，防止出現問題時無法定位。
# 第四步 命令列啟動
- 在命令列中切到前面解壓文件夾 OpenD 文件所在的目錄，使用如下命令啟動，即可以 FutuOpenD.xml 設定檔中的參數啟動。
- Windows：
FutuOpenD - Linux：
./FutuOpenD - MacOS：
./FutuOpenD.app/Contents/MacOS/FutuOpenD
- Windows：
命令列啟動參數
命令列中也可以攜帶參數啟動，部分參數會與 FutuOpenD.xml 設定檔相同。傳參格式：
-key=value
例如：- Windows：
FutuOpenD.exe -login_account=100000 -login_pwd=123456 -lang=en - Linux：
FutuOpenD -login_account=100000 -login_pwd=123456 -lang=en - MacOS：
./FutuOpenD.app/Contents/MacOS/FutuOpenD -login_account=100000 -login_pwd=123456 -lang=en
- Windows：
相同參數若同時存在於命令列與設定檔，命令列參數優先。具體參數詳見如下表格：
參數列表：
| 配置項 | 說明 |
|---|---|
| login_account | 登入帳號 |
| login_pwd | 登入密碼明文 |
| login_pwd_md5 | 登入密碼密文（32 位 MD5 加密 16 進制） |
| cfg_file | OpenD 設定檔絕對路徑 |
| console | 是否顯示控制台 |
| lang | 中英語言 |
| api_ip | API 服務監聽地址 |
| api_port | API 協議接收連接埠 |
| help | 輸出命令列啟動參數，並退出程式 |
| log_level | OpenD 日誌級別 |
| no_monitor | 是否啟動守護程序 |
| websocket_ip | WebSocket 服務監聽地址 |
| websocket_port | WebSocket 服務監聽連接埠 |
| websocket_private_key | WebSocket 證書私鑰文件路徑 |
| websocket_cert | WebSocket 證書文件路徑 |
| websocket_key_md5 | 密鑰密文（32 位 MD5 加密 16 進制） |
| price_reminder_push | 是否接收到價提醒推送 |
| auto_hold_quote_right | 被踢後是否自動搶權限 |
| future_trade_api_time_zone | 期貨交易 API 時區 |
