Onyx｜可自托管的团队知识检索与AI问答平台

用途与定位

Onyx 是一个可自托管部署的团队知识检索与 AI 问答平台，官方把它描述为“团队与 AI 代理的知识/上下文层”。它把分散在多个业务应用中的内容连同元数据和权限信息一起拉取、索引，再让大模型基于这些内部资料回答问题。它属于 Web 自托管应用，需自行部署服务端，并非常规桌面单机软件。

适用人群

• 内部文档分散在多个 SaaS 工具、需要统一检索入口的团队；
• 对数据主权敏感、希望索引和问答都留在自有环境中的组织；
• 想把内部知识接入自定义 AI 代理或 MCP 客户端的开发者与运维人员。

主要功能

• 代理式 RAG：官方称其基于混合索引和面向检索调优的代理框架，提供搜索与回答；
• 深度研究：多步研究流程生成报告；
• 自定义代理：可限定知识范围、设定指令并执行动作；
• 联网搜索：官方列出的服务商包括 Serper、Google PSE、Brave、SearXNG 等，并提供内置爬虫及对 Firecrawl、Exa 的支持；
• 外部动作与 MCP：让代理在外部应用中执行操作；
• 沙箱与产物：在沙箱中执行代码、生成可下载文档与图形；
• 语音模式：文本转语音与语音转文本；
• 多入口：Web 与桌面应用、Slack 与 Discord 机器人、MCP 服务器、Chrome 扩展、可嵌入组件。

输入与输出

输入为所连接应用中的文档与元数据、用户自然语言问题；输出为带来源的答案、研究报告、生成的文档或图形、外部应用动作结果。具体连接器清单与各入口能力范围以官方文档为准，待核查。

获取与试用步骤

官方 README 给出单条命令安装脚本，也提供 Docker、Kubernetes、Helm/Terraform 及主流云厂商部署指南。安装命令与具体步骤请以官方文档为准，本文不复制脚本内容。官方另提供免部署的 Onyx Cloud 供试用。是否适合本地环境、需要哪些前置条件，待核查。

示例任务

“把我们项目文档里关于发布流程的说明汇总成一份检查清单，并标注每一条来自哪个来源。”这类任务可体现其检索加生成的组合能力；实际效果受索引质量与所选模型影响，本项目未做实测。

运行环境与部署模式

官方区分两种部署：标准版包含向量与关键词索引、后台同步任务容器、模型推理服务，以及用于大规模场景的 Redis 缓存与 MinIO 对象存储；轻量版定位为较简单的聊天界面，官方称内存占用低于 1GB，但不具备文档索引能力。具体硬件要求、镜像大小与版本号待核查。

模型、API 与费用

官方称支持主流 LLM 提供方，既包括自托管方案（如 Ollama、LiteLLM、vLLM 等），也包括商业服务（如 Anthropic、OpenAI、Gemini 等）。联网搜索、爬虫、嵌入模型等外部服务可能产生费用，价格待核查。Onyx Cloud 与 Enterprise Edition 的收费方案以官网定价页为准，待核查。

国内访问与网络

部分外部服务商与云服务在境内可达性未知，待核查；自托管部署本身的网络要求需结合实际选用的模型与搜索服务判断。

隐私与安全

官方强调可气隙部署，文档索引、数据库与处理均在自有服务中完成，并可按用户权限过滤结果。实际隔离效果取决于部署配置，需自行评估；连接第三方模型或搜索服务时数据会离开自有环境，应据此选择。

许可证

仓库许可标识为 NOASSERTION。按仓库许可原文：ee 目录下内容适用 Onyx Enterprise License；第三方组件沿用各自原许可；其余内容适用 MIT Expat 许可。官方说明社区版（CE）在 MIT 下免费提供核心 RAG、聊天、代理与动作功能，企业版（EE）含面向大型组织的额外功能。使用前请逐目录核对许可原文，模型权重与外部服务条款需另行核对。

来源与使用边界

官方仓库：https://github.com/onyx-dot-app/onyx

资料版本：https://github.com/onyx-dot-app/onyx/blob/9aced7a3bee9d8ff7e0920136c7959cff9d00cd4/README.md

维护方：onyx-dot-app/onyx；采集日期：2026-11-13。依据官方资料经AI整理，本站未安装、运行或实测。

许可标识：NOASSERTION，具体范围以原始许可文件为准；代码、模型权重、依赖及在线服务适用各自条款。开源不代表模型调用、托管或商业服务免费。国内访问、硬件及模型适配条件未经本站验证。