使用源代码本地启动qData数据中台开源版 —— 开发者快速上手指南

qData 数据中台开源版，支持数据接入、建模、治理与服务的全生命周期管理。本文将带你从源码快速搭建本地环境，体验 qData 开源版的全部功能。

1. 环境准备

在开始之前，请确保已安装以下环境：

💡 建议在 Linux 服务器或虚拟机中运行 Docker 相关组件。

2. 克隆源码

git clone https://gitee.com/qiantongtech/qData.git

3. 启动中间件

qData 依赖 MySQL/DM8、PostgreSQL、Redis、RabbitMQ、MongoDB、Hadoop、kkFileView、DolphinScheduler 等组件。

通过 Docker Compose 启动：

docker-compose --profile local up -d

📖 详细参考：Docker Compose 部署文档

4. 启动后端服务

4.1 构建项目

mvn clean install -DskipTests=true

4.2 启动服务

• 启动 qdata-server 运行：QDataApplication.java
• 启动 qdata-quality 运行：QualityApplication.java

⚠️ 如果需要连接自建数据库或修改中间件地址，请在 application-dev.yml 中调整配置。

5. 启动前端

5.1 安装依赖

cd qdata-ui
yarn install

5.2 启动前端

yarn run dev

5.3 登录系统

浏览器访问： http://localhost:81

默认账号密码：

• 用户名：admin
• 密码：qData123

若能成功进入系统并显示菜单，即说明部署完成！ 🎉

6. 常见问题

1. 端口占用 → 确认本机 MySQL、Redis、RabbitMQ 等端口未被占用。
2. 前端页面空白 → 请检查 Node.js / yarn 版本，或查看浏览器控制台错误。
3. 构建失败 → 添加 -DskipTests=true 避免单元测试导致中断。