Banner

DataEase部署教程

2026-09-14

DataEase V2 保姆级部署教程与运维避坑指南（Linux）

适用版本：DataEase V2 社区版    操作系统：Ubuntu 22.04（推荐）或 CentOS 7.6+    服务器配置：4核8G 起步，磁盘 200G 以上

一、部署前必须知道的硬性要求

在动手之前，先对照以下清单确认服务器是否达标，不满足的字段会导致安装失败或运行时频繁报错。

   操作系统要求：Ubuntu 22.04 / CentOS 7.6 64位系统（V2支持主流Linux发行版及国产操作系统）。

   CPU/内存：4核8G起步，生产环境建议8核16G以上。

   磁盘空间：200G以上（DataEase 会下载多个 Docker 镜像，占用较大）。

   Docker 版本：建议使用 v23.0.5 及以上版本，或使用安装包内自带的 Docker（Docker 版本太老可能会导致安装失败）。

   端口要求：22 端口：SSH 管理；8100 端口：Web 服务默认端口，可根据需要修改。

   网络要求：服务器需能访问互联网（用于拉取 Docker 镜像和安装脚本）。

   特别提醒：如果服务器已有 Docker 且版本较旧，建议直接使用安装包内自带的 Docker，避免版本兼容问题。

二、安装 Docker 和 Docker Compose

2.1 检查 Docker 是否已安装

docker --version

如果已安装且版本 >= v23.0.5，可跳过以下步骤。

2.2 安装 Docker（Ubuntu / Debian）

sudo apt update
sudo apt install -y ca-certificates curl gnupg

sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

sudo systemctl start docker
sudo systemctl enable docker

docker --version
docker compose version

2.3 安装 Docker（CentOS 7.6+）

sudo yum remove -y docker docker-client docker-common docker-engine

sudo yum install -y yum-utils

sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

sudo yum install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

sudo systemctl start docker
sudo systemctl enable docker

docker --version
docker compose version

2.4 将当前用户加入 docker 组（可选）

避免每次执行 docker 命令都要加 sudo：

sudo usermod -aG docker $USER
newgrp docker

三、下载 DataEase 安装包

3.1 在线一键安装（最简单）

DataEase V2 提供了一键安装脚本，执行即可自动完成环境检测、Docker 安装、镜像拉取、服务启动及配置初始化：

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

3.2 离线安装包安装（生产环境推荐）

1. 前往 DataEase 官方社区下载页面，下载最新版本的离线安装包（如 dataease-offline-installer-v2.x.x.tar.gz）。

2. 将安装包上传至服务器 /tmp 目录。

3. 解压安装包：

cd /tmp
tar zxvf dataease-offline-installer-v2.x.x.tar.gz

4. 进入解压目录执行安装脚本：

cd dataease-offline-installer-v2.x.x
/bin/bash install.sh

3.3 1Panel 面板部署（最简单）

如果您使用 1Panel 面板，可直接在"应用商店"中搜索 DataEase，配置名称、端口并勾选"端口外部访问"后点击安装即可。

四、安装 DataEase

4.1 设置安装参数（可选）

DataEase 支持以配置文件的形式来设置安装参数。编辑 install.conf 文件，可自定义以下参数：

参数默认值说明
DE_BASE/opt安装目录
DE_PORT8100Web 服务端口
DE_LOGIN_TIMEOUT480登录超时时间（分钟），默认8小时
DE_INSTALL_MODEcommunity安装模式（community 或 enterprise）
DE_EXTERNAL_MYSQLfalse是否使用外部数据库
DE_MYSQL_HOSTmysql-de数据库地址
DE_MYSQL_DBdataease数据库名
DE_MYSQL_USERroot数据库用户名
DE_MYSQL_PASSWORDPassword123@mysql数据库密码

4.2 外部 MySQL 配置（可选）

