OpenAI 相容
對話完成、回應介面、Anthropic 訊息 — 既有開發套件幾乎可直接指向本機閘道。
OpenAI 介面對話 · 回應 · 訊息
AES-256-GCM加密稽核與佇列資料
OTP 管理台一次性登入 · 工作階段約 12 小時
佇列 + 防濫用生產級背壓與 DDoS 防護
本機 Grok → 可上線閘道
把本機 Grok 變成可上線的 OpenAI 相容閘道 — 架構、介面、管理台、佇列與安全一目了然。
- 用戶端OpenAI 開發套件／curl／Open WebUI
- 閘道認證 · 限流 · 安全／代理模式
- 佇列AES-GCM 加密工作 · 串流狀態
- 工作程序租約／公平輪詢／併發
- Grok 命令列
grok -p無介面
用戶端（OpenAI SDK / curl / Open WebUI）
│ Authorization: Bearer gk_live_...
▼
Express 閘道 :3847
· 認證 · 限流 · 安全／代理模式
· 入隊對話工作（AES-GCM）· 串流佇列狀態
· 代理感知用戶端 IP · 自動封鎖
· 加密稽核 · 管理台 /admin
│
▼
進程內工作程序（租約／公平輪詢／併發）
│
▼
grok -p …（本機 Grok 命令列）
加密稽核
AES-256-GCM 保護提示詞、回覆、檔案與佇列資料；介面金鑰以 scrypt 雜湊儲存。
持久化佇列
至少一次送達、公平輪詢、背壓與死信；重啟後可回收進行中工作。
DDoS 防護中心
限流、自動封鎖、黑名單、反向代理 IP 來源 — 生產級防濫用。
| 功能 | 說明 |
|---|---|
| OpenAI 介面 | POST /v1/chat/completions、POST /v1/responses、GET /v1/models |
| Anthropic 介面 | POST /v1/messages（Bearer 或 x-api-key） |
| 思考鏈 | reasoning_content + Grok thought + grok.* 元資料 |
| 文件 | 類型嗅探上傳、加密儲存、下載 |
| 安全／代理 | 每把金鑰獨立政策；可全域強制安全模式 |
| 加密 | AES-256-GCM 加密提示詞、回覆、檔案、佇列資料 |
| 管理台 | OTP 登入；佇列／媒體／系統／PM2／DDoS／介面能力 |
| 媒體庫 | 生成／編輯／圖生影片、資產與工作、燈箱預覽 |
| 對話佇列 | SQLite 工作、公平輪詢、暫停／排空、死信、冪等鍵 |
| DDoS 防護 | 即時連線、黑名單、自動封鎖、策略預設、反向代理 IP |
| 命令列 | 生命週期、設定、佇列、防濫用、金鑰、文件、對話、統計、管理台 OTP |
| 運維 | SQLite、PM2、日誌自動裁剪（大於 5MB）、自我更新 |
介面與協議
端點、能力矩陣、思考鏈對應，以及安全／代理政策。
協議與端點
GET /health存活檢查；GET /ready資料庫 + Grok；GET /v1/modelsPOST /v1/chat/completions（佇列；可選冪等鍵）；串流可先送佇列狀態再送 OpenAI 區塊POST /v1/responses文字子集；POST /v1/messagesAnthropic 風格- 文件：
/v1/documents上傳／列表／軟刪除；管理台金鑰管理/v1/api-keys - 認證：
Authorization: Bearer gk_live_… - 擴充欄位：
include_reasoning、cwd（僅代理模式）、session_id、document_ids
Grok 命令列能力矩陣
| 能力 | 對話 | 回應 | Anthropic | 管理台開關 |
|---|---|---|---|---|
| 文字 + 串流 | ✅ | ✅ | ✅ | 協議開關 |
| 視覺／圖片 | ✅ | ✅ | ✅ | vision |
| 圖像生成與編輯 | ✅ | — | — | imagesApi + 代理模式 |
檔案 /v1/files | ✅ | — | — | filesOpenAiAlias |
| 非同步影片 | ✅ 模擬 | — | — | videoApi |
| 語音合成／轉錄 | ✅ 模擬／503 | — | — | audioApi |
| 工具呼叫 | ✅ | ✅ | ✅ | tools |
| JSON 結構輸出 | ✅ | ✅ | 可透傳 | structuredOutput |
| 推理強度 | ✅ | ✅ | thinking→effort | reasoningEffort |
| 助手模擬 | — | — | — | assistantsEmulation |
不宣稱官方雲端 100%（嵌入向量／即時語音等需獨立後端）。Grok 命令列無 temperature 等採樣旋鈕；可選 strictSampling 拒絕此類參數。
思考鏈對應
- Grok
thought→reasoning_content／串流增量 text→content；end→finish_reason+grok.sessionId／stopReason- 預設
include_reasoning: true
安全／代理政策
- 安全模式（用戶端預設）：沙箱工作目錄、不一律核准、限制工具、較短逾時
- 代理模式：完整命令列工具（可一律核准）；工作目錄仍受允許清單限制
- 全域強制安全：
GROK_SAFE_MODE=true或管理台安全設定 - 用戶端無法靠請求內容提權；勿將代理模式金鑰暴露於公網
管理台
OTP 登入後的完整營運面板 — 對話、金鑰、媒體、佇列、防濫用、PM2 與系統狀態。
管理台各頁
- 登入：
gctoac admin otp（5 分鐘單次）；工作階段約 12 小時；可關閉面板，僅以命令列admin on重開 - 儀表板：24 小時關鍵指標、佇列深度、防護摘要、近期對話
- 對話：試用台、歷史、上下文模式、附件（同樣可入隊）
- 對話紀錄：搜尋／分頁；完整解密提示詞／思考鏈／回覆
- 介面金鑰／文件／稽核：建立、限流、IP 白名單、預覽下載、可讀動作標籤
- 用量與防護：按模型／金鑰統計、限流摘要
- 媒體庫／佇列／DDoS：見「佇列與安全」分頁
- 安全設定：全域安全模式、工具／回合／逾時、預設模型、關閉管理台
- 介面能力：協議 · 媒體 · 能力 · 模擬；預設開放／鎖定／開發
- PM2：gctoac ↔ PM2、監聽連接埠、設定、日誌
- 系統狀態：軟件／套件／環境；一鍵更新並重新啟動
媒體庫
- 分頁：工作室 · 資產 · 工作；關鍵指標條
- 工作室：生成／編輯／圖生影片（Grok 長寬比）；素材庫選取 + 拖放
- 預覽燈箱：圖片／影片／音訊／PDF／文字（二進位物件符合內容安全政策）
佇列與安全
加密、金鑰、文件、持久化佇列、DDoS 與安全注意事項。
加密、認證與稽核
- 介面金鑰以 scrypt 雜湊儲存（舊 SHA-256 於登入時升級）
- 對話／文件／佇列工作資料：AES-256-GCM
- 明文金鑰建立時只顯示一次；列表僅顯示前綴
- 完整對話稽核；管理台對話紀錄可解密查看（受權限保護）
介面金鑰
- 命令列：
gctoac key create|list|show|update|revoke|activate - 可設名稱、模式（安全｜代理）、限流、啟用狀態
- 管理台可編輯角色、IP 白名單
文件
- 上傳（類型嗅探）、加密儲存於資料庫或檔案系統、預覽／下載／刪除
- 對話透過
document_ids注入解密內容
持久化對話佇列
- 至少一次送達；租約／心跳；重啟回收進行中工作
- 預設依介面金鑰加權輪詢或全域先進先出；每把金鑰 + 全域併發
- 背壓：佇列已滿 429、排空中 503、等待逾時 504、取消 409
- 可選冪等鍵；資料負載 AES-GCM 入庫
- 後端預設
QUEUE_BACKEND=sqlite（redis／kafka 預留） - 管理台：暫停／排空、死信、取消／重新入隊／優先級／清理
DDoS／防濫用
- 限流：視窗、每把金鑰／每個 IP、對話突發
- 自動封鎖：失敗認證、重複 429、併發洪水、請求速率、累犯
- 預設檔：寬鬆／均衡／嚴格／自訂；白名單永不自動封鎖
- 手動封鎖（有效期／永久）；反向代理跳數與 IP 來源（自動／Cloudflare／nginx 等）
- 只有可信代理列表內的對等端才採信轉發標頭，防止偽造繞過
安全注意
- 備份 ENCRYPTION_KEY — 遺失則歷史資料無法解密
- 對外請用安全模式金鑰；管理台只開本機／虛擬私人網絡
- OTP 工作階段存於瀏覽器工作階段儲存：跨網站指令碼攻擊 = 在有效期內接管管理台
- 管理台金鑰／OTP 視同最高權限（更新／PM2／改連接埠）
- 勿提交
.env；勿外洩 OTP／管理台金鑰
命令列與運維
gctoac／gcoa 生命週期、政策熱重載，以及生產部署要點。
命令列 gctoac／gcoa
- 生命週期：安裝設定、啟動／前景／PM2、停止、重新啟動、狀態、檢測、日誌、遷移、種子、更新、開啟、版本
- 管理台：狀態／開啟／關閉、一次性密碼、撤銷工作階段
- 金鑰／設定：建立等；設定寫入／預設檔（本機｜生產｜程式碼｜閱讀｜對話｜長文）
- 佇列：統計、政策、暫停／恢復／排空、工作、取消／重新入隊／優先級、清理死信
- 防濫用：政策、封鎖／解封、黑名單
- 觀測：統計、模型、文件、對話、對話串、稽核
- 政策寫入資料庫後約 2–5 秒重載，多數無需重新啟動
安裝、連接埠與生產運維
- 需要 Node.js 20 或以上，以及已
grok login的 Grok 命令列 - 只支援 npm 套件庫安裝（勿使用
npm i -g github:…） - 預設：API
/v1、管理台/admin/、健康檢查；改連接埠需同步跨域與管理台網址 - 資料目錄
~/.gctoac/（GCTOAC_HOME／--home） - 生產：首選執行方式（gctoac 或 PM2）；日誌裁剪；避免雙重執行程序導致連接埠被佔用
管理台截圖與快速安裝
真實介面預覽，以及四步上線指令。
01
儀表板
24 小時關鍵指標、佇列深度、金鑰／媒體、近期 API 對話、安全摘要。
02
對話試用台
多輪對話、思考鏈、附件、歷史。
03
用量與限額
按模型／金鑰統計與閘道限流摘要。
04
DDoS 防護中心
政策、流量、黑名單、反向代理 IP。
05
對話佇列
暫停／排空、死信、併發與公平策略。
06
PM2 程序控制
gctoac 背景程序 ↔ PM2、連接埠 3847。
07
系統狀態
Node／Grok 命令列／PM2 健康與一鍵更新。
快速指令
- 全域安裝
- 檢測 → 安裝設定 → 啟動
- 管理台一次性密碼 → 開啟 /admin/
- 建立金鑰 → 呼叫介面
npm install -g grok-cli-to-openai-compatible
gctoac doctor && gctoac setup && gctoac start
gctoac admin otp
gctoac key create
# http://127.0.0.1:3847/v1