GeekAI 開源自架 AI 助手平台（2026）：用原始碼看懂 BYOK 架構與營運層

用 AI 摘要這篇文章：

ChatGPT Claude Perplexity Google Grok

GeekAI 是一套用 Go 與 Vue3 寫的開源 AI 助手平台，讓你自架一個帶管理後台、會員、點數計費與多種支付的 AI 聊天服務。它和 大家熟悉的 ChatGPT 這類純聊天介面最大的差別，在於它把「營運一個對外收費的 AI 服務」所需的後台全打包進開源專案。要先講清楚的是：它不送你免費的模型額度，你得在管理後台填自己的 API 金鑰，模型費付給 OpenAI 或 Claude，GeekAI 只負責把使用者、計費與介面串起來。

下面所有描述的接觸層級只到讀原始碼與設定檔：README、CHANGELOG、docker-compose、config.sample.toml、handler 目錄都翻過，但我沒有實際把服務跑起來。涉及效能、穩定度、好不好裝的說法，都是官方文件的設計描述，不是實測結論。

Pin

差異不在聚合模型，而在把營運層一起打包

很多開源 AI 聊天專案都號稱「聚合多個模型」，這其實不是 GeekAI 獨有的本事。翻開原始碼會看到，多數模型供應商是透過同一組欄位接入：管理員在後台填一組 ApiKey 加上 ApiURL，只要對方提供 OpenAI 相容的端點就能掛上去。真正讓 GeekAI 跟一般聊天介面拉開差距的，是它在開源專案裡直接內建了一整層營運後台。

config.sample.toml 裡可以同時看到四組支付設定：支付寶、微信支付、虎皮椒，以及預設啟用的易支付 GeekPay，後者還列出支付寶、微信、QQ 錢包、京東、抖音、PayPal 一串付款方式。搭配的是 CHANGELOG 裡反覆出現的算力（運算點數，平台計費單位）扣費、會員套餐、邀請獎勵、兌換碼這些營運功能。換句話說，它鎖定的是「想自己開一個可收費 AI 服務」的營運者，而不只是想在本機和模型聊天的個人使用者。純聊天介面要走到這一步，你得自己把使用者系統、計費、訂單、金流全接一遍，GeekAI 把這層打包成後台填金鑰就能啟用的模組。

BYOK：模型金鑰你自己填，平台只收使用者的錢

把 config.sample.toml 從頭看到尾，會發現一件關鍵的事：整份設定檔處理的是 MySQL、Redis、物件儲存、簡訊、郵件、支付這類基礎設施，完全沒有任何 OpenAI 或 Claude 的 API 金鑰欄位。模型金鑰是另一條路，管理員在後台為每個模型或角色填入金鑰與端點位置，儲存在資料庫裡。這是 BYOK（自帶金鑰）架構：你向模型供應商申請金鑰、自行付費，GeekAI 只負責把使用者的請求轉發出去並按算力計費。它和 主打免費額度的 LLM API 服務是不同的東西，也因為這層設計，它不是什麼帳號共享或破解工具，模型帳單始終由營運者自己扛。

承載這套 BYOK 架構的是它的算力計費機制。模型供應商按 token 向你收費，GeekAI 把每個模型的每次回應換算成算力點數，使用者在平台上的消耗以點數結算，你則在後台為每個模型訂出點數換算規則。模型成本、加價空間與使用者感受到的計費單位是分開的三層：你付給供應商的是真實 token 費用，使用者付給你的是算力點數，點數怎麼對應金額由你的會員套餐與儲值規則決定。這也是為什麼它比起單純的聊天介面更接近一個營運平台：計費邏輯、訂單、邀請與兌換碼促銷都要在後台設定，跑起來才是一個能對外開放的商業服務。

整合模式上要分清楚兩種：有原生處理器的，和走通用相容端點的。原始碼裡找得到 DeepSeek 原生推理、Gitee AI、MidJourney、Stable Diffusion、Suno 音樂、即夢影片這些各自獨立的 handler，CHANGELOG 也記錄了 Sora2 文生影片、DeepSeek-R1 推理模型的支援。但像 Kimi、通義千問這類供應商，靠的就是它們提供 OpenAI 相容端點，套進同一組金鑰加網址的機制就能用，沒有專屬轉接器。實際支援哪些模型、效果如何，要你自己接一次才知道。

串流輸出靠 SSE，這點和部分介紹文章說的不一樣

有一個容易被寫錯的技術細節：部分介紹文章會說 GeekAI 用 WebSocket 做打字機式的串流輸出，但對照 CHANGELOG，官方在 v4.2.4 明確寫著「使用 SSE 發送訊息，替換原來的 WebSocket 訊息方案」，前端套件也換成 SSE 用戶端。WebSocket 這條線目前只保留給 OpenAI 的即時語音通話。如果你是為了評估即時通訊架構而看這套專案，這個修正會直接影響你的判斷：日常對話的串流是 SSE，不是 WebSocket。

Pin

這些能力只證明存在，不證明效果

既然接觸層級只到讀檔，有幾件事必須誠實標清楚。README 裡「回應速度提升百分之八十」「高效能」「穩定可靠」這類說法，是開發者的自我定位，屬於作者宣稱而非我能觀察到的事實，實際在你的流量與資料量下會怎樣，沒有跑起來沒有人能保證。同樣地，整合了哪些模型只代表「接得進去」，不代表轉發品質、回應速度或與最新模型版本的相容程度，這些都要實測。和 需要自己監控 API 狀態的工具一樣，模型供應商的端點變動、限流、計價調整，營運者都得自己接住。

