DataEase 离线安装包使用教程：无网络环境部署开源 BI 工具

你是否遇到过服务器无法连接公网，但又需要快速部署数据可视化工具的困境？作为一款开源 BI（Business Intelligence，商业智能）工具，DataEase 提供了离线安装方案，让你在无网络环境下也能完成部署。本文将带你通过三个核心步骤，从准备到验证，全程实操离线部署过程，并提供常见问题解决指南。

一、准备工作：离线环境部署前置条件

1.1 环境要求

部署 DataEase 前需确认服务器满足以下条件：

• 操作系统：Linux（推荐 CentOS 7/8 或 Ubuntu 18.04/20.04）
• 硬件配置：至少 4 核 CPU、8GB 内存、20GB 磁盘空间（查看官方推荐配置）
• 权限要求：拥有 root 或 sudo 权限
• 依赖检查：无需预装 Docker（离线包已包含）

1.2 离线安装包获取

1. 访问 DataEase 官方下载页面（需联网环境）：
   社区版下载地址
2. 选择 "离线安装包" 下载，文件格式为 dataease-offline-v*.tar.gz（* 为版本号）
3. 通过 U 盘、内网传输等方式将安装包复制到目标服务器的 /tmp 目录

1.3 文件结构说明

离线安装包解压后包含以下关键文件（查看完整结构）：

dataease-offline-v*/
├── dataease/          # 应用程序文件
├── docker/            # Docker 离线安装资源
├── images/            # 容器镜像离线包
├── install.conf       # 安装配置文件
├── install.sh         # 主安装脚本（核心文件）
└── quick_start.sh     # 快速启动脚本

图 1：DataEase 离线安装包目录结构示意图

二、部署步骤：三步完成无网络安装

2.1 解压安装包

登录目标服务器，执行以下命令解压离线包：

# 进入安装包存放目录
cd /tmp
# 解压文件（替换 * 为实际版本号）
tar -zxvf dataease-offline-v*.tar.gz
# 进入解压后的目录
cd dataease-offline-v*

2.2 配置安装参数（可选）

如需自定义安装路径或端口，可修改 install.conf 文件：

# 编辑配置文件
vi install.conf

关键配置项说明（查看完整配置）：

参数名	说明	默认值
DE_BASE	安装目录	/opt/dataease
DE_PORT	访问端口	8081
DE_EXTERNAL_MYSQL	是否使用外部 MySQL	false

2.3 执行安装脚本

# 赋予执行权限
chmod +x install.sh
# 运行安装脚本（需 root 权限）
sudo ./install.sh

安装过程将自动完成以下操作（查看脚本源码）：

1. 检查磁盘空间（需至少 20GB 剩余空间）
2. 安装 Docker 及 Docker Compose（离线模式）
3. 加载 DataEase 容器镜像
4. 配置系统服务并启动应用

三、验证部署：访问与基础操作

3.1 确认服务状态

执行以下命令检查 DataEase 服务状态：

# 查看服务状态
systemctl status dataease
# 查看容器运行状态
docker-compose ps -a

若服务正常，将显示 active (running) 状态。

3.2 访问 Web 界面

在浏览器中输入服务器 IP 和端口访问：
http://服务器IP:8081
首次登录使用默认账号：

• 用户名：admin
• 密码：DataEase@123456

图 2：DataEase 登录界面（深色主题）

3.3 快速入门指引

登录后可参考以下步骤创建首个数据看板：

1. 进入 数据源管理，添加本地 CSV 文件或数据库连接
2. 在 数据集 模块创建数据模型
3. 使用 仪表板 功能拖拽生成图表

详细操作可参考官方文档：docs/use-cases.md

四、常见问题解决

4.1 安装失败：Docker 启动报错

现象：install.sh 执行时报错 "docker: command not found"
解决：手动安装 Docker 离线包：

# 进入 Docker 离线资源目录
cd docker/bin
# 复制可执行文件
cp docker* /usr/bin/
# 启动 Docker 服务
systemctl start docker

4.2 端口冲突：8081 端口被占用

解决：修改 install.conf 中的 DE_PORT 参数，例如改为 8082，重新执行安装脚本。

4.3 忘记密码：重置管理员账号

执行以下命令重置密码：

# 进入安装目录
cd /opt/dataease/dataease2.0
# 执行重置命令
docker-compose exec backend ./dataease.sh reset-admin-password

五、总结与后续操作

通过本文教程，你已掌握 DataEase 离线部署的完整流程。如需进一步定制，可参考：

• 卸载指南：执行 ./uninstall.sh 脚本（查看卸载脚本）
• 版本升级：下载新版本离线包，执行 ./install.sh 即可完成升级
• 高级配置：修改 docker-compose.yml 自定义容器参数

若在使用中遇到问题，可查阅官方文档或社区论坛获取支持。收藏本文以备后续部署参考，关注项目仓库获取最新版本更新！

---

相关资源

• 安装脚本源码：installer/install.sh
• 配置文件模板：installer/install.conf
• 官方使用案例：docs/use-cases.md
• 快速启动脚本：installer/quick_start.sh

注：本文基于 DataEase 最新稳定版编写，不同版本操作可能存在差异，请以实际安装包内文档为准。