ghcr.io/import-ai/omnibox-backend:sha-d0df6de
ghcr.iolinux/amd64sha-d0df6de大小: 467.86 MB更新于 2026年9月14日
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这段话即可：
请先阅读并遵守：https://xuanyuan.cloud/agents.md
未读文档前不要生成 pull 命令或排错方案。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
OmniBox Backend
项目介绍
OmniBox Backend 是基于 NestJS 框架开发的后端服务，提供用户认证、文件管理、对话管理等功能。
主要功能
文件管理
- 支持文件上传、下载及管理
- 集成 MinIO 对象存储
对话管理
- 支持多用户对话
- 消息历史记录
权限管理
- 基于命名空间的权限控制
- 用户组管理
- 资源权限分配
开发指南
Docker 部署
- 监视与调试模式
docker compose -f base.yaml -f dev.yaml up -d
- 构建模式
docker compose -f base.yaml -f build.yaml up -d --build
- 使用持久化 postgres 和 minio 数据运行
docker compose ... -f persistence.yaml ...
- 使用 pgadmin 运行
docker compose ... -f pgadmin.yaml ...
然后使用以下信息登录：
| Name | Value |
|---|---|
| Username | *** |
| Password | Passw0rd |
omnibox@qq.com Passw0rd
本地运行
# 环境搭建
$ pnpm install
# 开发模式
$ pnpm run start
# 监视模式
$ pnpm run start:dev
# 生产模式
$ pnpm run start:prod
应用协议兼容性
原生应用在 API 和 SSE 请求中会发送 X-Client-Platform（android / ios）、X-Client-Version（已安装二进制文件的 major.minor.patch 格式）和 X-Client-Build（诊断构建标识符）。功能阈值集中在 src/utils/client-features.ts 中；对话图片要求两个平台的版本均为 0.1.50 或更高。这些头信息从不授予权限。
X-Client-Platform android ios X-Client-Version major.minor.patch X-Client-Build src/utils/client-features.ts
低于阈值的应用，或版本缺失/无效的应用，接收的历史记录和 SSE 响应中将不包含图片显示部分。纯图片消息会收到本地化的升级提示。已存储的消息和重放缓冲区保持不变。只有明确标记为 X-Client-Platform: web 的请求会保留完整表示，且无版本阈值要求。缺失/未知平台以及缺失/无效的原生版本将使用兼容表示。User-Agent 和请求通道不用于功能协商。Web 客户端的头信息变更需与本后端变更一同部署。
云部署还必须更新 backend-pro 的 core 修订版，因为它提供命名空间/共享向导的 SSE 路由。
技术栈
- 框架：NestJS
- 数据库：PostgreSQL + TypeORM
- 对象存储：MinIO
- 认证：JWT + Passport
- 邮件服务：Nodemailer
- 搜索：Meilisearch
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"