和收費一樣內建、但容易被忽略的是它的合規與審核層。CHANGELOG 紀錄 v4.2.6 加入了安全監控與內容審核，支援敏感內容過濾攔截，v4.1.9 起可以在後台設定 ICP 備案號並顯示在頁尾。這組功能明顯是為了在中國大陸以營運者身分對外開站而設計：你作為服務提供者，依法要為使用者產出的內容負擔審核責任，GeekAI 把這層直接做進平台。對台灣或其他地區的自架者來說，內容審核要不要開、開到多嚴，是可以自己決定的開關，但 ICP 備案與部分金流的合規前提在你這邊不成立，等於有些欄位設了也用不上。

在把它當成對外服務的底座之前，有幾件事值得先壓力測試一遍：把同一個問題丟給不同供應商的模型，確認算力扣點的換算符合你設的規則；同時開多個連線看 SSE 串流是否穩定、有沒有掉字；接一輪真實的金流小額儲值，確認訂單與點數入帳對得起來。這幾項都走順，才算真的把 BYOK、串流、計費三條主幹接通，否則只是介面能開、底層還沒驗過。

採用前會卡關的幾條硬限制

最先會卡到的是映像檔與原始碼的落差。官方 docker-compose 拉的是註冊到阿里雲 geekmaster 命名空間的映像檔，對應的是 PLUS 進階版。README 寫得很白，PLUS 的原始碼不會一次開放，只提供映像檔免費使用，部分功能會逐步遷移回社群版。所以你跑 docker-compose up 直接得到的是 PLUS，想改原始碼得回到 GitHub 上的社群版自己 build，這兩條路不能混為一談。

授權這關也要分清楚。社群版採 Apache-2.0，商業自架完全合法，你想拿來對外收費沒有授權障礙。但要在介面上拿掉版權資訊，得另外購買授權，CHANGELOG 裡「允許取得授權的使用者自訂版權資訊」說的就是這條商業授權機制。至於 PLUS 的完整原始碼，官方的說法是「不會一次性開放，只提供映像檔免費使用」，付費能不能換到完整碼，公開文件沒有講清楚。這和 其他 Apache 授權的開源 AI 專案相比，多了「免費映像檔是閉源 PLUS」這層要注意。

另一條會影響採用決定的是營運情境偏中國大陸。預設啟用的易支付、支付寶、微信支付、QQ 錢包、京東、抖音這串付款方式，加上簡訊預設走阿里雲、支援 ICP 備案號顯示、內建敏感內容過濾審核，整組設定是為了在中國大陸合規開站設計的。台灣或其他地區的使用者要把金流換成在地的 LINE Pay、街口，或國際的 Stripe，得自己接 GeekPay 之外的管道，PayPal 雖然列在易支付的方式裡，實際整合到什麼程度我沒辦法從設定檔確認。

起手式：四個容器與一條 docker-compose

官方推薦的部署方式是 Docker。docker-compose.yaml 開出來是四個主要容器加一個文件解析服務：MySQL 8 跑資料庫、Redis 6 跑快取、Apache Tika 負責文件抽取、後端 API 監聽 5678 埠、前端網頁監聽 8080 埠。映像檔來源是阿里雲容器鏡像服務，時區預設掛上海，config.toml 掛載進去就能啟動。偏好自行編譯的人，倉庫裡有 Makefile 與 go.mod 可以從原始碼建置後端，前端另有獨立的建置流程。

有一個容易混淆的地方要先點清楚：作者自己營運的 chat.geekai.me 與 www.geekai.me 是他們的付費會員服務，走的是算力儲值制，和你自架出來的服務是兩回事。你想理解 GeekAI 的使用者體驗，可以先去官方示範站註冊看看，但別把示範站的定價或模型組合當成你自架後的預設值，那些是作者已經組態好的營運結果。用戶端這條線上，GeekAI 還提供 Windows、Linux、macOS 與 Android 的用戶端安裝包，等於除了網頁，你也包出一個桌面與行動裝置能裝的原生應用，這對想把 AI 服務推到非技術使用者面前是加分的。

啟動之後真正的工作才開始。你要進管理後台把模型供應商的金鑰一個個填進去、為模型定價換算成算力點數、決定要不要開註冊、把金流接到你要的支付商。GeekAI 提供的是 Windows、Linux、macOS、Android 多端用戶端，WebSocket 的位置換成 SSE 之後，行動端的串流體驗理論上一致，但這同樣要實跑才知道。

授權、活躍度與綜合判斷

社群版是 Apache-2.0，商用自架沒問題；PLUS 是獨立的閉源商業授權，想完全掌握程式碼就留在社群版。命名上有個細節：設定檔裡的簡訊簽名與應用名稱是「極客學長」，而物件儲存與任務排程的代號還留著 chatgpt-plus，反映這個專案從早期改名一路演進的痕跡，搜尋資料時別和另一個同名性質不同的 geekai.co 混在一起。

截至 2026 年 8 月，倉庫約 4681 顆星、1070 個 fork，沒有被封存，最近一次更新落在 v4.2.8（2026-08-03），CHANGELOG 還在密集修 bug 與加功能，屬於持續維護中的專案，但星數規模在開源 AI 專案裡只算中等，社群與生態成熟度要有相應預期。

綜合來看，GeekAI 適合「會架 Docker、想自己開一個對外收費的 AI 服務、願意自己扛模型帳單與金流串接」的營運者，它幫你省下的是使用者系統、計費與後台這一整層。它不適合只想在本機免費和模型聊天、或期待裝完就有免費額度的人，因為 BYOK 意味著每一通呼叫都計入你的供應商帳單。如果你落在前一群，最低成本的驗證方法是先只接一個便宜的模型供應商、用 docker-compose 跑起來、走一遍從註冊到扣算力的流程，確認金流、串流與計費三條主幹都通，再決定要不要把它當成長期對外服務的底座，或是只當內部工具用。