回到產品交付流程 查看政策

INSTALL FAQ

Docker image 安裝 FAQ 與故障排除

本頁整理下載 Docker image 後最常見的安裝問題。請先依序完成 Docker Desktop 安裝、執行 fingerprint 工具、在付款成功頁貼上 machine fingerprint、下載 Docker image 與 license.json，再執行 image 並依本機設定畫面匯入 license，就可以使用了。OKX、Binance、Bybit、Bitget、Gate.io、Pionex、BingX 都可以依交易所分流處理；API 相關方案請勿開啟提款權限，建議先用 demo mode / testnet / 小範圍測試。

現在的安裝流程

1. 付款成功頁

貼上 machine fingerprint。

2. 下載檔案

下載 Docker image 與 license.json。

3. 執行 image

用 Docker Desktop 載入並啟動。

4. 匯入 license

依本機設定畫面匯入 license，就可以使用了。

一、安裝前先檢查

Docker Desktop

請先安裝 Docker Desktop，並確認 Docker Engine 已啟動。

Docker image

請從付款成功頁下載 Docker image，並確認檔案已完整下載。

license.json

請從付款成功頁下載 license.json，啟動後依本機設定畫面匯入，不要改檔名。

API 權限

需要 API 的方案只需讀取與交易權限，請不要開啟提款權限。

二、常見安裝錯誤

出現「Docker is not running」或 Docker 指令找不到怎麼辦？

代表 Docker Desktop 尚未安裝、尚未啟動，或終端機還抓不到 docker 指令。請先開啟 Docker Desktop，等到 Docker Engine 顯示 Running，再重新開啟終端機檢查： 

docker --version
docker info

如果 `docker info` 還是失敗，請重新啟動 Docker Desktop 或電腦，再確認 Windows 虛擬化功能已開啟。

Docker image 要怎麼載入？

進入交付資料夾後，依 ofc 提供的檔名載入 image。檔名可能會依版本不同而調整： 

docker load -i ofc-toolkit-image.tar

載入完成後可以用 `docker images` 確認 image 是否出現。

container 要怎麼啟動？

請先載入 Docker image，再依交付方式啟動。若提供的是 docker compose 檔，常見指令如下： 

docker compose up -d

啟動後可以用 `docker ps` 確認 container 是否正在執行，再依本機設定畫面匯入 license.json，就可以使用了。

Windows 跳出安全提醒或防毒軟體擋住下載

請確認檔案來源是 ofc 提供的下載連結，並先掃描檔案。Docker image 交付不需要執行未知批次安裝檔；如果防毒軟體阻擋壓縮檔或 image 載入，請先確認來源與檔名，再視情況加入允許清單。

license.json 驗證失敗

請檢查三件事：檔名必須是 license.json、不要用文字編輯器修改內容、匯入時使用的是付款成功頁下載的檔案。license.json 綁定 machine fingerprint，若你換電腦、重灌系統或貼錯 fingerprint，授權會失敗。

machine fingerprint 要貼在哪裡？

付款成功後會進入 license 下載頁。請先執行 get fingerprint 工具，複製 machine fingerprint，貼到該頁面後下載已簽章的 license.json。

下載後找不到 Docker image 或啟動檔

請確認 .zip 已完整解壓縮。Windows 有時會把檔案副檔名隱藏，請開啟檔案總管的「副檔名」顯示。若仍找不到 `.tar` image、compose 檔或 start 檔，請確認你下載的是方案 Docker image，不是 fingerprint 工具。

啟動後沒有看到 dashboard

請先用 `docker ps` 確認 container 正在執行，再查看 ofc 提供的 localhost / 127.0.0.1 網址。若 container 有啟動但瀏覽器沒有自動開啟，請手動複製網址到瀏覽器。

打開後瀏覽器沒有自動出現頁面

請先看終端機或 compose log 是否有顯示 localhost 或 127.0.0.1 網址。若有，手動複製網址到瀏覽器。若沒有，請把 container log 或終端機錯誤截圖寄給 ofc。

顯示 port already in use / 連接埠被占用

代表同一個 dashboard container 可能已經開著，或其他程式占用同一個 port。請先用 `docker ps` 檢查是否已有 OFC container，必要時先停止舊 container，再重新啟動。仍失敗時請把錯誤訊息寄給 ofc。

產品放在 OneDrive、桌面或中文路徑會有問題嗎？

大多數情況可以使用，但 Docker 掛載資料夾時路徑越簡單越穩。若遇到權限或掛載錯誤，建議先把交付資料夾移到簡單路徑，例如 C:\Trading\ofc，再重新啟動 container。

Google Drive 下載後被瀏覽器或防毒軟體提醒

請確認檔案來源是 ofc 提供的共用連結，並先進行防毒掃描。如果檔案被瀏覽器阻擋，可嘗試重新下載或改用 Google Drive 網頁下載。不要下載來路不明的轉傳檔。

三、各交易所實作流程與 FAQ

以下交易所都可以做：OKX、Binance、Bybit、Bitget、Gate.io、Pionex、BingX。實作流程會依交易所 API 規格、帳戶類型、可用權限與你購買的方案分流；共同原則是只開最小必要權限、不開提款、先測試再正式使用。

OKX

