部署开源版

qOntology 开源版提供本体建模、语义资产管理及本体应用等能力。可根据验证、研发和运维需求选择部署方式。

部署方式	实现方式	适用场景
Docker Compose 部署	使用仓库中的编排文件，准备前端和配置后分阶段启动应用与中间件	单机试用、功能演示、测试验证，以及由运维人员管理的单机部署
使用源代码本地启动	在本机运行后端和前端，单独准备数据库、缓存及其他依赖	日常开发、功能联调、二次开发
自主部署（纯手工安装）	自行安装运行环境、中间件并部署前后端产物	已有基础设施、组件分离部署、定制网络与运维环境

首次体验建议从 Docker Compose 部署开始。当前仓库提供 Compose 文件，仍需准备同版本前端 dist 和部署配置；没有通用的一键安装入口。

Docker Compose 部署

仓库 docker/ 目录包含 qOntology API、Nginx、MySQL、Redis、Neo4j 和 kkFileView 的编排配置。默认运行数据库为 MySQL，系统入口端口为 8897。

部署过程为：获取项目与配套镜像 → 准备前端 → 修改密码与数据挂载 → 启动中间件 → 启动 API 和 Nginx → 登录验证。

• 无需在部署主机安装后端 JDK / Maven；需要自行构建前端时准备 Node.js 和 npm。
• 使用 docker compose -p qontology --profile all 管理服务，日志与状态检查集中在同一部署目录。
• 当前配置适合单机部署；生产使用需结合数据规模、备份、访问控制和可用性要求设计运行方案。

查看 Docker Compose 部署步骤

使用源代码本地启动

适用于需要修改代码、断点调试或联调前后端的开发人员。

• 后端使用 JDK 17、Maven 3.8+，从 qontology-server 启动应用。
• 前端使用 Node.js 18+ 和 npm，在 qontology-ui 安装依赖并运行开发服务。
• 准备 MySQL、Redis，以及所用功能依赖的 Neo4j、kkFileView；依赖可使用已有服务或容器。
• 本地运行时检查开发配置中的连接地址、账号、端口及前端代理，不能直接使用仅在 Compose 网络中可解析的服务名。

项目内的 README.md、QUICKSTART.md 提供源码运行说明，具体版本以当前 POM、前端清单与实际配置为准。当前 Compose 没有专门的 local profile；不要把其他产品的启动模式直接套用到本项目。

源码入口：qOntology Gitee 仓库。

自主部署（纯手工安装）

由运维人员分别安装 JDK、数据库、缓存、图数据库、预览服务和 Nginx，并部署后端 JAR 与前端 dist。

这种方式可复用现有数据库、统一网关和备份体系，也可以将应用与中间件部署在不同主机。实施时需自行维护服务地址、启动顺序、进程管理、日志、数据目录和恢复流程。

与 Compose 相比，自主部署需要更多环境配置和持续维护工作。准备使用国产操作系统、国产数据库或 ARM 主机时，应先核对目标组合的运行条件，再开展功能和稳定性验证。

部署前需要准备什么

准备项	核对内容
版本配套	源码、后端镜像或 JAR、前端文件、配置和初始化 SQL 来自同一发布版本
网络与资源	可获取镜像或依赖，主机资源满足实际数据量与并发需求，端口未被占用
账号与配置	为数据库、缓存和应用设置独立凭据，检查连接地址及访问入口
数据与恢复	明确数据库和上传文件的持久化位置，已有数据先备份；初始化脚本不用于覆盖业务环境

部署完成后，至少验证登录、项目查询、文件上传下载与预览；图谱及 AI 能力按实际启用范围单独验证。