DataEase 开源 BI 工具快速上手指南一键部署、配置参数解析与 dectl 运维实践【免费下载链接】dataease 人人可用的开源 BI 工具数据可视化神器。An open-source BI tool alternative to Tableau.项目地址: https://gitcode.com/GitHub_Trending/da/dataeaseDataEase 是一款人人可用的开源 BI商业智能工具主打操作简单、上手容易用户无需编写代码即可完成数据接入、图表制作与分享。本文以当前仓库中日文版项目介绍docs/README.ja.md为骨架结合仓库内真实的一键安装脚本、配置模板与容器编排文件系统讲解 DataEase 的快速部署流程、核心配置项含义、后台服务架构以及日常运维命令帮助读者从零开始跑通一套可用的 DataEase 环境并理解其底层实现。DataEase 是什么DataEase 是一个开源的 BI 工具目标是帮助用户快速分析数据、获取业务洞察并据此推动业务改进与优化。它支持接入多种数据源通过拖拽式界面即可完成图表创建并能方便地与团队内其他人共享分析结果。仓库主体分为后端服务core/core-backend、前端应用core/core-frontend与 SDK 扩展sdk安装部署则统一由 installer 目录下的脚本体系承载。四大核心优势开源免费使用无门槛可在线快速获取并安装项目保持每月更新的发布节奏简单易用面向业务人员设计通过鼠标点击与拖拽即可完成数据分析无需编程用途广泛支持多平台安装与多种嵌入方式可灵活集成到现有业务系统安全共享在保障数据安全的前提下提供多种数据共享方式。支持的数据源矩阵DataEase 对数据源的支持覆盖了从传统 OLTP 数据库到数据文件的广泛范围可归纳为五类类别支持的数据源OLTP 数据库MySQL、Oracle、SQL Server、PostgreSQL、MariaDB、Db2、TiDB、MongoDB-BIOLAP 数据库ClickHouse、Apache Doris、Apache Impala、StarRocks数据仓库 / 数据湖Amazon RedShift 等数据文件Excel、CSVAPI 数据源通过 API 接入第三方数据从源码结构看数据源相关的驱动与扩展能力沉淀在 sdk/extensions 与 sdk/api 模块中为上层数据集Dataset与图表引擎提供统一的数据访问抽象。快速开始一条命令完成安装硬件与系统前置条件官方推荐的最小部署环境为2 核 CPU、4GB 及以上内存的 Linux 服务器。安装脚本还会在启动前自动检查运行目录所在磁盘的剩余空间——在 installer/install.sh 的check_and_prepare_env_params函数中当磁盘剩余空间不足 20G 时会打印警告可能无法正常启动。一键安装命令安装脚本会完成从环境检测、Docker 安装到镜像加载与服务启动的全过程。以 root 用户执行一键安装脚本即可curl -sSL https://dataease.oss-cn-hangzhou.aliyuncs.com/quick_start_v2.sh | bash安装完成后使用默认账号登录用户名admin初始密码DataEase123456登录后即可通过浏览器访问部署机器的服务端口默认8100进入 DataEase 控制台开始创建数据集与图表。一键脚本的源码级流程拆解仓库根目录下的 installer/quick_start.sh 是实际执行的一键引导脚本其核心逻辑可拆解为五个阶段网络探测先检测github.com连通性若无法访问则直接退出并提示没有找到稳定的下载服务器版本获取通过 Python 调用 GitHub Releases API按v2.\d.\d的正则匹配过滤预发布版本取最新的正式 v2 版本号并写入/tmp/de_latest_release安装包下载拼接在线安装包文件名dataease-online-installer-${latest_version}-ce.tar.gz并下载-ce后缀对应社区版解压安装解压安装包后进入解压目录调用/bin/bash install.sh执行真正的安装流程失败重试提示下载或解压失败时均会提示重新执行一次安装命令。而 installer/install.sh 是完整的安装主流程其main函数依次执行检查环境并初始化变量 → 设置运行目录 → 初始化运行目录生成.env→ 安装 dectl 命令行工具 → 修改系统设置关闭 SELinux、开放防火墙端口→ 安装 Docker → 安装 docker-compose → 加载 DataEase 镜像 → 配置 systemd 服务 → 启动服务。安装日志会实时写入当前目录的install.log文件。核心配置参数详解安装包内置的 installer/install.conf 是安装阶段的唯一配置入口所有参数以DE_前缀命名安装时会通过source加载并最终写入运行目录的.env文件见 install.sh 中env | grep DE_ .env的逻辑随后由 docker-compose 与环境变量替换机制envsubst注入到各容器与配置模板中。基础配置参数默认值说明DE_BASE/opt安装目录DataEase 运行文件将部署到${DE_BASE}/dataease2.0DE_PORT8100服务访问端口DE_LOGIN_TIMEOUT960登录超时时间分钟不设置则默认 16 小时DE_INSTALL_MODEcommunity安装模式社区版为communityDE_CONTEXT_PATH空动态路径context-path为空时使用根路径数据库配置参数默认值说明DE_EXTERNAL_MYSQLfalse是否使用外部数据库false时由安装包内置 MySQL 容器DE_MYSQL_HOSTmysql-de数据库地址内置部署时同时作为容器名DE_MYSQL_PORT3306数据库端口仅外部数据库时生效DE_MYSQL_DBdataeaseDataEase 使用的库名DE_MYSQL_USERroot数据库用户名DE_MYSQL_PASSWORDPassword123mysql数据库密码如含特殊字符需用双引号包裹例如DE_MYSQL_PASSWORDTest4^%*^DE_MYSQL_PARAMS见原文件JDBC 连接参数含characterEncodingUTF-8、useSSLfalse、allowPublicKeyRetrievaltrue等需要说明的是当使用外部 MySQL 时installer/install.sh 会删除 installer/dataease/docker-compose.yml 中depends_on对内置数据库的健康检查依赖此时 installer/dataease/docker-compose-mysql.yml 不会被加载dectl中也以DE_EXTERNAL_MYSQL ! false为条件决定是否追加该 compose 文件。定时报告与浏览器渲染配置参数默认值说明DE_EXTERNAL_PLAYWRIGHTfalse是否使用外部 Playwright 服务若为true则下述限制参数无效DE_PLAYWRIGHT_SERVERhttp://de-playwright-api:3000/screenshotPlaywright 服务地址用于定时报告截图渲染DE_PLAYWRIGHT_CONCURRENCY4并发渲染数DE_PLAYWRIGHT_SHM_SIZE2gb容器共享内存大小对应 compose 中的shm_size网关与同步模块配置参数默认值说明DE_EXTERNAL_APISIXfalse是否使用外部 APISIX 网关为true时下述端口无效DE_APISIX_DASHBOARD_PORT9000APISIX Dashboard 端口DE_APISIX_PORT9080APISIX 网关端口DE_EXTERNAL_SYNC_TASKfalse是否使用外部同步任务模块其他配置参数默认值说明DE_EXPORT_VIEWS_LIMIT100000视图导出条数上限DE_EXPORT_DATASET_LIMIT100000数据集导出条数上限DE_ORIGIN_LISThttp://localhost:8000允许的跨域来源列表DE_SERVERSdataease节点列表多节点部署时以逗号分隔如192.168.1.101,192.168.1.102DE_SPRING_PROFILE空application.yml中可引入的其他配置文件这些参数最终通过 installer/dataease/templates/application.yml 模板中的${DE_XXX}占位符注入到 Spring Boot 应用配置中包括数据源 URLjdbc:mariadb://...、导出上限、登录超时、跨域列表与 Playwright 服务地址等。后台架构Docker Compose 服务编排DataEase 采用 Docker Compose 进行容器化编排所有服务位于同一个dataease-network网络中。安装完成后各 compose 文件会被复制到运行目录/opt/dataease2.0下由dectl按安装模式动态组合加载。核心服务 dataeaseinstaller/dataease/docker-compose.yml 定义了主服务映射${DE_PORT}:8100端口挂载了conf、logs、static-resource、cache、geo、map、appearance、exportData、plugin、font、i18n、report等一系列数据卷目录将前端静态资源、地图、插件、导出数据等全部持久化到宿主机保证容器重建后数据不丢失。内置数据库 MySQLinstaller/dataease/docker-compose-mysql.yml 定义了内置 MySQL 8.4 容器包含mysqladmin ping健康检查5 秒间隔、3 秒超时、10 次重试通过 installer/dataease/templates/mysql.env 注入数据库初始化环境变量挂载 installer/dataease/templates/my.cnf 自定义配置与初始化 SQL 目录数据持久化到${DE_BASE}/dataease2.0/data/mysql。可选服务APISIX、同步任务与 PlaywrightAPISIX 网关installer/dataease/docker-compose-apisix.yml仅在非社区模式且DE_EXTERNAL_APISIX ! true时启用随附 etcd启用 v2 协议作为配置存储并挂载自定义的cas-auth.lua、hmac-auth.lua认证插件dectl在首次启动时会为 APISIX 生成随机密钥DE_APISIX_KEY并同步写入网关配置与application.yml同步任务模块installer/dataease/docker-compose-task.yml独立的dataease-sync-task容器用于数据同步与任务执行Playwright 渲染服务installer/dataease/docker-compose-playwright.yml提供定时报告截图能力配置了并发数、shm_size、ipc: host与/health健康检查。dectl日常运维命令全览安装完成后系统会安装dectl命令行工具到/usr/local/bin/dectl与/usr/bin/dectl它是 DataEase 的日常运维控制台。其用法如下详见 installer/dectldectl [COMMAND] [ARGS...]命令功能dectl status查看服务运行状态、容器状态、磁盘与日志占用情况dectl start启动服务首次会初始化 APISIX 密钥dectl stop停止服务dectl restart重启服务dectl reload重新加载服务dectl upgrade在线升级自动比对当前版本与最新版本后下载安装包并升级dectl backup备份数据可交互选择是否停服生成dataease-backup-时间戳.tar.gzdectl restore xxx.tar.gz从备份文件还原数据dectl clear-images清理旧版本相关 Docker 镜像与虚悬镜像dectl clear-logs清理历史日志dectl version查看当前版本与最新版本值得说明的实现细节dectl会根据DE_INSTALL_MODE与DE_EXTERNAL_*系列开关动态拼接-f参数决定加载哪些 compose 文件status命令内置健康检查循环最多等待 90 秒通过docker inspect读取容器状态与健康状态直到显示正常运行backup会拒绝在安装目录及其子目录内执行以避免将备份文件打包进自身。技术栈概览依据官方文档声明并结合仓库结构DataEase 的核心技术栈如下前端Vue.js Element 组件库代码位于 core/core-frontend含 500 Vue 组件与图表相关资源可视化基于 AntV 生态实现图表渲染后端Spring Boot 框架代码位于 core/core-backend383 个 Java 源文件配置模板见 installer/dataease/templates/application.yml数据库MySQL内置部署使用 MySQL 8.4 镜像数据处理Apache Calcite 与 Apache SeaTunnel支撑数据集 SQL 解析与数据同步任务基础设施Docker 容器化部署由 docker-compose 编排。安全与许可如果你在使用 DataEase 过程中发现安全漏洞请通过邮件weifit2cloud.com联系项目方反馈。DataEase 采用GNU General Public License version 3GPLv3开源协议授权Copyright (c) 2014-2024 FIT2CLOUD。在该许可条款下软件按现样AS IS提供不附带任何明示或默示的担保关于许可下的权利与限制细节请参阅 GPLv3 全文。结语通过本文你应当已经掌握 DataEase 的核心能力、一键安装流程、全部关键配置参数的含义以及基于 dectl 的日常运维方法同时透过 installer 目录下的脚本与编排文件理解了其容器化部署的底层原理。无论是个人快速体验还是团队内部落地这份指南都可以作为你从部署到运维的完整参考。【免费下载链接】dataease 人人可用的开源 BI 工具数据可视化神器。An open-source BI tool alternative to Tableau.项目地址: https://gitcode.com/GitHub_Trending/da/dataease创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考