跳至主要內容

快速部署指南（Docker Compose 一键部署）

千桐科技2026/11/1大约 3 分钟安装部署一键启动快速上手

说在前面

谁适合看这份指南？

  • 初次接触 qOntology，希望快速体验功能的用户
  • 不想手动配置环境、初始化数据库和逐个启动服务的用户
  • 希望通过脚本一键启动完整平台的用户

使用前请确认

  • 部署过程需要联网下载 Docker 镜像，请确保网络可以正常访问镜像仓库。
  • 中国大陆网络环境下，请提前为 Docker 配置可用的镜像加速地址。
  • Windows 使用 Docker Desktop 时，请切换到 Linux Containers 模式。

Docker 镜像架构

当前部署配置中的 MySQL 5.7 使用 amd64（x86_64） 镜像。arm64 主机运行该镜像需要模拟支持，请确认 Docker 已启用对应能力。

部署包已经包含：

  • ✅ 前端静态资源（打包好的 dist 文件夹）
  • ✅ qOntology 后端服务
  • ✅ MySQL、Redis、Neo4j
  • ✅ Nginx 与文件预览服务
  • ✅ 预设 .env 环境变量文件
  • ✅ 完整目录结构、Docker Compose 配置和一键脚本

无需构建前端或手动初始化数据库。安装 Docker、解压部署包，然后执行对应脚本即可。

第 1 步：安装 Docker 和 Docker Compose

qOntology 通过 Docker 容器运行，部署前必须安装并启动 Docker。

  • Docker：≥ v20.10
  • Docker Compose：≥ v2.20.2
🖥️ Windows / macOS

下载安装 Docker Desktop。Docker Compose 已包含在 Docker Desktop 中，无需单独安装。

安装完成后执行以下命令检查：

docker version
docker compose version

第 2 步：下载部署包

🔗 百度网盘：https://pan.baidu.com/s/1Lw8a4GX2G0m2c7u9CfAC9g

🔑 提取码：加入 QQ 交流群后，在群文件中查看。 👉 点此加入 QQ 交流群

下载并解压后，进入部署包中的 docker 文件夹执行脚本。

第 3 步：执行一键脚本

3.1、Linux / macOS

Linux 和 macOS 使用 qontology.sh，可选择启动或卸载。

命令作用
sh qontology.sh start检查环境、准备镜像并启动 qOntology 及配套服务
sh qontology.sh uninstall卸载 qOntology 容器和网络，保留数据卷及挂载数据

启动

在 docker 文件夹中打开终端，执行：

# 启动 qOntology
sh qontology.sh start

卸载

sh qontology.sh uninstall

按提示输入 DELETE QONTOLOGY 确认卸载。

警告

卸载会删除 qOntology 的容器和网络，保留数据卷及挂载数据。请先备份需要保留的数据。

3.2、Windows

Windows 提供两个脚本：

脚本作用区别
start-all.bat启动 qOntology检查环境、初始化数据库并启动平台及配套服务
uninstall.bat卸载 qOntology删除容器、网络、数据卷、运行数据及未被其他容器使用的相关镜像

怎么执行

进入部署包的 docker 文件夹，双击需要的 .bat 文件即可。

也可以在 PowerShell 或 CMD 中执行：

# 启动 qOntology
.\start-all.bat

# 卸载
.\uninstall.bat

选择哪个脚本？

  • 启动 qOntology：双击 start-all.bat
  • 完整卸载 qOntology：双击 uninstall.bat

卸载时按提示输入 DELETE QONTOLOGY。Windows 完整卸载会删除 qOntology 的容器、网络、数据卷和运行数据，请先备份需要保留的数据。

部署完成！🎉

部署完成后可通过以下地址访问：

  • 🌐 qOntology 本体工程平台

    http://<服务器IP>:8897

    账号：qOntology

    密码：qOntology123

🔑 <服务器IP> 替换成你的服务器公网或内网 IP。访问端口以部署包 .env 中的 EXPOSE_NGINX_PORT 为准，账号密码以初始化数据为准。

💡 重要提醒

  • 建议首次启动后 稍等 1-2 分钟，让所有容器初始化完毕。
  • 可以通过 docker ps 查看容器状态。
  • 如果访问不了，检查服务器防火墙是否开放 8897 端口（或部署包中配置的访问端口）。
最近更新：