跳至主要內容

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

千桐科技2025/9/3大约 4 分钟安装部署一键启动快速上手

说在前面

谁适合看这份指南？

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

使用前请确认

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

Docker 镜像支持双架构

本部署包使用的 Docker 镜像同时支持 amd64（x86_64） 和 arm64 架构。拉取镜像时，Docker 会根据当前主机的 CPU 架构自动选择对应版本，无需手动切换镜像标签。

部署包已经包含：

  • ✅ 前端静态资源（打包好的 dist 文件夹）
  • ✅ DolphinScheduler 调度器
  • ✅ Hadoop（HDFS + YARN）
  • ✅ Spark 3.5.6
  • ✅ 预设 .env 环境变量文件
  • ✅ 完整目录结构、Docker Compose 配置和一键脚本

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

Docker 镜像中已安装 Python 3，宿主机无需单独安装 Python。

第 1 步：安装 Docker 和 Docker Compose

qData 通过 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/1sKgeBnMZmRnIr42_pVHmiw

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

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

第 3 步：执行一键脚本

3.1、Linux / macOS

Linux 和 macOS 使用 qdata.sh，可选择轻量启动、完整启动或卸载。

命令作用
sh qdata.sh start light --demo启动 qData 轻量环境，同时启动 Demo 演示数据库，不启动 DolphinScheduler 和 Spark
sh qdata.sh start all --demo启动 qData 完整环境，同时启动 Demo 演示数据库
sh qdata.sh uninstall卸载 qData，并删除容器、数据和相关镜像

启动

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

# 轻量启动
sh qdata.sh start light --demo

# 完整启动
sh qdata.sh start all --demo

卸载

sh qdata.sh uninstall

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

警告

卸载会删除 qData 的容器和运行数据，请先备份需要保留的数据。

3.2、Windows

Windows 提供三个脚本：

脚本作用区别
start-light.bat启动轻量版 qData不启动 DolphinScheduler 和 Spark，启动更快、占用资源更少
start-all.bat启动完整版 qData启动 DolphinScheduler、Spark 等完整依赖服务
uninstall.bat卸载 qData删除容器、数据和相关镜像

怎么执行

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

也可以在 PowerShell 或 CMD 中执行：

# 启动轻量版
.\start-light.bat

# 启动完整版
.\start-all.bat

# 卸载
.\uninstall.bat

选择哪个启动脚本？

  • 只想快速体验 qData：运行 start-light.bat
  • 需要 DolphinScheduler、Spark 等完整功能：运行 start-all.bat

卸载时按提示输入 DELETE QDATA。卸载会删除 qData 的容器和运行数据，请先备份需要保留的数据。

部署完成！🎉

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

  • 🌐 qData 数据中台
    http://<服务器IP>:80
    账号：admin
    密码：qData123

  • 📅 调度器 DolphinScheduler
    http://<服务器IP>:12345/dolphinscheduler/ui/home
    账号：admin
    密码：dolphinscheduler123

⚠️ DolphinScheduler 只在完整版中启动。

🔑 <服务器IP> 替换成你的服务器公网或内网 IP。

💡 重要提醒

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