镜像概览

完整引用
docker.io/onyxdotapp/onyx-backend
Registry
docker.io
命名空间
onyxdotapp
仓库
onyx-backend
已缓存 Tag 数
1061
最近同步
07/06/2026, 01:23 PM

简介

Onyx 开源企业搜索与 RAG 后端镜像,连接向量库与 LLM 提供文档问答 API,需配合 onyx-web 与 PostgreSQL/Redis 同栈部署。

详细介绍

onyxdotapp/onyx-backend 运行 FastAPI 检索编排服务, ingestion 文档经 embedding 写入 Vespa/Qdrant 等向量后端并对接 OpenAI/本地 LLM。典型用于企业知识库语义搜索,与 Danswer 同类但架构独立。镜像 standalone 前端,需 onyx-web 与依赖数据库;生产固定 tag、API Key 经 Secret 注入并限制 CORS 与 rate limit。

快速启动

docker run -d --name onyx-backend \
  -p 8080:8080 \
  -e POSTGRES_HOST=postgres \
  -e REDIS_HOST=redis \
  docker.io/onyxdotapp/onyx-backend:latest

推荐实践

docker run -d --name onyx-backend \
  --restart unless-stopped \
  -p 8080:8080 \
  -e POSTGRES_HOST=postgres.internal \
  -e REDIS_HOST=redis.internal \
  -e OPENAI_API_KEY=sk-xxx \
  -e AUTH_TYPE=basic \
  docker.io/onyxdotapp/onyx-backend:0.5.0

核心参数说明

  • -p 8080:8080 — 检索与 chat API 端口
  • -e POSTGRES_HOST — 元数据与用户 PostgreSQL
  • -e REDIS_HOST — 任务队列与缓存
  • -e OPENAI_API_KEY — LLM/embedding 上游密钥
  • -e AUTH_TYPE — 认证模式(basic/oauth)
  • --restart unless-stopped — 搜索后端持续在线

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: onyx-backend
spec:
  replicas: 2
  selector:
    matchLabels:
      app: onyx-backend
  template:
    metadata:
      labels:
        app: onyx-backend
    spec:
      containers:
        - name: backend
          image: docker.io/onyxdotapp/onyx-backend:0.5.0
          ports:
            - containerPort: 8080
          envFrom:
            - secretRef:
                name: onyx-secrets
---
apiVersion: v1
kind: Service
metadata:
  name: onyx-backend
spec:
  selector:
    app: onyx-backend
  ports:
    - port: 8080
      targetPort: 8080

Secret 含 DB/Redis/LLM 凭据;与 onyx-web Deployment 同 namespace,向量库 Vespa 独立 StatefulSet 按官方 chart 部署。

最新 Tag(20 条)

查看全部 1061 个 Tag →
Tag架构推送时间大小Digest同步期望操作
docker.io/onyxdotapp/onyx-backend
:beta
linux/amd64linux/arm64
2026/06/30 08:00758.8 MBsha256:5fdb89604502
docker.io/onyxdotapp/onyx-backend
:v4.3.0-beta.1
linux/amd64linux/arm64
2026/06/30 08:00758.8 MBsha256:5fdb89604502
docker.io/onyxdotapp/onyx-backend
:latest
linux/amd64linux/arm64
2026/06/30 04:43755.5 MBsha256:33ee6c718688
docker.io/onyxdotapp/onyx-backend
:v4.2.2
linux/amd64linux/arm64
2026/06/30 04:43755.5 MBsha256:33ee6c718688
docker.io/onyxdotapp/onyx-backend
:4
linux/amd64linux/arm64
2026/06/30 04:43755.5 MBsha256:33ee6c718688
docker.io/onyxdotapp/onyx-backend
:4.2
linux/amd64linux/arm64
2026/06/30 04:43755.5 MBsha256:33ee6c718688
docker.io/onyxdotapp/onyx-backend
:4.2.2
linux/amd64linux/arm64
2026/06/30 04:43755.5 MBsha256:33ee6c718688
docker.io/onyxdotapp/onyx-backend
:edge
linux/amd64linux/arm64
2026/06/29 19:48756.1 MBsha256:1e08985ece43
docker.io/onyxdotapp/onyx-backend
:nightly-latest-20260629
linux/amd64linux/arm64
2026/06/29 19:48756.1 MBsha256:1e08985ece43
docker.io/onyxdotapp/onyx-backend
:nightly-latest-20260628
linux/amd64linux/arm64
2026/06/28 18:53756.1 MBsha256:7e2fb1de7f2b
docker.io/onyxdotapp/onyx-backend
:nightly-latest-20260627
linux/amd64linux/arm64
2026/06/27 18:48756.1 MBsha256:27e160819f0f
docker.io/onyxdotapp/onyx-backend
:v4.1.8
linux/amd64linux/arm64
2026/06/27 03:17753.2 MBsha256:667a2d2fa46c
docker.io/onyxdotapp/onyx-backend
:4.1
linux/amd64linux/arm64
2026/06/27 03:17753.2 MBsha256:667a2d2fa46c
docker.io/onyxdotapp/onyx-backend
:4.1.8
linux/amd64linux/arm64
2026/06/27 03:17753.2 MBsha256:667a2d2fa46c
docker.io/onyxdotapp/onyx-backend
:v4.2.1
linux/amd64linux/arm64
2026/06/27 02:49755.5 MBsha256:6e8c14d0d58e
docker.io/onyxdotapp/onyx-backend
:4.2.1
linux/amd64linux/arm64
2026/06/27 02:49755.5 MBsha256:6e8c14d0d58e
docker.io/onyxdotapp/onyx-backend
:nightly-latest-20260626
linux/amd64linux/arm64
2026/06/26 19:10756.0 MBsha256:12501338160c
docker.io/onyxdotapp/onyx-backend
:nightly-latest-20260625
linux/amd64linux/arm64
2026/06/25 19:08756.0 MBsha256:5db276fcdee2
docker.io/onyxdotapp/onyx-backend
:v4.3.0-beta.0
linux/amd64linux/arm64
2026/06/25 05:09756.0 MBsha256:784b1cb6fb8f
docker.io/onyxdotapp/onyx-backend
:nightly-latest-20260624
linux/amd64linux/arm64
2026/06/24 19:10755.6 MBsha256:a82b8d53eb08