DataEase 本地源码启动详细教程

本教程详细介绍了如何通过本地源码部署DataEase,包括安装IDEA、Maven、JDK,配置Maven仓库,设置数据库连接,编译dataease-plugins和DataEase项目,启动前端和后端服务,以及地图库的准备。此外,还提供了针对Windows和Mac系统的视频教程辅助操作。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

本教程将引导你通过本地源码部署的方式启动 DataEase,同时我还录制了相应的视频教程,你可以跟随视频进行操作:

DataEase 本地源码启动_哔哩哔哩_bilibili

1、下载并安装IDEA开发工具

2、下载安装Mysql 5.7 以及 JDK 1.8

如果你使用的是windows系统,可以参考我录制的视频——“windows系统下的jar包运行”进行学习

DataEase 本地运行之 Windows 系统下的本地 jar 包启动_哔哩哔哩_bilibili

如果你使用的是mac系统,可以参考我录制的视频——“mac系统下的jar包运行”进行学习

DataEase 本地运行之 Mac 系统下的本地 jar 包启动_哔哩哔哩_bilibili

3、下载安装 maven

官网下载地址: http://maven.apache.org

(1)选择一个目录,将下载的Maven压缩包进行解压

(2)添加maven的环境变量配置

# 编辑配置文件
vim ~/.bash_profile

# 添加以下配置(此处配置的路径是我们本地 maven 所在目录下的 bin 文件路径)
export PATH=$PATH:/Users/zhaoqian/maven/apache-maven-3.6.3/bin

# 重新加载使最新的配置生效
source ~/.bash_profile

(3)配置Maven仓库

<!-- 打开maven目录下的 conf/settings.xml 文件,将以下内容复制进去-->
<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
  <!-- localRepository-->
  <localRepository>/Users/zhaoqian/maven/repository</localRepository>

  <pluginGroups>
  </pluginGroups>

  <proxies>
  </proxies>

  <servers>
  </servers>

  <!-- mirrors -->
  <mirrors>
      <!-- 阿里云仓库 -->
      <id>alimaven</id>
      <name>aliyun maven</name>
      <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
      <mirrorOf>central</mirrorOf> 
  </mirrors>

  <profiles>
    <!-- 阿里云配置: 提高国内的jar包下载速度 -->
    <profile>
        <id>ali</id>
        <repositories>
            <repository>
                <id>alimaven</id>
                <name>aliyun maven</name>
                <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
                <releases>
                    <enabled>true</enabled>
                </releases>
                <snapshots>
                    <enabled>true</enabled>
                </snapshots>
            </repository>
        </repositories>
        <pluginRepositories>
            <pluginRepository>
                <id>alimaven</id>
                <name>aliyun maven</name>
                <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
            </pluginRepository>
        </pluginRepositories>
    </profile>
    <!-- 指定Maven的jdk版本 -->
    <profile>     
        <id>JDK-1.8</id>       
        <activation>       
            <activeByDefault>true</activeByDefault>       
            <jdk>1.8</jdk>
        </activation>       
        <properties>       
            <maven.compiler.source>1.8</maven.compiler.source>       
            <maven.compiler.target>1.8</maven.compiler.target>       
            <maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>       
        </properties>       
    </profile>
  </profiles>
</settings>

4、下载安装 node(安装v16.17.0版本)

官网下载地址:Download | Node.js

下载完成后双击安装即可,安装完成后可使用下面的命令查看 npm和 node的版本

# 查看node版本
node -v

# 查看npm版本
npm -v

5、创建并修改dataease项目所使用的本地配置文件

DataEase 会默认加载该路径下的配置文件 /opt/dataease/conf/dataease.properties,请参考下面配置创建对应目录及配置文件。

mkdir -p /opt/dataease/conf
vim dataease.properties

将下面的配置信息复制到配置文件dataease.properties中,提示: 请自行将 MYSQL_HOST 配置为自己的 MySQL 地址。

# 数据库配置
spring.datasource.url=jdbc:mysql://MYSQL_HOST:3306/dataease?autoReconnect=false&useUnicode=true&characterEncoding=UTF-8&characterSetResults=UTF-8&zeroDateTimeBehavior=convertToNull&useSSL=false
spring.datasource.username=root
spring.datasource.password=Password123@mysql

carte.host=kettle
carte.port=18080
carte.user=cluster
carte.passwd=cluster

