**目录**
[一、本地环境要求](#%E4%B8%80%E3%80%81%E6%9C%AC%E5%9C%B0%E7%8E%AF%E5%A2%83%E8%A6%81%E6%B1%82)
[二、快速部署](#%E4%BA%8C%E3%80%81%E4%B8%8B%E8%BD%BD%E8%8E%B7%E5%8F%96%E9%A1%B9%E7%9B%AE%E6%BA%90%E7%A0%81)
[（一）、使用Docker Compose部署（推荐）](#%EF%BC%88%E4%B8%80%EF%BC%89%E3%80%81%E4%BD%BF%E7%94%A8Docker%20Compose%E9%83%A8%E7%BD%B2%EF%BC%88%E6%8E%A8%E8%8D%90%EF%BC%89)
[1、安装 Docker 和 Docker Compose](#1%E3%80%81%E5%AE%89%E8%A3%85%20Docker%20%E5%92%8C%20Docker%20Compose)
[2、下载部署包](#2%E3%80%81%E4%B8%8B%E8%BD%BD%E9%83%A8%E7%BD%B2%E5%8C%85)
[3、启动qData](#3%E3%80%81%E5%90%AF%E5%8A%A8qData)
[3.1、配置.env文件](#3.1%E3%80%81%E9%85%8D%E7%BD%AE.env%E6%96%87%E4%BB%B6)
[3.2、初始化数据库](#3.2%E3%80%81%E5%88%9D%E5%A7%8B%E5%8C%96%E6%95%B0%E6%8D%AE%E5%BA%93)
[3.3、启动qData](#3.3%E3%80%81%E5%90%AF%E5%8A%A8qData)
 [4、访问qData](#%C2%A04%E3%80%81%E8%AE%BF%E9%97%AEqData)
  [(二)、源码本地部署](#%C2%A0%20\(%E4%BA%8C\)%E3%80%81%E6%BA%90%E7%A0%81%E6%9C%AC%E5%9C%B0%E9%83%A8%E7%BD%B2)
[1、本地环境要求](#1%E3%80%81%E6%9C%AC%E5%9C%B0%E7%8E%AF%E5%A2%83%E8%A6%81%E6%B1%82)
[2、克隆仓库](#2%E3%80%81%E5%85%8B%E9%9A%86%E4%BB%93%E5%BA%93)
[3、使用Docker Compose启动中间件](#3%E3%80%81%E4%BD%BF%E7%94%A8Docker%20Compose%E5%90%AF%E5%8A%A8%E4%B8%AD%E9%97%B4%E4%BB%B6)
[4、启动qdata-server服务](#4%E3%80%81%E5%90%AF%E5%8A%A8qdata-server%E6%9C%8D%E5%8A%A1)
[5、启动qdata-quality服务](#5%E3%80%81%E5%90%AF%E5%8A%A8qdata-quality%E6%9C%8D%E5%8A%A1)
[6、启动前端服务](#6%E3%80%81%E5%90%AF%E5%8A%A8%E5%89%8D%E7%AB%AF%E6%9C%8D%E5%8A%A1)
[7、重置admin密码](#7%E3%80%81%E9%87%8D%E7%BD%AEadmin%E5%AF%86%E7%A0%81)
[8、访问qData](#8%E3%80%81%E8%AE%BF%E9%97%AEqData)


----
  
  
# 一、本地环境要求

在本地部署qData需要有以下环境要求：
后端：
```
 &nbsp; &nbsp; &nbsp;  jdk推荐版本1.8或以上，建议使用OpenJDK8或者11；
​
 &nbsp; &nbsp; &nbsp;  Maven推荐版本3.6+；
​
 &nbsp; &nbsp; &nbsp;  达梦数据库推荐版本8.0；
​
 &nbsp; &nbsp; &nbsp;  Redis推荐版本5.0+；
​
 &nbsp; &nbsp; &nbsp;  RabbitMQ（可选）
​
 &nbsp; &nbsp; &nbsp;  MySQL推荐版本5.7或8.0；
​
 &nbsp; &nbsp; &nbsp;  Redis推荐版本5.0+；
​
 &nbsp; &nbsp; &nbsp;  操作系统推荐Windows/Linux/Mac，本次使用Windows进行演示。
```前端：
```
 &nbsp; &nbsp; &nbsp;  Node.js推荐版本16+；
​
 &nbsp; &nbsp; &nbsp;  npm推荐版本10+；
​
 &nbsp; &nbsp; &nbsp;  Vite 推荐最新版。
```# 二、快速部署

  
## （一）、使用Docker Compose部署（推荐）

### **1、安装 Docker 和 Docker Compose**

推荐安装版本：
```
Docker：>= v19.03
​
Docker Compose：>= v2.20.2
```Docker Desktop下载地址：`https://www.docker.com/products/docker-desktop/`
**安装Docker Desktop会包含Docker Compose，无需额外安装。**
- **Docker compose 安装验证**

在 PowerShell 或 CMD 中输入命令：docker compose version
![image](https://developer.qcloudimg.com/http-save/yehe-12355781/c19b0f55b1121e5289e61b4e5275fb6b.png)​
### 2、下载部署包

  部署包进入qq交流群查看群文件，[点击加入qq群](https://qknow.qiantong.tech/discuss.html#%E5%8A%A0%E5%85%A5qq%E4%BA%A4%E6%B5%81%E7%BE%A4)。
  获取部署包后请解压。
### 3、启动qData

  打开部署包，内部有一个docker.zip压缩包，请先解压该压缩包。
![image](https://developer.qcloudimg.com/http-save/yehe-12355781/12f13d6e67ca542348981d7e44cae0b9.png)
#### 3.1、配置.env文件

  进入docker解压位置
  修改`.env文件`
  修改为`MySQL`作为主库
若使用达梦数据库跳过该步骤即可 ![image](https://developer.qcloudimg.com/http-save/yehe-12355781/0b341bd2f6668e2026fb287f262ecf1d.png)
#### 3.2、初始化数据库

  在当前目录下执行以下命令进行初始化数据库
- 在运行该命令前请先检查所涉及的端口是否被占用，否则会导致命令执行失败

```
docker-compose --profile schema up -d
​
# 如果使用 MySQL 作为主库，请执行： &nbsp;
docker-compose -f docker-compose-mysql.yml --profile schema up -d
```#### **3.3、启动qData**

  执行以下命令启动qData和所有依赖
```
 docker-compose --profile all up -d
​
 # 如果使用 MySQL作为主库，请执行： &nbsp;
 docker-compose -f docker-compose-mysql.yml --profile all up -d
```  启动本地源码
- ⚠️注意：如果遇到报错请检查镜像源、网络、端口是否被占用问题。

```
 docker-compose --profile local up -d
​
 # 如果使用 MySQL作为主库，请执行： &nbsp;
 docker-compose -f docker-compose-mysql.yml --profile all up -d
```![image](https://developer.qcloudimg.com/http-save/yehe-12355781/4b0b33b1568349ba7500cf33407dc275.png)
### 4、访问qData

 直接访问：http://localhost:80 
  初始账号：admin
  初始密码：qData123
![image](https://developer.qcloudimg.com/http-save/yehe-12355781/fc0af2c221053a5a4c451d50d95b4231.png)
![image](https://developer.qcloudimg.com/http-save/yehe-12355781/f18f81320621b6f7f0a3d15447ef0a06.png)
```
 ⚠️注意：如果页面打不开请重启一下docker
```![image](https://developer.qcloudimg.com/http-save/yehe-12355781/1f2ca90865d815833c51387d65ce1829.png)
## (二)、源码本地部署

### 1、本地环境要求


|组件|版本要求|
|:-:|:-:|
|JDK|1.8|
|Maven|3.6+|
|yarn|v1.22.22+|
|Node.js|18.0+|
|Docker|19.03 or later|
|Docker Compose|1.28 or later|
### 2、克隆仓库

- 从Gitee或者GitHub仓库进行克隆仓库或者直接下载zip源码包。

Gitee仓库地址：`https://gitee.com/qiantongtech/qData`
GitHub仓库地址：`https://github.com/qiantongtech/qData`
本次拿Gitee作为演示：
![image](https://developer.qcloudimg.com/http-save/yehe-12355781/01b3b74b81c70e1fb32b108d860d2314.png) ![image](https://developer.qcloudimg.com/http-save/yehe-12355781/c4e93651de5e63422c6c26f74873aa14.png)
### 3、使用Docker Compose启动中间件

- qData后端依赖以下中间件
- 数据库：DM8/MySQL、PostgreSQL
- 缓存与消息队列：Redis、RabbitMQ
- 文件与存储：MongoDB、Hadoop、kkFileView
- 调度：DolphinScheduler

通过 Docker Compose 启动中间件：
```
 # Docker Compose 部署文档中的本地源码模式 &nbsp;
 docker-compose --profile local up -d
```4、启动后端项目
  使用**IntelliJ IDEA** 或者其他开发工具打开项目
  利用Maven引入依赖
  必要配置（`application-dev.yml`）：
**qdata-server配置**
  修改RabbitMQ连接信息，编辑 `qdata-server/src/main/resources/application-dev.yml`
```
   spring:  
   rabbitmq:  
     host: IP  
     port: 端口  
     username: 账户  
     password: 密码
```  修改数据库连接信息，编辑 `qdata-server/src/main/resources/application-dev.yml`
```
 # 主数据源选择  
 datasource:  
   type: mysql # mysql 或 dm8,填写哪个就修改下面对应的的配置信息  
     
 # MySQL配置  
 mysql:  
   # JDBC驱动类名  
   driver-class-name: com.mysql.cj.jdbc.Driver  
   # 主库JDBC连接URL  
   url: jdbc:mysql://IP:端口/qdata?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8  
   # 主库用户名  
   username: 账号  
   # 主库密码  
   password: 密码  
     
 # 达梦数据库配置  
 dm8:  
   # JDBC驱动类名  
   driver-class-name: dm.jdbc.driver.DmDriver  
   # 主库JDBC连接URL  
   url: jdbc:dm://IP:端口/QDATA?STU&zeroDateTimeBehavior=convertToNull&useUnicode=true&characterEncoding=utf-8&schema=QDATA&serverTimezone=Asia/Shanghai  
   # 主库用户名  
   username: 账号  
   # 主库密码  
   password: 密码
```  修改调度器相关配置，编辑 `qdata-server/src/main/resources/application-dev.yml`
```
 #调度器相关配置  
 ds:  
   # 调度器api前缀  
   base\_url: http://IP:12345/dolphinscheduler  
   # 数据质量服务组件HTTP回调地址  
   quality\_url: http://127.0.0.1:8083/quality/qualityTaskExecutor/runExecuteTask  
   # 数据质量任务dolphinscheduler项目编码  
   http\_quality\_projectCode: 134799536571008  
   # 调度器令牌（可以自行修改）  
   token: b07f0e57c4818043a57ba05a28da291a  
   # spark相关配置  
   spark:  
     #spark-master的地址  
     master\_url: spark://IP:7077  
     #jar包在ds的路径  
     main\_jar: file:/dolphinscheduler/default/resources/spark-jar/qdata-etl-3.8.8.jar  
     #jar main入口  
     main\_class: tech.qiantong.qdata.spark.etl.EtlApplication  
   # hdfs相关配置  
   hdfs:  
     #NameNode RPC地址（客户端连接 HDFS 的入口地址）  
     url: hdfs://IP:端口

修改数据质量服务相关配置，编辑 qdata-server/src/main/resources/application-dev.yml

 path:  
   # 数据质量服务前缀  
   quality\_url: http://127.0.0.1:8083/quality/qualityTaskExecutor
```**qdata-quality配置**
  修改RabbitMQ连接信息，编辑 `qdata-quality/src/main/resources/application-dev.yml`
```
 spring:  
   rabbitmq:  
     host: IP  
     port: 端口  
     username: 账户  
     password: 密码
```  修改MongoDB连接信息，编辑 `qdata-quality/src/main/resources/application-dev.yml`
```
 spring:  
   data:  
     mongodb:  
       # 连接地址  
       uri: mongodb://账户:密码@IP:端口/data?authSource=admin  
       field-naming-strategy: org.springframework.data.mapping.model.SnakeCaseFieldNamingStrategy  
       print: true  
       slowQuery: true  
       slowTime: 1000
```  修改数据库连接信息，编辑 `qdata-quality/src/main/resources/application-dev.yml`
```
 # 主数据源选择  
 datasource:  
   type: mysql # mysql 或 dm8,填写哪个就修改下面对应的的配置信息  
     
 # MySQL配置  
 mysql:  
   # JDBC驱动类名  
   driver-class-name: com.mysql.cj.jdbc.Driver  
   # 主库JDBC连接URL  
   url: jdbc:mysql://IP:端口/qdata?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8  
   # 主库用户名  
   username: 账号  
   # 主库密码  
   password: 密码  
     
 # 达梦配置  
 dm8:  
   # JDBC驱动类名  
   driver-class-name: dm.jdbc.driver.DmDriver  
   # 主库JDBC连接URL  
   url: jdbc:dm://IP:端口/QDATA?STU&zeroDateTimeBehavior=convertToNull&useUnicode=true&characterEncoding=utf-8&schema=QDATA&serverTimezone=Asia/Shanghai  
   # 主库用户名  
   username: 账号  
   # 主库密码  
   password: 密码
```  修改RabbitMQ连接信息，编辑 `qdata-quality/src/main/resources/application-dev.yml`
```
 spring:  
   rabbitmq:  
     host: IP  
     port: 端口  
     username: 账户  
     password: 密码
```### 4、启动qdata-server服务

  运行 `qdata-server/src/main/java/tech/qiantong/qdata/server/QDataApplication.java`
### 5、启动qdata-quality服务

  运行 `qdata-quality/src/main/java/tech/qiantong/qdata/quality/QualityApplication.java`
### 6、启动前端服务

```
 # 进入前端目录  
 cd qdata-ui
   
 # 安装依赖  
 yarn install
    
 # 启动  
 yarn run dev
```### 7、重置admin密码

```
 #在数据库中执行下面的SQL  
 UPDATE SYSTEM\_USER  
 SET PASSWORD='密码'  
 WHERE USER\_ID=1;
```### 8、访问qData

  在浏览器中打开：`http://localhost:81`
  默认账户/密码：admin/qData123
![image](https://developer.qcloudimg.com/http-save/yehe-12355781/1687292aa674743dd6cc28498d49cec1.png)
![image](https://developer.qcloudimg.com/http-save/yehe-12355781/3995f0fc5525d82cb61272f349b371ad.png)

目录一、本地环境要求二、快速部署（一）、使用Docker Compose部署（推荐）1、安装 Docker 和 Docker Compose2、下载部署包3、启动qData3.1、配置.env文件3.2、初始化数据库3.3、启动qData 4、访问qData  (二)、源码本地部署1、本地环境要求2、克隆仓库3、使用Docker Compose启动中间件4、启动qdata-server服务5、启动qdata-quality服务6、启动前端服务7、重置admin密码8、访问qData

qData本地部署

目录一、本地环境要求二、快速部署（一）、使用Docker Compose部署（推荐）1、安装 Docker 和 Docker Compose2、下载部署包3、启动qData3.1、配置.env文件3.2、初始化数据库3.3、启动qData 4、访问qData  (二)、源码本地部署1、本地环境要求2、克隆仓库3、使用Docker Compose启动中间件4、启动qdata-server服务5、启动

数据库

开发工具

后端

qData部署指南：提供两种部署方式（DockerCompose推荐部署和源码本地部署），包含详细环境要求、数据库配置、服务启动步骤和访问方法。支持MySQL/达梦数据库，集成Redis、RabbitMQ等中间件，初始账号admin/qData123。

消息队列

PostgreSQL

中间件

Windows

MongoDB

GitHub

Docker

Hadoop 

Redis

Linux

MySQL

HDFS

2026采购季 | AI焕新·智启新局

tencentdb-catalog

腾讯云数据库特惠，新用户首单0.5折起


message-queue-catalog

mongodb

postgres

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

qData本地部署-腾讯云开发者社区-腾讯云

qData本地部署

qData本地部署

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