
CtrlAI
Cirtus · 其他
CtrlAI 是一款 AI 代理護欄代理伺服器:一個開源 HTTP 層,位於你的代理 SDK 與 LLM 供應商之間,接著檢查模型嘗試發出的每個工具呼叫。它阻擋危險的呼叫,記錄其餘的動作。一個可防竄改的稽核記錄和一個緊急停止開關讓整套功能更完整。你只要改一個 URL 就能把它放到現有設定前面,所以你的代理程式碼永遠不會碰到這層安全機制。不必重建,不必包裝。

關於 CtrlAI
什麼是 CtrlAI
CtrlAI 是一款自架代理伺服器,專為執行真正能做事之 AI 代理的團隊而設計:讀取檔案、執行 shell 指令、控制瀏覽器、傳送訊息。這些能力正是讓代理有用的原因,也正是讓它們有風險的原因。CtrlAI 在請求路徑正中間插入一個檢查點,讓決定代理能做什麼的人是你,而不是模型,而且在它真的去做之前就攔下。
它解決的主要問題是「不開刀就能控制」。多數護欄工具都要你包裝自己的 SDK、修改代理,或圍著它們的 API 重建工作流程。誰想那樣?CtrlAI 改為藏在供應商的 base URL 後面。你的代理仍以為自己在直接跟 Anthropic 或 OpenAI 對話。在中間,CtrlAI 讀取工具呼叫、比對規則,然後要么放行,要么把回應換成一則阻擋通知。
最大的限制是環境。CtrlAI 是一個你自己編譯並執行的 Go 執行檔,所以適合熟悉終端機和設定檔的人。它的儀表板沒有登入機制。任何能連到 3100 埠的人都能看到活動,並在你的機器上終止代理。如果那個埠暴露在 localhost 之外,你就是把信任交給了網路。本機開發沒問題。任何要共享的用途,請把它放到自己的存取控制後面。
開始使用
- 從 GitHub 複製儲存庫,用 Go 1.24 或更新版本編譯執行檔,然後把它移到你的 PATH。
- 不帶任何參數執行
ctrlai以觸發首次設定,它會寫入預設設定檔、規則檔和稽核目錄。 - 用
ctrlai start啟動代理伺服器(加上-d讓它在背景執行)。 - 在代理設定中把供應商的
baseUrl設為http://127.0.0.1:3100/provider/anthropic,把代理指向代理伺服器。 - 在
http://127.0.0.1:3100/dashboard開啟儀表板,觀察工具呼叫並調整規則。
產品資訊
快速了解 CtrlAI 的定價、支援平台與效能。
適合對象
這項工具最適合的使用者、任務與情境。
使用者
- 打造 AI 代理的開發者:任何給代理檔案、shell 或瀏覽器存取權並想要一層安全網的人,前提是不介意在本機執行 Go 執行檔。
- 推出代理產品的小型團隊:需要依代理設定規則和稽核軌跡、又不想重建 SDK 整合的團隊。
- 重視安全與合規的維運人員:必須展示代理做了什麼、並證明記錄事後未被編輯的人。
任務
- 阻擋有風險的工具呼叫:在呼叫執行之前,阻止代理讀取 `.env` 檔案、刪除目錄或把資料送到外部伺服器。
- 保留稽核軌跡:每個工具呼叫都以雜湊鏈記錄,所以你能查詢、匯出並驗證發生了什麼、何時發生。
- 緊急關閉:如果某個東西開始行為異常,可從 CLI 或儀表板終止單一代理或全部代理。
情境
- 本機代理開發:在筆電上讓代理對著真實工具執行,在一個壞指令毀掉整個下午之前先抓到它。
- 多代理設定:在 URL 中給每個代理自己的 ID,讓「實習生」代理不能寫檔案,而資深代理仍然可以。
- 合規審查:交給稽核員一份可匯出、可防竄改的記錄,而不是試圖憑記憶重建日誌。
主要功能
透明代理伺服器,零程式碼變更
CtrlAI 嵌在你的代理 SDK 與 LLM 供應商之間,不碰你的代理。你改一個 base URL,代理伺服器就把請求往上轉發、檢查回應,然後像什麼都沒發生地回傳。SDK 從不知道。不必重寫、不必包裝、不必學新 API。
可設定的護欄規則
規則放在一個 YAML 檔中,可比對工具名稱、代理 ID、檔案路徑 glob、指令 regex、URL regex,或參數中的任何子字串。你可以完全阻擋某個特定工具、只對某個代理阻擋它,或阻擋危險的 shell 模式,例如對根目錄執行 rm -rf。一條規則中的多個條件以 AND 相連。欄位內的多個清單以 OR 相連。第一個符合的規則勝出。
19 條內建安全規則
開箱即用,CtrlAI 內建涵蓋 SSH 私密金鑰、env 檔案、憑證檔案、shell 設定寫入、破壞性指令、資料外洩、相機存取、螢幕錄影、位置和遠端程式碼執行的規則。它們預設開啟,也可切換。在你寫下第一條自訂規則之前,就已經有基礎防護。
緊急停止開關
你可以用 ctrlai kill main --reason "suspicious activity" 立即終止任何代理,或用 ctrlai kill --all 停掉全部。代理伺服器會回傳一個假的回合結束回應,讓代理的迴圈乾淨地停下。終止狀態會寫入檔案並被監看以熱重載。即使代理伺服器仍在執行,也能在幾秒內生效。
可防竄改的稽核記錄
每個工具呼叫都記錄了序號、時間戳、代理 ID、工具名稱、參數、決策以及符合的規則。每個項目都帶有一個與前一項相連的 SHA-256 雜湊。改動任何項目,鏈條就從那一點斷開。你可以即時追蹤、依代理或決策查詢、驗證完整性,並匯出成 CSV 或 JSON。
即時儀表板與 REST API
同一個埠上的網頁儀表板會顯示代理、請求與阻擋次數、完整規則清單,以及透過 WebSocket 即時串流的工具呼叫決策。儀表板顯示的一切也都能透過 REST API 取得,所以你能用自己的工具來撰寫規則變更、終止和稽核匯出的腳本。
全有或全無的回應阻擋
當一個回應包含多個工具呼叫時,CtrlAI 會逐一評估,但只要有任何一個呼叫被阻擋,就會移除整個回應。理由是模型把呼叫當成一組來規劃,所以讓「安全」的那一半繼續跑可能導致無法預測的行為。這是謹慎的預設值,另有一個部分阻擋模式被註記為未來選項。
多代理隔離
代理身分來自 URL 路徑,所以 /provider/anthropic/agent/work/... 和 /provider/anthropic/agent/main/... 會被視為各自擁有規則、稽核歷史和終止狀態的獨立代理。你可以鎖住某個代理的權限,而不改變其他代理被允許做的事。
優缺點
優點
- 適用於任何允許你設定自訂 base URL 的 SDK,所以整合只是一行設定變更,而不是重寫。
- 預設開啟 19 條安全規則,在任何設定工作之前就提供有用的防護。
- 稽核記錄使用 SHA-256 雜湊鏈,所以竄改是可偵測的,而不只是被勸阻。
- 涵蓋 Anthropic Messages 和 OpenAI Chat Completions 的完整檢查,其他路徑則直接通行。
- MIT 授權且自架,所以沒有訂閱費,也沒有任何資料離開你的機器。
缺點
- 需要 Go 1.24+ 才能編譯,並要熟悉設定檔和 CLI,這排除了非技術使用者。
- 儀表板沒有身分驗證,所以把 3100 埠暴露在 localhost 之外,就讓網路上任何人都能終止代理並讀取活動。
- 全有或全無的阻擋意味著一批中有一個壞呼叫就會阻擋整批,所以你有時得把一個無害的請求另外重送。
常見問題
它是一個位於你的 AI 代理與 LLM 供應商之間的代理伺服器。它讀取模型回傳的工具呼叫、比對你的規則、阻擋危險的呼叫,並記錄一切。你的代理繼續運作,就像直接跟 Anthropic 或 OpenAI 對話一樣。
相關內容
探索與 CtrlAI 相關的工具、技能與文章。
CtrlAI 替代方案
BinkBink
BinkBink · 其他BinkBink 是一個免費的線上遊戲平台與 AI 遊戲製作工具,讓任何人都能把一段簡短的文字描述變成可玩的瀏覽器遊戲。你可以直接跳進數百款社群自製的遊戲。或者描述自己的想法,幾秒內就能玩,再分享給朋友。想建立自己的遊戲嗎?你不需要寫程式。不用設定引擎、不用下載、不必費心。

Audiogen
Audiogen Inc. · 其他Audiogen 是一款由 Audiogen Inc. 打造的 AI 音樂生成器。這支小型研究團隊花了約 2.5 年訓練自家生成式音樂模型,並圍繞它設計網頁介面。這款 AI 音樂工具捨棄單純的文字框,把時間軸變成對新手友善的生成式音訊工作站(Generative Audio Workstation,簡稱 GAW),其中的補繪、延伸、混音與音軌編輯,操作起來更像在畫布上彩繪。產品仍在 beta 階段,因此取用管道是候補名單或邀請碼。付費方案尚未公布。
Aiml API
AIMLAPI OÜ · 其他Aiml API 是一套統一的 AI 模型 API,把 OpenAI、Google、Anthropic 等超過 1000 個模型放在同一個端點與同一張帳單之後。你只要依照單一相容 OpenAI 的結構撰寫程式碼,接著改一個模型字串,就能在聊天、圖像、影片與音訊模型之間切換。它適合想取得多模型存取、又不想管理十幾個供應商帳號的開發者與小型團隊,也省去了測試多家廠商時常見的帳務麻煩。一組金鑰就能涵蓋全部。