doris.db=dataease
doris.user=root
doris.password=Password123@doris
doris.host=doris-fe
doris.port=9030
doris.httpPort=8030

#新建用户初始密码
dataease.init_password=DataEase123456
#登录超时时间单位min  如果不设置 默认8小时也就是480
dataease.login_timeout=480

logger.level=INFO

#DE运行模式,可选值有 local、simple、cluster,分别对应本地模式、精简模式、集群模式
engine_mode=simple

6、下载依赖项目 dataease-plugins 工程源码,在本地编译一下

git clone git@github.com:dataease/dataease-extension-sdk.git
# 切换到最新分支(当前最新分支为v1.16)
git fetch
git checkout v1.16

# 使用IDEA打开项目并配置maven仓库
# 逐个构建此项目下的各个子模块,以dataease-plugin-common为例
cd dataease-extension-sdk/dataease-plugin-common
mvn clean install

7、本地下载DataEase项目源码到本地

git clone https://github.com/dataease/dataease.git
# 切换到最新分支(当前最新分支为v1.16)
git fetch
git checkout v1.16

# 使用IDEA打开项目并配置maven仓库
# 注释掉backend目录下的pom.xml文件中关于打包前端的配置(见下方截图)
# 构建并启动后端
mvn clean package
# 启动前端
cd frontend
npm install
npm run serve

8、地图库准备

DataEase 从 1.2 版本开始支持地图组件。在 DataEase 源码工程的目录下有一个地图文件目录 mapFiles/full,需要将该目录下的文件放置到 /opt/dataease/data/feature/full 目录下:

mkdir -p /opt/dataease/data/feature
cd dataease
cp -r mapFiles/full /opt/dataease/data/feature/full

开发小伙伴可以入微信群交流:

### DataEase 在 Windows 上的本地部署方法 #### 准备工作 在开始之前,需要确认已安装 Java 和 Maven 的环境。Java 是运行 JAR 文件的基础,而 Maven 则用于构建和管理项目的依赖项。 - 安装 JDK 并配置 `JAVA_HOME` 环境变量[^1]。 - 下载并安装最新版本的 Apache Maven,并设置好 `MAVEN_HOME` 及将其 bin 路径加入系统的 PATH 中[^2]。 #### 获取 DataEase 源码或预编译包 有两种方式可以获取 DataEase: 1. **通过官方发布的预编译 JAR 包** 访问 DataEase 的 GitHub 发布页面或者相关文档链接下载适合的 JAR 包文件。这种方式适用于不需要修改源码的情况。 2. **克隆源码仓库自行编译** 如果希望自定义功能,则可以从 GitHub 克隆 DataEase 主项目以及扩展 SDK 代码库: ```bash git clone https://github.com/dataease/dataease.git cd dataease # 切换至目标分支 (例如 v1.12) git checkout tags/v1.12 ``` 随后按照说明完成数据扩展 SDK 的同步与安装过程[^3]: ```bash git clone https://github.com/dataease/dataease-extension-sdk.git cd dataease-extension-sdk git checkout tags/v1.12 mvn clean install ``` #### 编译与安装流程 对于基于源码的方式,在成功拉取所需分支之后需依次执行以下命令来准备完整的开发/生产环境: 1. 执行 Maven 清理与安装指令以生成必要的构件: ```bash mvn clean package -DskipTests=true ``` 2. 前端部分单独处理,进入对应的目录下进行 Node.js 或 Yarn 工具支持下的资源打包: ```bash cd frontend npm install || yarn install npm run build || yarn build ``` 3. 返回根路径重新加载整个工程结构确保所有组件间关联无误后再尝试最终组装产物: ```bash cd .. mvn -pl backend spring-boot:run ``` #### 启动服务 当上述准备工作完成后即可正常启动后台服务器,默认监听于 8081 端口之上。此时可通过浏览器打开地址 `http://localhost:8081` 登录默认账户验证是否一切就绪: - 用户名:admin - 密码:dataease 如果有任何异常提示,请参照日志排查可能存在的问题所在位置再做调整优化直至顺利上线为止。 ```python # 示例 Python 版本检测脚本(仅作辅助用途) import platform print(f"当前操作系统为 {platform.system()}") if 'Windows' not in platform.system(): raise EnvironmentError('此指南专为 Windows 设计') ```
评论 14
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值