DataEase 默认内置 MySQL 容器，无需额外配置。如需使用外部数据库，需满足以下条件：

   • 仅支持 MySQL 8.0.16 及以上版本。

   • 修改 MySQL 配置文件，设置以下关键参数：

   • character_set_server = utf8

   • lower_case_table_names = 1

   • group_concat_max_len = 1024000

   • transaction_isolation = READ-COMMITTED

建库语句：

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

在 install.conf 中设置 DE_EXTERNAL_MYSQL=true 并填写数据库连接信息。

4.3 执行安装

/bin/bash install.sh

安装过程中，脚本会自动完成以下操作：

   • 检查并设置运行目录（默认 /opt/dataease2.0）。

   • 初始化数据存储目录结构，包括 MySQL 数据、静态资源和日志等。

   • 安装 Docker 和 Docker Compose（如果未检测到）。

   • 加载 DataEase 相关 Docker 镜像。

   • 配置系统服务，设置开机自启动。

4.4 三种安装模式对比

安装模式适用场景特点
在线一键安装开发/测试环境最简单，自动完成所有步骤
离线安装包安装生产环境推荐，不依赖安装时网络
1Panel 面板安装使用 1Panel 的用户图形化操作，无需命令行

五、安装完成与登录

安装成功后，脚本会输出访问地址、用户名和初始密码。

   访问地址：http://目标服务器IP地址:8100

   登录用户名：admin

   登录密码：DataEase@123456

⚠ 首次登录后请立即修改默认密码！

六、Nginx 反向代理配置（域名访问 + HTTPS）

6.1 安装 Nginx

sudo apt install -y nginx
sudo systemctl start nginx
sudo systemctl enable nginx

6.2 配置反向代理

编辑 Nginx 配置文件（Ubuntu 位于 /etc/nginx/sites-available/dataease，CentOS 位于 /etc/nginx/conf.d/dataease.conf）：

server {
    listen 80;
    server_name dataease.yourdomain.com;

    location / {
        proxy_pass http://127.0.0.1:8100;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 300s;
        proxy_send_timeout 300s;
        proxy_buffering off;
    }
}

保存后测试配置并重载 Nginx：

sudo nginx -t
sudo systemctl reload nginx

6.3 配置 SSL 证书（Let's Encrypt）

sudo apt install -y certbot python3-certbot-nginx

sudo certbot --nginx -d dataease.yourdomain.com

certbot renew --dry-run

七、服务管理（dectl 命令行工具）

DataEase 默认内置命令行运维工具 dectl，支持以下全部命令：

7.1 查看服务状态

dectl status

显示所有相关容器的运行状态、Docker 目录大小、日志文件大小等信息。

7.2 启动/停止/重启服务

dectl start      # 启动服务
dectl stop       # 停止服务
dectl restart    # 重启服务
dectl reload     # 重新加载配置

7.3 备份与恢复

dectl backup     # 备份数据
dectl restore 备份文件名.tar.gz  # 恢复数据

7.4 升级

dectl upgrade    # 检查最新版本并自动完成升级

7.5 其他命令

dectl version    # 查看当前版本
dectl uninstall  # 卸载 DataEase

八、目录结构说明

DataEase V2 的主要运行目录位于 /opt/dataease2.0，各子目录功能如下：

目录路径功能描述
/opt/dataease2.0/data/mysqlMySQL 数据库数据文件（核心数据，务必备份）
/opt/dataease2.0/data/static-resource静态资源文件
/opt/dataease2.0/logs应用日志文件（排查问题必备）
/opt/dataease2.0/conf配置文件目录
/opt/dataease2.0/docker-compose.ymlDocker Compose 配置文件
/opt/dataease2.0/.env环境变量配置文件

九、安全加固（上线前必做）

9.1 修改默认密码

首次登录后立即修改 admin 密码，避免被未授权访问。

9.2 修改默认端口

如果不需要使用默认 8100 端口，可在 install.conf 中修改 DE_PORT 参数，然后执行 dectl restart 重启服务。

9.3 防火墙配置

