跳至正文

文件

使用 Docker 自架 OpenConnector

啟動本地 runtime、呼叫第一個 Action、連接帳號，並為部署準備持久化儲存和驗證。

由 OOMOL 維護·

原始碼核對日期：2026-09-09. 範例已依連結中的原始碼版本核對，不代表已通過實際上游 API 驗證；你部署的版本可能不同。

啟動執行環境

需要 Git 和包含 Docker Compose 的 Docker 環境。先呼叫無需授權的 Action，再設定應用帳戶。 複製儲存庫並啟動已發布的映像檔。此體驗流程適用於你自己電腦上的本機環境。

Docker
git clone https://github.com/oomol-lab/open-connector.git
cd open-connector
docker compose up

呼叫第一個 Action

在另一個終端獲取 Hacker News 熱門文章。此唯讀 Action 無需服務帳戶授權。

HTTP · Hacker News
curl -s -X POST \
  http://localhost:3000/v1/actions/hackernews.get_top_stories \
  -H 'content-type: application/json' \
  -d '{"input":{}}'

對本機執行環境呼叫這個唯讀、無需服務授權的 Action。若已啟用執行階段認證，需附帶 Bearer 權杖。

連線應用帳戶

開啟本機控制台，選擇服務並設定憑證。OAuth 服務需要你在對應平台上註冊自己的 OAuth 應用。

憑證與 OAuth →

持久保存並保護憑證

Docker 映像檔將本地 runtime 資料放在 /app/data，應掛載持久化磁碟區。使用 OOMOL_CONNECT_ENCRYPTION_KEY 加密儲存憑證，並妥善保存還原所需的金鑰；公開部署前請閱讀部署指南。

公開部署前，需要設定管理端認證、執行階段權杖、憑證加密和 OAuth 公網地址。生產環境設定請遵循部署指南。

完整部署指南 ↗

對外部署前的準備

專案的 Compose 檔案將 connector-data 掛載至 /app/data。允許遠端存取前，應分別設定 OOMOL_CONNECT_ADMIN_TOKEN、OOMOL_CONNECT_RUNTIME_TOKEN，並設定 OOMOL_CONNECT_ENCRYPTION_KEY。設定公開存取位址，在部署入口啟用 HTTPS，不要將金鑰提交至版本庫。

升級與復原準備

記錄部署的映像版本，備份執行環境資料庫，並安全保管對應的加密金鑰副本。升級前在隔離環境驗證復原流程。金鑰遺失後無法復原加密記錄；刪除資料卷會刪除本地資料庫。

理解呼叫結果

HTTP 執行環境回應包含 success、message、data 和 meta。請檢查 success 及 Action 輸出 Schema，不要只看 HTTP 狀態碼。執行中繼資料包含 executionId 時，可用來定位已遮蔽敏感資訊的執行記錄。下方僅展示回應結構，並非真實 API 呼叫結果。

示意回應
{
  "success": true,
  "message": "OK",
  "data": {},
  "meta": {}
}

呼叫失敗時如何排查

  • 驗證失敗時，先核對端點和憑證類型：管理端憑證用於 /api，執行環境 Bearer 權杖用於 /v1 和 /mcp。服務提供者的 API Key 不能取代執行環境權杖。
  • 權限遭拒時，檢查 Action 所需 scopes、執行環境 Action 規則和連線授權。權杖有效也不代表有權使用所選帳號。
  • 結果為空或資源缺失時，檢查連線帳號及其對目標資源的存取權限。完成授權不代表能存取所有工作區、頻道或文件。
  • 重試前先檢查錯誤與執行記錄。對於會修改服務資料的 Action，先確認操作是否已完成，不要盲目重複請求。
閱讀 Markdown