完全自托管Open BrainKubernetes部署PostgreSQLpgvector不依賴Supabase的終極指南【免費(fèi)下載鏈接】OB1Open Brain — The infrastructure layer for your thinking. One database, one AI gateway, one chat channel — any AI plugs in. No middleware, no SaaS.項(xiàng)目地址: https://gitcode.com/gh_mirrors/ob/OB1Open BrainOB1是一個(gè)開源的個(gè)人知識(shí)系統(tǒng)一個(gè)數(shù)據(jù)庫(kù)、一個(gè)AI網(wǎng)關(guān)、一個(gè)聊天渠道任何AI工具都能接入同一份持久記憶。默認(rèn)方案依賴 Supabase 托管數(shù)據(jù)庫(kù)而本指南帶你走完全自托管 Open Brain路線——用 Kubernetes 部署 PostgreSQL pgvector 向量數(shù)據(jù)庫(kù)自建 MCP 服務(wù)器不再依賴任何 SaaS 服務(wù)。全程約 60 分鐘5 個(gè)步驟即可完成。為什么選擇Kubernetes自托管部署Open Brain標(biāo)準(zhǔn)入門教程使用 Supabase 免費(fèi)層作為數(shù)據(jù)庫(kù)適合快速體驗(yàn)但如果你在意數(shù)據(jù)主權(quán)、私有網(wǎng)絡(luò)隔離或離線運(yùn)行自托管是唯一選擇。這套部署方案由社區(qū)貢獻(xiàn)并經(jīng)維護(hù)者團(tuán)隊(duì)審核合并位于 integrations/kubernetes-deployment/核心設(shè)計(jì)非常簡(jiǎn)潔一個(gè) Pod兩個(gè)容器dbPostgreSQL pgvector 擴(kuò)展和mcp-serverDeno 編寫的 MCP 服務(wù)器共享網(wǎng)絡(luò)命名空間通過(guò)127.0.0.1通信StatefulSet 本地卷數(shù)據(jù)持久化在/var/openbrain/dbPod 重啟不丟數(shù)據(jù)Ingress 暴露 MCP 端點(diǎn)任何 MCP 客戶端Claude Desktop、Cursor 等都能通過(guò) URL 遠(yuǎn)程接入模型層可替換默認(rèn)走 OpenRouter也可換成 Ollama、llama.cpp 等本地模型實(shí)現(xiàn) 100% 本地運(yùn)行部署前準(zhǔn)備Kubernetes環(huán)境與工具清單開始之前確認(rèn)你的環(huán)境滿足以下 4 項(xiàng)要求項(xiàng)目說(shuō)明Kubernetes 集群官方已在 K3s v1.31 上驗(yàn)證任意發(fā)行版均可kubectl Docker用于部署和構(gòu)建鏡像AI 模型 APIOpenRouter / OpenAI 兼容接口或本地模型Ollama 等Ingress 控制器可選需要集群外訪問(wèn)時(shí)再配Traefik、nginx-ingress 等小貼士部署過(guò)程中會(huì)產(chǎn)生密碼、訪問(wèn)密鑰、API Key 等多組憑據(jù)。建議照抄 integrations/kubernetes-deployment/README.md 中的Credential Tracker模板邊填邊做避免回頭找密碼。先獲取項(xiàng)目代碼并進(jìn)入部署目錄git clone https://gitcode.com/gh_mirrors/ob/OB1 cd OB1/integrations/kubernetes-deployment五步部署Open Brain到Kubernetes集群第1步構(gòu)建Open Brain MCP服務(wù)器鏡像MCP 服務(wù)器的完整源碼在 integrations/kubernetes-deployment/index.tsDockerfile 基于denoland/deno:2.3.3以非 root 用戶運(yùn)行并監(jiān)聽 8000 端口。構(gòu)建并導(dǎo)入鏡像docker build -t openbrain-mcp-server:latest . # K3s 用戶執(zhí)行 docker save openbrain-mcp-server:latest | sudo k3s ctr images import -minikube 用戶改用minikube image load其他集群推送到自己的鏡像倉(cāng)庫(kù)即可。第2步配置Secrets密鑰文件復(fù)制 integrations/kubernetes-deployment/k8s/secrets.yml.example 為secrets.yml填入 4 個(gè)值postgres-password數(shù)據(jù)庫(kù)密碼mcp-access-keyMCP 客戶端的訪問(wèn)密鑰embedding-api-key/chat-api-keyAI 模型的 API 密鑰?? 真實(shí)密鑰文件永遠(yuǎn)不要提交到版本控制第3步一鍵應(yīng)用Kubernetes清單integrations/kubernetes-deployment/k8s/openbrain.yml 包含全部資源Namespace、ConfigMap內(nèi)嵌建庫(kù) SQL、StatefulSet 和 Servicekubectl apply -f k8s/secrets.yml kubectl apply -f k8s/openbrain.yml第4步驗(yàn)證Open Brain部署是否成功kubectl get pods -n openbrain # 用 port-forward 測(cè)試 MCP 端點(diǎn) kubectl port-forward -n openbrain svc/openbrain 8000:8000 curl -X POST http://localhost:8000 -H x-brain-key: 你的訪問(wèn)密鑰 \ -H Content-Type: application/json -d {jsonrpc:2.0,method:tools/list,id:1}看到 4 個(gè)工具search_thoughts、list_thoughts、thought_stats、capture_thought即部署成功。初始化 SQL 會(huì)自動(dòng)創(chuàng)建thoughts表含 1536 維向量列和 GIN 索引以及match_thoughts相似度檢索函數(shù)數(shù)據(jù)模型如下第5步連接MCP客戶端完成接入以 Claude Desktop 為例在配置中添加遠(yuǎn)程 MCP 端點(diǎn)集群內(nèi)地址或 Ingress 外網(wǎng)地址均可{ mcpServers: { openbrain: { url: https://brain.yourdomain.com, transport: http, headers: { x-brain-key: 你的訪問(wèn)密鑰 } } } }配置 Ingress 的方法見 openbrain.yml 末尾注釋掉的示例段brain.yourdomain.com TLS 證書取消注釋并填寫你的域名即可對(duì)外暴露。部署完成后你的Open Brain長(zhǎng)什么樣部署成功后你會(huì)得到openbrain-0Pod 穩(wěn)定運(yùn)行db mcp-server 兩個(gè)容器任何 MCP 客戶端寫入的想法都自動(dòng)生成向量嵌入 提取元數(shù)據(jù)人物、話題、行動(dòng)項(xiàng)、類型存入你自己的 PostgreSQL語(yǔ)義搜索、最近列表、統(tǒng)計(jì)面板全部可用且數(shù)據(jù)完全在你的集群內(nèi)工具治理提醒MCP 工具會(huì)占用 AI 的上下文窗口部署規(guī)模越大風(fēng)險(xiǎn)越高。建議閱讀 docs/05-tool-audit.md 學(xué)習(xí)工具審計(jì)與精簡(jiǎn)策略。常見問(wèn)題排查Kubernetes部署避坑指南癥狀原因與解決mcp-server 容器 CrashLoopBackOff執(zhí)行kubectl logs -n openbrain openbrain-0 -c mcp-server最常見是 API Key 無(wú)效或 embedding API 地址不通數(shù)據(jù)庫(kù)未初始化/表缺失初始化 SQL 只在首次啟動(dòng)運(yùn)行舊數(shù)據(jù)卷會(huì)跳過(guò)。刪除數(shù)據(jù)目錄后kubectl delete pod openbrain-0 -n openbrain重建向量維度報(bào)錯(cuò)本地嵌入模型輸出不是 1536 維時(shí)需修改 ConfigMap 中的vector(1536)并重建thoughts表數(shù)據(jù)庫(kù)連接被拒同 Pod 內(nèi)容器走127.0.0.1屬正常現(xiàn)象檢查db容器是否 ready想用本地大模型修改 openbrain.yml 中 mcp-server 的環(huán)境變量將EMBEDDING_API_BASE和CHAT_API_BASE指向http://your-local-model:8080/v1密鑰填not-needed模型名改為你的 Ollama 模型即可——至此 Open Brain 實(shí)現(xiàn)從數(shù)據(jù)庫(kù)到 AI 推理的全鏈路本地化。延伸閱讀完整部署說(shuō)明與憑據(jù)追蹤表integrations/kubernetes-deployment/README.md標(biāo)準(zhǔn) Supabase 入門方案45 分鐘版docs/01-getting-started.md部署后擴(kuò)展你的大腦integrations/ 目錄收錄了 Slack 采集、Discord 采集、REST API、Agent Memory 等社區(qū)集成數(shù)據(jù)在自己手里AI 記憶才真正屬于你。【免費(fèi)下載鏈接】OB1Open Brain — The infrastructure layer for your thinking. One database, one AI gateway, one chat channel — any AI plugs in. No middleware, no SaaS.項(xiàng)目地址: https://gitcode.com/gh_mirrors/ob/OB1創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 完全自托管Open Brain：Kubernetes部署PostgreSQL+pgvector，不依賴Supabase的終極指南
完全自托管Open BrainKubernetes部署PostgreSQLpgvector不依賴Supabase的終極指南【免費(fèi)下載鏈接】OB1Open Brain — The infrastructure layer for your thinking. One database, one AI gateway, one chat channel — any AI plugs in. No middleware, no SaaS.項(xiàng)目地址: https://gitcode.com/gh_mirrors/ob/OB1Open BrainOB1是一個(gè)開源的個(gè)人知識(shí)系統(tǒng)一個(gè)數(shù)據(jù)庫(kù)、一個(gè)AI網(wǎng)關(guān)、一個(gè)聊天渠道任何AI工具都能接入同一份持久記憶。默認(rèn)方案依賴 Supabase 托管數(shù)據(jù)庫(kù)而本指南帶你走完全自托管 Open Brain路線——用 Kubernetes 部署 PostgreSQL pgvector 向量數(shù)據(jù)庫(kù)自建 MCP 服務(wù)器不再依賴任何 SaaS 服務(wù)。全程約 60 分鐘5 個(gè)步驟即可完成。為什么選擇Kubernetes自托管部署Open Brain標(biāo)準(zhǔn)入門教程使用 Supabase 免費(fèi)層作為數(shù)據(jù)庫(kù)適合快速體驗(yàn)但如果你在意數(shù)據(jù)主權(quán)、私有網(wǎng)絡(luò)隔離或離線運(yùn)行自托管是唯一選擇。這套部署方案由社區(qū)貢獻(xiàn)并經(jīng)維護(hù)者團(tuán)隊(duì)審核合并位于 integrations/kubernetes-deployment/核心設(shè)計(jì)非常簡(jiǎn)潔一個(gè) Pod兩個(gè)容器dbPostgreSQL pgvector 擴(kuò)展和mcp-serverDeno 編寫的 MCP 服務(wù)器共享網(wǎng)絡(luò)命名空間通過(guò)127.0.0.1通信StatefulSet 本地卷數(shù)據(jù)持久化在/var/openbrain/dbPod 重啟不丟數(shù)據(jù)Ingress 暴露 MCP 端點(diǎn)任何 MCP 客戶端Claude Desktop、Cursor 等都能通過(guò) URL 遠(yuǎn)程接入模型層可替換默認(rèn)走 OpenRouter也可換成 Ollama、llama.cpp 等本地模型實(shí)現(xiàn) 100% 本地運(yùn)行部署前準(zhǔn)備Kubernetes環(huán)境與工具清單開始之前確認(rèn)你的環(huán)境滿足以下 4 項(xiàng)要求項(xiàng)目說(shuō)明Kubernetes 集群官方已在 K3s v1.31 上驗(yàn)證任意發(fā)行版均可kubectl Docker用于部署和構(gòu)建鏡像AI 模型 APIOpenRouter / OpenAI 兼容接口或本地模型Ollama 等Ingress 控制器可選需要集群外訪問(wèn)時(shí)再配Traefik、nginx-ingress 等小貼士部署過(guò)程中會(huì)產(chǎn)生密碼、訪問(wèn)密鑰、API Key 等多組憑據(jù)。建議照抄 integrations/kubernetes-deployment/README.md 中的Credential Tracker模板邊填邊做避免回頭找密碼。先獲取項(xiàng)目代碼并進(jìn)入部署目錄git clone https://gitcode.com/gh_mirrors/ob/OB1 cd OB1/integrations/kubernetes-deployment五步部署Open Brain到Kubernetes集群第1步構(gòu)建Open Brain MCP服務(wù)器鏡像MCP 服務(wù)器的完整源碼在 integrations/kubernetes-deployment/index.tsDockerfile 基于denoland/deno:2.3.3以非 root 用戶運(yùn)行并監(jiān)聽 8000 端口。構(gòu)建并導(dǎo)入鏡像docker build -t openbrain-mcp-server:latest . # K3s 用戶執(zhí)行 docker save openbrain-mcp-server:latest | sudo k3s ctr images import -minikube 用戶改用minikube image load其他集群推送到自己的鏡像倉(cāng)庫(kù)即可。第2步配置Secrets密鑰文件復(fù)制 integrations/kubernetes-deployment/k8s/secrets.yml.example 為secrets.yml填入 4 個(gè)值postgres-password數(shù)據(jù)庫(kù)密碼mcp-access-keyMCP 客戶端的訪問(wèn)密鑰embedding-api-key/chat-api-keyAI 模型的 API 密鑰?? 真實(shí)密鑰文件永遠(yuǎn)不要提交到版本控制第3步一鍵應(yīng)用Kubernetes清單integrations/kubernetes-deployment/k8s/openbrain.yml 包含全部資源Namespace、ConfigMap內(nèi)嵌建庫(kù) SQL、StatefulSet 和 Servicekubectl apply -f k8s/secrets.yml kubectl apply -f k8s/openbrain.yml第4步驗(yàn)證Open Brain部署是否成功kubectl get pods -n openbrain # 用 port-forward 測(cè)試 MCP 端點(diǎn) kubectl port-forward -n openbrain svc/openbrain 8000:8000 curl -X POST http://localhost:8000 -H x-brain-key: 你的訪問(wèn)密鑰 \ -H Content-Type: application/json -d {jsonrpc:2.0,method:tools/list,id:1}看到 4 個(gè)工具search_thoughts、list_thoughts、thought_stats、capture_thought即部署成功。初始化 SQL 會(huì)自動(dòng)創(chuàng)建thoughts表含 1536 維向量列和 GIN 索引以及match_thoughts相似度檢索函數(shù)數(shù)據(jù)模型如下第5步連接MCP客戶端完成接入以 Claude Desktop 為例在配置中添加遠(yuǎn)程 MCP 端點(diǎn)集群內(nèi)地址或 Ingress 外網(wǎng)地址均可{ mcpServers: { openbrain: { url: https://brain.yourdomain.com, transport: http, headers: { x-brain-key: 你的訪問(wèn)密鑰 } } } }配置 Ingress 的方法見 openbrain.yml 末尾注釋掉的示例段brain.yourdomain.com TLS 證書取消注釋并填寫你的域名即可對(duì)外暴露。部署完成后你的Open Brain長(zhǎng)什么樣部署成功后你會(huì)得到openbrain-0Pod 穩(wěn)定運(yùn)行db mcp-server 兩個(gè)容器任何 MCP 客戶端寫入的想法都自動(dòng)生成向量嵌入 提取元數(shù)據(jù)人物、話題、行動(dòng)項(xiàng)、類型存入你自己的 PostgreSQL語(yǔ)義搜索、最近列表、統(tǒng)計(jì)面板全部可用且數(shù)據(jù)完全在你的集群內(nèi)工具治理提醒MCP 工具會(huì)占用 AI 的上下文窗口部署規(guī)模越大風(fēng)險(xiǎn)越高。建議閱讀 docs/05-tool-audit.md 學(xué)習(xí)工具審計(jì)與精簡(jiǎn)策略。常見問(wèn)題排查Kubernetes部署避坑指南癥狀原因與解決mcp-server 容器 CrashLoopBackOff執(zhí)行kubectl logs -n openbrain openbrain-0 -c mcp-server最常見是 API Key 無(wú)效或 embedding API 地址不通數(shù)據(jù)庫(kù)未初始化/表缺失初始化 SQL 只在首次啟動(dòng)運(yùn)行舊數(shù)據(jù)卷會(huì)跳過(guò)。刪除數(shù)據(jù)目錄后kubectl delete pod openbrain-0 -n openbrain重建向量維度報(bào)錯(cuò)本地嵌入模型輸出不是 1536 維時(shí)需修改 ConfigMap 中的vector(1536)并重建thoughts表數(shù)據(jù)庫(kù)連接被拒同 Pod 內(nèi)容器走127.0.0.1屬正常現(xiàn)象檢查db容器是否 ready想用本地大模型修改 openbrain.yml 中 mcp-server 的環(huán)境變量將EMBEDDING_API_BASE和CHAT_API_BASE指向http://your-local-model:8080/v1密鑰填not-needed模型名改為你的 Ollama 模型即可——至此 Open Brain 實(shí)現(xiàn)從數(shù)據(jù)庫(kù)到 AI 推理的全鏈路本地化。延伸閱讀完整部署說(shuō)明與憑據(jù)追蹤表integrations/kubernetes-deployment/README.md標(biāo)準(zhǔn) Supabase 入門方案45 分鐘版docs/01-getting-started.md部署后擴(kuò)展你的大腦integrations/ 目錄收錄了 Slack 采集、Discord 采集、REST API、Agent Memory 等社區(qū)集成數(shù)據(jù)在自己手里AI 記憶才真正屬于你。【免費(fèi)下載鏈接】OB1Open Brain — The infrastructure layer for your thinking. One database, one AI gateway, one chat channel — any AI plugs in. No middleware, no SaaS.項(xiàng)目地址: https://gitcode.com/gh_mirrors/ob/OB1創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考