零基础必看！Seatunnel Web 源码编译指南
零基础必看！Seatunnel Web 源码编译指南
文章目录
- 零基础必看！Seatunnel Web 源码编译指南
-
- 下载 Seatunnels
-
- 安装插件
- 验证是否启动成功
- 下载 Seatunnel Web 源码
- 配置 Seatunnel Web
-
- 初始化 MySQL
- 修改项目MySQL配置
- 修改JWT值
- 配置启动参数
- Build 项目
- 配置环境变量
- 配置 MySQL 依赖
- 启动 Seatunnel Web 后端服务
- 启动 Seatunnel Web 前端服务
在 Windows 环境中搭建和开发 Seatunnel Web 涉及多个步骤。本文将详细介绍从下载 Seatunnel、安装插件、配置环境到启动 Seatunnel Web 服务的全过程。通过本教程，您可以在本地环境中成功运行 Seatunnel Web，并进行进一步的开发和调试。
下载 Seatunnels
首先，需要从官方的下载页面获取 Seatunnel 的安装包：https://seatunnel.apache.org/download/
下载后，解压安装包，并进入解压后的文件夹。解压步骤完成后，您便可以开始安装和配置 Seatunnel。
安装插件
安装所需插件。打开终端窗口，进入到 Seatunnel 解压目录的 bin 文件夹，然后执行以下命令来安装插件：
.\\bin\\install-plugin.cmd```避坑实录｜### 启动 Seatunnel安装完成后，可以启动 Seatunnel 服务。使用以下命令启动 Seatunnel：```Bash.\\bin\\seatunnel-cluster.cmd -d此命令将启动 Seatunnel 集群服务并进入后台模式。
验证是否启动成功
为了确保 Seatunnel 启动成功，执行以下命令运行一个简单程序验证运行状态：
.\\bin\\seatunnel.cmd --config ./config/v2.batch.config.template -m local运行成功可以看到日志
50953630433281] 2025-05-12 21:28:09,243 INFO org.apache.seatunnel.engine.server.dag.physical.PhysicalPlan - Job SeaTunnel_Job (974150953630433281), Pipeline: [(1/1)] future complete with state FINISHED[974150953630433281] 2025-05-12 21:28:09,244 INFO org.apache.seatunnel.engine.server.dag.physical.PhysicalPlan - Job SeaTunnel_Job (974150953630433281) turned from state RUNNING to FINISHED.[974150953630433281] 2025-05-12 21:28:09,244 INFO org.apache.seatunnel.engine.server.dag.physical.PhysicalPlan - Job SeaTunnel_Job (974150953630433281) state process is stop[] 2025-05-12 21:28:09,267 INFO org.apache.seatunnel.engine.client.job.ClientJobProxy - Job (974150953630433281) end with state FINISHED[] 2025-05-12 21:28:09,324 INFO org.apache.seatunnel.core.starter.seatunnel.command.ClientExecuteCommand -*********************************************** Job Statistic Information***********************************************Start Time : 2025-05-12 21:28:06End Time : 2025-05-12 21:28:09Total Time(s) : 3Total Read Count : 32Total Write Count : 32Total Failed Count : 0***********************************************下载 Seatunnel Web 源码
Seatunnel Web 是 Seatunnel 的 Web 管理界面，可以方便地监控和管理数据任务。您可以从 GitHub 下载 Seatunnel Web 的源码：https://github.com/apache/seatunnel-web
下载完成后，使用 IntelliJ IDEA 或其他 IDE 打开项目。
配置 Seatunnel Web
初始化 MySQL
Seatunnel Web 需要 MySQL 数据库来存储任务和配置等信息。您需要导入 seatunnel-server/seatunnel-app/src/main/resources/script/seatunnel_server_mysql.sql 文件到数据库。该 SQL 文件将自动创建所需的数据库和表。
修改项目MySQL配置
修改 Seatunnel Web 的配置文件，指定 MySQL 数据库的连接信息。找到 application.yml 文件，修改 datasource 配置：
spring: application: name: seatunnel jackson: date-format: yyyy-MM-dd HH:mm:ss datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/seatunnel?useSSL=false&useUnicode=true&characterEncoding=utf-8&allowMultiQueries=true&allowPublicKeyRetrieval=true username: root password: root修改JWT值
Seatunnel Web 使用 JWT（JSON Web Token）来进行用户身份验证。你可以选择使用默认的密钥值，也可以根据需要更改它。修改 jwt 配置：
jwt: expireTime: 86400 # please add key when deploy secretKey: n2r5u8x/A?D(G+KbPeShVmYq3s6v9y$B&E)H@McQfTjWnZr4u7w!z%C*F-JaNdRgU algorithm: HS256配置启动参数
在启动类seatunnel-server/seatunnel-app/src/main/java/org/apache/seatunnel/app/SeatunnelApplication.java中配置
-DSEATUNNEL_HOME=D:\\apache-seatunnel-2.3.8
Build 项目
启动时需要配置Build后的文件
.\\build.cmd codebuild成功后会出现这个目录：seatunnel-web-dist/target/apache-seatunnel-web-1.0.3-SNAPSHOT/apache-seatunnel-web-1.0.3-SNAPSHOT
配置环境变量
配置环境变量 ST_WEB_BASEDIR_PATH，将其指向构建后的文件路径：
ST_WEB_BASEDIR_PATH : D:\\IDEAProjects\\stweb\\seatunnel-web-dist\\target\\apache-seatunnel-web-1.0.3-SNAPSHOT\\apache-seatunnel-web-1.0.3-SNAPSHOT
配置 MySQL 依赖
编辑 seatunnel-server/seatunnel-app/pom.xml 文件，确保将 MySQL 依赖的 配置项从 test 移除：
<dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>${mysql.version}</version></dependency>启动 Seatunnel Web 后端服务
启动后端服务，通过seatunnel-server/seatunnel-app/src/main/java/org/apache/seatunnel/app/SeatunnelApplication.java启动类运行。
成功启动后，您将看到类似如下的日志，表示服务已成功启动：
启动 Seatunnel Web 前端服务
进入前端项目目录 seatunnel-ui，并使用以下命令安装依赖并启动前端服务：
cd seatunnel-uinpm installnpm run dev成功启动后，您将看到以下信息，表明前端服务已经启动，并可以通过浏览器访问：
VITE v4.5.5 ready in 1742 ms ➜ Local: http://localhost:5173/ ➜ Network: use --host to expose ➜ press h to show help默认账号和密码为：admin/admin。访问 http://localhost:5173/，输入账号密码即可登录。
通过本教程，您已成功在 Windows 环境中搭建并运行了 Seatunnel 和 Seatunnel Web 服务。接下来，您可以根据需求进行二次开发 Seatunnel Web。希望本文对您的开发工作有所帮助！
