DataEase 离线部署：4 核 8G + 8100 端口，外部 MySQL 有 3 个参数必须改

项目信息

仓库信息：License GPL-3.0，默认分支 dev-v2，主语言 Java，24.4k star，由 FIT2CLOUD 飞致云维护。DataEase 定位是开源 BI 工具，用来做数据分析和业务趋势洞察，图表靠拖拉拽生成并分享。

技术栈与数据源

• 前端 Vue.js + Element，图表库 AntV
• 后端 Spring Boot
• 数据库 MySQL
• 数据处理 Apache Calcite + Apache SeaTunnel
• 部署基础设施 Docker
• AI 能力集成 SQLBot 实现智能问数

数据源按类型分：

• OLTP：MySQL、Oracle、SQL Server、PostgreSQL、MariaDB、Db2、TiDB、MongoDB-BI 等
• OLAP：ClickHouse、Apache Doris、Apache Impala、StarRocks 等
• 数据仓库/数据湖：Amazon RedShift 等
• 数据文件：Excel、CSV
• API 数据源

快速试用

一台 2 核 4G 以上的 Linux 服务器，root 执行：

curl -sSL https://dataease.oss-cn-hangzhou.aliyuncs.com/quick_start_v2.sh | bash

默认账号 admin，密码 DataEase@123456。这条脚本面向演示和试用，生产环境走离线安装包那条路。

离线部署

环境要求

• 操作系统：Ubuntu 22.04 / CentOS 7.6 64 位
• CPU/内存：4 核 8G
• 磁盘：200G
• Docker：版本太旧会导致安装失败，建议用安装包内自带的 Docker，或 v23.0.5 及以上

下载与端口

从 community.fit2cloud.com 的下载页拿离线安装包，复制到 /tmp。

端口占用两个：

• 22：SSH，安装与升级管理使用
• 8100：Web 服务端口，默认值，可以改

解压与 install.conf

cd /tmp
tar zxvf dataease-online-installer-v2.0.0.tar.gz
cd dataease-online-installer-v2.0.0
/bin/bash install.sh

install.conf 内容：

DE_BASE=/opt
DE_PORT=8100
DE_LOGIN_TIMEOUT=480  # 登录超时，单位 min，不设默认 8 小时
DE_INSTALL_MODE=community  # community | enterprise
DE_EXTERNAL_MYSQL=false
DE_MYSQL_HOST=mysql-de
DE_MYSQL_DB=dataease
DE_MYSQL_USER=root
DE_MYSQL_PASSWORD=Password123@mysql
DE_MYSQL_PARAMS="autoReconnect=false&useUnicode=true&characterEncoding=UTF-8&characterSetResults=UTF-8&zeroDateTimeBehavior=convertToNull&useSSL=false&allowPublicKeyRetrieval=true"

几个参数的含义：DE_LOGIN_TIMEOUT 单位是分钟，不设置时默认 8 小时；DE_INSTALL_MODE 取值 community 或 enterprise；DE_EXTERNAL_MYSQL=false 表示使用内置 MySQL，改为 true 时按下面的外部库要求准备。

外部 MySQL

只能使用 MySQL 8.0.16 以上版本。my.cnf 要求：

[mysqld]
default-storage-engine=INNODB
character_set_server=utf8
lower_case_table_names=1
table_open_cache=128
max_connections=2000
max_connect_errors=6000
innodb_file_per_table=1
innodb_buffer_pool_size=1G
max_allowed_packet=64M
transaction_isolation=READ-COMMITTED
innodb_flush_method=O_DIRECT
innodb_lock_wait_timeout=1800
innodb_flush_log_at_trx_commit=0
sync_binlog=0
group_concat_max_len=1024000
sql_mode=STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION
skip-name-resolve

其中三项要特别确认：character_set_server=utf8、lower_case_table_names=1、group_concat_max_len=1024000。

建库语句：

CREATE DATABASE `dataease` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;

安装目录

默认在 /opt/dataease2.0，配置文件、数据、日志都放在这里：

• apisix：APISIX 配置与日志持久化
• bin：加载到容器的脚本
• cache：Ehcache，主要缓存权限数据
• conf：各组件及数据库等中间件配置
• data：数据持久化
• docker-compose.yml：基础编排，定义网络
• docker-compose-apisix.yml
• docker-compose-mysql.yml
• logs
• templates：配置文件原始模板

登录与默认口令

浏览器打开 http://目标IP:端口（端口对应 DE_PORT，默认 8100），用户名 admin，密码 DataEase@123456。安装脚本会占用 22 端口做安装与升级管理，Web 端口和登录超时都在 install.conf 里改。

版本与授权边界

代码库是 GPLv3，安装模式通过 DE_INSTALL_MODE 在 community 和 enterprise 之间切换，两者对应不同的功能范围。涉及二次分发或商业集成时，按 GPLv3 的条款处理。

文档站上还有几份配套说明：升级指南、备份还原指南、1Panel 安装指南、命令行工具指南。

tags: 数据分析工具, BI, DataEase, 自托管, 离线部署