5分钟快速上手DataCap

通过本指南,您将在5分钟内完成DataCap的本地部署并登录系统,体验多数据源管理的基本功能。

环境要求

支持的操作系统

macOS Windows Linux

运行环境

Java >= 11 必需

所需工具

Git

克隆项目代码

必需
Maven

构建项目

必需

操作步骤

1

克隆项目代码

从GitHub克隆DataCap项目到本地

克隆主仓库
git clone https://github.com/devlive-community/datacap.git
进入项目目录
cd datacap

预期结果:成功下载项目文件,进入datacap目录

如果网络较慢,可以使用GitHub镜像源或下载ZIP包

2

构建项目

使用Maven编译打包DataCap

跳过测试以加快构建速度
mvn clean package -DskipTests

预期结果:看到BUILD SUCCESS提示,在target目录生成datacap-*.jar文件

首次构建可能需要下载依赖,请耐心等待

3

启动应用

运行DataCap服务

启动DataCap服务
java -jar target/datacap-*.jar

预期结果:看到Spring Boot启动日志,最后出现类似"Started Application in X seconds"的提示

默认端口为9090,如果端口冲突可在启动时添加--server.port参数

4

访问系统

在浏览器中打开DataCap管理界面

预期结果:打开浏览器访问 http://localhost:9090,看到登录页面

如果无法访问,请检查防火墙设置或确认服务是否正常启动

5

登录系统

使用默认账号登录

预期结果:成功登录进入DataCap主界面

可以使用datacap/123456789或admin/12345678登录

验证成功

成功登录DataCap系统并看到管理界面

浏览器显示DataCap登录页面
使用默认账号成功登录
看到DataCap主界面,包含数据源管理、查询等菜单

快速提示

配置

启动时添加--spring.profiles.active=dev参数可启用开发模式

配置

默认使用H2内存数据库,重启后数据会丢失,生产环境需配置MySQL等外部数据库

调试

查看logs目录下的日志文件可获取详细运行信息

常见问题

1

Maven构建失败,提示依赖下载错误

检查网络连接,或尝试使用阿里云镜像:在settings.xml中配置阿里云Maven镜像源

2

端口9090被占用

停止占用该端口的程序,或修改启动命令:java -jar target/datacap-*.jar --server.port=9091

3

Java版本不兼容

确保Java版本>=11,使用java -version检查版本,必要时升级Java

4

登录失败,提示账号密码错误

确认使用正确的默认账号:datacap/123456789 或 admin/12345678

下一步

添加第一个数据源

尝试连接MySQL或ClickHouse等数据库

执行SQL查询

在查询界面编写并执行跨数据源查询

创建可视化图表

基于查询结果创建柱状图、折线图等可视化图表

查看官方文档

访问项目GitHub页面了解更多高级功能

助手