使用 ufw（Ubuntu 默认防火墙工具）配置安全组规则：

sudo ufw status

sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

sudo ufw enable

# 注意：不建议将 8100 端口直接暴露到公网，应通过反向代理（80/443）访问

9.4 版本更新安全提醒

• DataEase 会不定期发布安全更新，建议定期执行 dectl upgrade 升级。

• 关注官方安全公告，及时修复已知 CVE 漏洞。

• 生产环境升级前建议在测试环境验证。

十、常见报错与解决方案

10.1 Docker 版本太老导致安装失败

现象：执行 install.sh 时报 Docker 版本不兼容错误。

解决：升级 Docker 到 v23.0.5 以上，或直接使用安装包内自带的 Docker。

10.2 服务启动失败

现象：dectl status 显示容器状态为 exited 或 unhealthy。

解决：

1. 执行 dectl status 查看详细状态。

2. 查看日志文件：tail -f /opt/dataease2.0/logs/dataease/error.log。

3. 检查 Docker 容器日志：docker logs dataease-mysql。

10.3 忘记管理员密码

通过修改数据库重置密码：

docker exec -it dataease-mysql mysql -uroot -p
# 密码在 /opt/dataease2.0/.env 文件中，变量为 DE_MYSQL_ROOT_PASSWORD

use dataease;
update sys_user set password = '2a10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi' where username = 'admin';
# 上述命令将密码重置为 DataEase@123456

10.4 安装超时或镜像拉取失败

现象：安装脚本卡在拉取镜像阶段。

解决：

1. 配置 Docker 镜像加速器（如阿里云镜像加速）。

2. 使用离线安装包方式部署。

10.5 磁盘空间不足

现象：安装失败或服务运行异常。

解决：DataEase 需要至少 20G 剩余空间，建议预留 50G 以上。执行 df -h 检查磁盘，清理不必要的文件。

10.6 8100 端口被占用

现象：安装脚本提示端口已被占用。

解决：

1. 执行 netstat -tlnp | grep 8100 查看占用进程。

2. 修改 install.conf 中的 DE_PORT 为其他端口，重新安装。

十一、日常运维规范

11.1 备份策略

每日自动备份数据库：使用 dectl backup 命令，配合 crontab 设置每日执行。

每周备份全站：备份 /opt/dataease2.0 目录下的 data/ 和 conf/ 子目录。

变更前备份：任何版本升级或配置变更前，必须手动全量备份。

11.2 版本升级

• DataEase 会不定期发布新版本和安全更新。

• 升级前执行 dectl backup 备份数据。

• 执行 dectl upgrade 自动升级。

• 大版本升级前建议在测试环境验证。

11.3 日志监控

• 定期查看 /opt/dataease2.0/logs/ 下的日志文件。

• 重点关注 error.log 中的异常信息。

• 建议配置日志轮转，避免日志文件过大占用磁盘。

11.4 资源监控

• 定期检查服务器 CPU、内存、磁盘使用情况。

• DataEase 运行时会消耗较多内存（建议 8G 起步）。

• 使用 docker stats 查看容器资源占用。

11.5 安装模式切换

• 支持在 community（社区版）和 enterprise（企业版）之间切换。

• 修改 install.conf 中的 DE_INSTALL_MODE 参数，重新执行 install.sh。

十二、验证清单

部署完成后，逐项确认：

• 前台可正常访问（http://IP:8100 或域名），无报错

• 后台可登录，使用默认账号 admin / DataEase@123456

• 首次登录后已修改默认密码

• 数据源可正常连接（添加一个测试数据源验证）

• 可正常创建仪表盘并展示图表

• dectl status 显示所有服务运行正常

• 防火墙仅开放 22、80、443 端口，8100 不直接暴露

• SSL 证书有效，HTTP 自动跳转 HTTPS（如配置了反向代理）

• 备份任务已配置并验证可恢复


27
DataEase
人人可用的开源 BI 工具，数据可视化神器。
2026-09-14
27
目录