實作流程

  1. 建立 API Key、Secret、Passphrase。
  2. 確認 demo / real 模式、帳戶模式與交易產品權限。
  3. 只開讀取與交易必要權限，不開提款或資產轉出。
  4. 先用 demo mode 驗證資料、風控與執行流程。
OKX 最常錯在哪？

Passphrase 多空格、demo / real 模式不一致、帳戶模式不符、合約權限或槓桿設定未確認。

Binance

實作流程

  1. 建立 API Key、Secret，依需求開 spot 或 futures 相關權限。
  2. 確認 testnet / live 環境與使用的市場類型。
  3. 若有 IP 白名單，確認執行環境 IP 是否一致。
  4. 先用 testnet 或小額測試確認資料與風控。
Binance 最常錯在哪？

spot / futures 權限開錯、testnet 和正式環境 key 混用、IP 限制擋住請求、交易產品未啟用。

BingX

實作流程

  1. 建立 API Key、Secret，依需求確認 spot 或 perpetual futures 產品線。
  2. 確認 API 權限、IP 限制、交易產品與帳戶可用功能。
  3. 只開讀取與交易必要權限，不開提款或資產轉出。
  4. 先用資料讀取、小範圍測試確認訂單限制、槓桿與風控參數。
BingX 最常錯在哪？

Spot / perpetual futures 產品線混用、API 權限不足、IP 限制擋住請求、槓桿或倉位設定未對齊。

Bybit

實作流程

  1. 建立 API Key、Secret，確認使用 spot 或 derivatives。
  2. 確認 Unified Trading Account / account type 是否符合。
  3. 只開必要交易權限，不開資產轉出。
  4. 先做資料讀取、下單限制與槓桿設定檢查。
Bybit 最常錯在哪？

帳戶類型不一致、產品類型選錯、測試環境與正式環境混用、槓桿或保證金模式未對齊。

Bitget

實作流程

  1. 建立 API Key、Secret、Passphrase。
  2. 確認 spot、USDT-M 或其他合約產品線。
  3. 設定最小必要權限與可用的 IP 限制。
  4. 先測資料讀取、部位限制、槓桿與冷卻規則。
Bitget 最常錯在哪？

Passphrase 錯誤、產品線選錯、合約類型不一致、API 權限沒有包含需要的讀取或交易功能。

Gate.io

實作流程

  1. 建立 API Key、Secret，確認 spot 或 futures 市場。
  2. 確認結算幣別、合約類型與交易產品。
  3. 只開讀取與交易必要權限，不開提款。
  4. 先測資料流、訂單限制與風控參數。
Gate.io 最常錯在哪？

市場類型或結算幣別選錯、交易產品未開、API 權限不足、合約參數和工具設定不一致。

Pionex

實作流程

  1. 確認帳戶是否可建立 API Key 與可用權限。
  2. 依可用產品分流為資料檢視、提醒、或下單輔助。
  3. 不開提款或資產轉出權限。
  4. 先用小範圍測試確認資料、訊號與通知流程。
Pionex 最常錯在哪？

帳戶可用 API 權限和其他交易所不同，需先確認可用產品與權限；若執行權限不足，會先走資料與提醒流程。

需要填交易所登入密碼嗎？

不需要。ofc 不會要求你的交易所登入密碼、助記詞、提款權限或資產轉出權限。API 相關方案只需要你自行建立 API Key / Secret / Passphrase，並依方案功能填入本機 .env。

API 權限要怎麼開？

原則是最小權限：只開讀取與交易所需權限，不開提款權限。第一次使用請先保持 demo mode / testnet / 小範圍測試，確認 API、帳戶模式、槓桿、風控與執行流程都正確。

.env 填錯會怎樣？

常見會出現 API 驗證失敗、passphrase 錯誤、帳戶模式不符或無法讀取帳戶資訊。請確認 API Key、Secret、Passphrase 沒有多空格，並確認測試 / 正式環境與交易所後台一致。

測試環境正常，正式環境不正常

請先不要急著正式執行。檢查交易所 API 權限、帳戶模式、IP 限制、交易產品權限、槓桿設定與風控參數。若不確定，請回到測試環境或小範圍測試，並把錯誤訊息寄給 ofc。

四、回報問題時請附上

請寄到：ofc.ai.trading@gmail.com

若需要語音一對一安裝教學，也可以在信中留下 LINE、Discord 或 Instagram 聯絡方式；ofc 會依安裝狀況協助安排。

  • 購買或申請 Alpha 使用的 Gmail / Email。
  • 你購買或測試的方案名稱。
  • 錯誤截圖，或終端機最後 20 行錯誤訊息。
  • 你目前做到哪一步：fingerprint、license、Docker Desktop、Docker image 載入、container 啟動、API 設定或 dashboard 開啟。
  • 若要語音協助，請留下 LINE、Discord 或 Instagram，方便安排一對一安裝引導。
  • 不要寄交易所密碼、助記詞、提款權限或完整信用卡資料。

還是卡住？

先把錯誤畫面與目前步驟寄給 ofc，我會依你的狀況回覆下一步；必要時可用 LINE、Discord 或 Instagram 語音一對一協助安裝。API 相關問題請記得不要附提款權限。

查看交付流程