部署架构图
2026/11/1大约 2 分钟安装部署部署架构Docker Compose
qOntology 采用前后端分离架构，由 Nginx 提供前端资源访问和请求转发，qOntology API 承载业务处理，并连接 MySQL、Redis、Neo4j 等服务。默认使用 Docker Compose 在单台服务器部署，文件预览由 kkFileView 提供，AI 模型与向量服务按需接入。
部署架构图
图中实线表示默认部署链路，虚线表示可选接入链路。默认部署包含六个服务；AI 模型需另行配置，Weaviate 不包含在默认 Compose 编排中，使用时需单独准备。
组件说明
| 组件 | 主要职责 |
|---|---|
| Nginx | 提供前端静态资源，将业务接口、WebSocket 和文件预览请求转发至对应服务 |
| qOntology API | 承载基础管理、本体建模、本体应用等业务处理，访问数据库、缓存及按需配置的外部服务 |
| MySQL | 存储系统配置及业务数据 |
| Redis | 提供缓存服务 |
| Neo4j | 存储和查询图数据，支撑实体与关系的读写 |
| kkFileView | 提供文件在线预览服务 |
| AI 模型服务（可选） | 为启用的 AI 功能提供模型调用能力，需配置可用接口和凭据 |
| Weaviate（可选） | 提供向量存储与检索能力，需单独部署或接入已有服务 |
访问链路
- 页面访问：浏览器访问
http://<服务器IP>:8897，由 Nginx 返回前端页面和静态资源。修改入口端口后，使用实际配置的端口。 - 业务接口：前端通过
/prod-api请求业务接口，通过/websocket/建立实时连接；Nginx 将请求转发至qontology-api:8097，API 按业务需要访问 MySQL、Redis、Neo4j 或可选服务。 - 文件预览：浏览器通过
/kkfileview/发起预览请求，Nginx 转发至kkfileview:8012。预览服务还需能够访问待预览文件的 URL。
以上服务名与内部端口用于 Compose 网络中的服务通信；浏览器统一通过 Nginx 入口访问。该图描述默认单机部署，生产环境可根据资源与可用性要求规划组件分离、数据持久化及备份恢复。