Ollama Onyx

Onyx 是可自托管的聊天界面，定位接近「企业内网的 ChatGPT」——支持自建 Agent、RAG、应用连接器、RBAC、SSO。它可以直接对接 Ollama 的全线模型。

版本基线 v0.40.12，官方 docs.ollama.com/integrations/onyx。

一、Onyx 能做什么

规模上从单人部署到大型组织都能覆盖。

二、部署 Onyx

按官方 quickstart 部署。资源规划参考 Onyx 的 resourcing 文档——Onyx 本身要跑数据库、向量库、后端等多个组件，别在跑 Ollama 的同一台小机器上硬塞。

三、接入 Ollama

1. 登录 Onyx 部署（首次需注册账号）
2. 在设置流程里把 LLM 提供方选成 Ollama
3. 填 Ollama API URL，然后选模型

一个关键坑：Docker 里不能用 127.0.0.1

如果 Onyx 跑在 Docker 里，http://127.0.0.1 指向的是容器自己，不是宿主机。要访问宿主机的 Ollama，用：

http://host.docker.internal

这是所有「容器内应用连宿主机服务」场景的通用规则，n8n 那篇也是同样的坑。

四、也能接 Ollama 云端

Onyx 的设置流程里还可以把 Onyx Cloud 连到 Ollama 的云端模型。

五、配置速查

六、适合什么场景

Onyx 的价值不在「一个聊天框」，而在把本地模型接进企业知识体系：

• 文档散在 Drive、邮件、Slack：用连接器 + RAG 统一检索
• 需要权限隔离：用 RBAC + SSO
• 数据不能出内网：模型跑本地 Ollama，Onyx 自托管

如果只是个人用，直接用 Claude Desktop 或 ChatGPT Desktop 更轻。Onyx 适合有合规要求、需要多人共用的团队。

常见问题

动手试

## 让 Ollama 对外可达（容器或局域网访问的前提）
OLLAMA_HOST=0.0.0.0:11434 ollama serve

## 从另一台机器/容器验证
curl http://<宿主机IP>:11434/api/version

第二条能通，Onyx 才能连上。