Onyx 開源企業 AI 平台:自部署 RAG 與 Agent 完整指南

Onyx 是開源企業級 AI 平台,支援自部署 RAG、多 LLM Agent、程式碼執行與 MCP 整合。本文完整解析功能、架構、部署與授權差異,適合尋求資料隱私與高度客製化的團隊。

簡介

Onyx 是一個開源的企業級 AI 平台,定位為「團隊的生成式 AI 入口」。它提供自然語言介面連接任意大型語言模型(LLM),同時整合團隊內部知識庫、應用程式與網路搜尋能力。專案原名 Danswer,後更名為 Onyx,目前在 GitHub 擁有 30.7k+ Stars、4.2k+ Forks 與 216+ 貢獻者,最新版本 v4.2.2 釋出於 2026 年 6 月。

核心優勢在於支援自部署雲端託管雙模式,滿足資料隱私管控與高度客製化需求,適合需自主掌握模型推論與資料索引的組織。

核心功能

AI 對話與自定義 Agent

  • 支援多 LLM 提供商:Anthropic Claude、OpenAI GPT、Google Gemini、Ollama 本地模型等
  • 可建立具備自定義指令、知識庫與行動的 AI Agent
  • 提供統一介面切換不同模型供應商

RAG 與內部搜尋

  • 採用混合向量 + 關鍵字索引架構
  • 結合進階 RAG、上下文檢索與 LLM 生成的知識圖譜
  • 顯著提升答案準確度與可追溯性

深度研究

  • 多步驟自動化研究流程
  • 可生成結構化深度報告
  • 2026 年 2 月在相關排行榜名列前茅

程式碼執行沙箱

  • 內建隔離執行環境
  • 支援 Python 資料分析、圖表生成、檔案處理
  • 適用於資料科學與自動化腳本場景

MCP 與 Actions 整合

  • 支援 Model Context Protocol (MCP) 協議
  • 50+ 內建連接器:Slack、Google Drive、Confluence、Jira 等
  • Agent 可直接呼叫外部應用程式 API

多模態互動

  • 語音模式:TTS/STT 雙向語音對話
  • 圖像生成:基於提示詞生成圖片

技術架構

層級 技術棧 備註
後端 Python 3.13、FastAPI、SQLAlchemy、Alembic、Celery 已從 3.11 升級至 3.13
前端 Next.js 15+、React 18、TypeScript、Tailwind CSS 現代化全端框架
資料庫 PostgreSQL + Redis 快取 主從分離架構
向量搜尋 Vespa 向量資料庫 高效能混合檢索
認證授權 OAuth2、SAML、多供應商支援 企業級 SSO 就緒
語言組成 Python 67.2%、TypeScript 27.6%、Go 1.9% 多語言協作專案

部署模式

Onyx Lite(輕量版)

  • 記憶體需求 < 1 GB
  • 僅包含 Chat UI、Agent 基礎功能
  • 適合快速測試、小型團隊或資源受限環境

Onyx Standard(標準版)

  • 完整平台功能
  • 包含向量索引、背景同步 Worker、AI 模型推論伺服器
  • Redis 與 MinIO 效能優化
  • 適合生產環境與大規模部署

部署方式:支援 Docker、Kubernetes、Helm Chart,官方提供一鍵安裝腳本:

# 一鍵安裝(自部署)
curl -fsSL https://onyx.app/install_onyx.sh | bash

授權與版本差異

功能 Community Edition (MIT) Enterprise Edition
核心 Chat / RAG / Agent :white_check_mark: :white_check_mark:
Actions / MCP 整合 :white_check_mark: :white_check_mark:
SSO (OIDC/SAML/Google OAuth) :cross_mark: :white_check_mark:
SCIM 群組同步 :cross_mark: :white_check_mark:
RBAC 細粒度權限 :cross_mark: :white_check_mark:
使用分析與查詢審計 :cross_mark: :white_check_mark:
白牌客製化 :cross_mark: :white_check_mark:

Community Edition 採 MIT 授權,完全免費開源;Enterprise Edition 針對大型組織合規與治理需求設計。

專案狀態與社群

注意:README 與文件中仍可見部分「Danswer」品牌痕跡,屬正常更名過渡期現象。

中文社群現況

目前未發現 Onyx.app 在 RedNote(小紅書)上的公開討論。RedNote 月活 3.5 億,但內容側重生活風格與電商,與企業級 AI 工具受眾重疊度低。搜尋結果中的「RedNote」多為平台介紹或同名其他產品(如 Onyx Boox 電子書閱讀器)。

若需中文技術交流,建議關注:

  • GitHub Issues / Discussions
  • 官方 Discord
  • Reddit:r/selfhosted、r/LocalLLaMA
  • 國內技術論壇與自架社群

適用場景與決策建議

場景 建議方案
團隊需自主掌握資料、模型與推論基礎設施 Onyx Standard 自部署
快速驗證 AI Agent 與 RAG 概念 Onyx Lite 或雲端試用
企業需 SSO、RBAC、審計日誌合規 Enterprise Edition
整合既有 SaaS 工作流 利用 MCP + Actions 連接器
資料科學團隊需程式碼執行環境 內建沙箱支援 Python 分析

總結

Onyx 提供功能完整的開源企業 AI 平台,涵蓋 RAG、Agent、深度研究、程式碼執行與 MCP 整合等關鍵能力。雙部署模式與雙授權版本靈活適配不同規模與合規需求。對於重視資料主權高度客製化技術棧可控性的團隊,Onyx 是值得深入評估的選擇。


本文整理自官方文件、GitHub 專案頁面與公開技術資料,僅供參考。部署生產環境前請詳閱最新官方文件與版本釋出說明。