DataEase 离线部署实战：零网服务器 3 步跑通 BI 可视化平台-平芜编程栈

DataEase 离线部署实战：零网服务器 3 步跑通 BI 可视化平台

【免费下载链接】dataease🔥 人人可用的开源 BI 工具，数据可视化神器。An open-source BI tool alternative to Tableau.项目地址: https://gitcode.com/GitHub_Trending/da/dataease

DataEase 是一款开源 BI 工具，支持 MySQL、ClickHouse、Excel 等数据源，拖拽即可出图。这篇教程解决一个具体问题：服务器完全离线、连不上外网时，怎么把 DataEase 从零部署起来。

📋 动手前自检：确认机器能装

先花 1 分钟确认四项条件，任何一项不满足都会卡住后面的流程：

项目	要求
操作系统	Linux，如 CentOS 7/8、Ubuntu 18.04/20.04
硬件	2 核 4G 起步（官方推荐配置），安装目录所在磁盘剩 20G 以上
权限	root 或 sudo
离线资源	官方离线安装包一份（内含镜像文件与 Docker 离线二进制）

用下面的命令快速核对 CPU、内存和磁盘余量：

# 查看 CPU 核数、内存与默认安装目录 /opt 的剩余空间 nproc; free -h; df -h /opt

📦 获取离线安装包

仓库里的 installer/ 目录是离线安装包的制作工程，正式发布包是打好的压缩包。下载入口见 installer/README.md。

解压后你会得到install.sh、install.conf、dectl和dataease/（compose 与配置模板）等文件。有两个目录决定了这次安装是否"真离线"：

images/：DataEase 各组件的镜像文件
docker/：Docker 与 Docker Compose 的离线二进制

安装脚本的逻辑是：这两个目录存在就走全程离线；缺失则转在线下载。零网环境里一旦走在线分支，Docker 安装这一步必然失败，所以取包时务必核对它们存在。

🛠️ 调整 install.conf 关键参数

所有可调项集中在 installer/install.conf，首次安装建议只关心这几项：

DE_BASE：安装目录，默认/opt，最终运行目录是$DE_BASE/dataease2.0
DE_PORT：浏览器访问端口，默认8100
DE_INSTALL_MODE：安装模式，默认community（社区版）
DE_EXTERNAL_MYSQL：是否使用外部 MySQL，默认false用内置数据库。设为true时需同时填DE_MYSQL_HOST、DE_MYSQL_PORT、DE_MYSQL_USER、DE_MYSQL_PASSWORD，密码含特殊字符要用双引号包住

▶️ 执行 install.sh 等安装完成

在解压出的安装包根目录运行安装脚本：

# 给脚本加执行权限并启动安装 chmod +x install.sh ./install.sh

脚本会依次完成：读取配置并检查磁盘 → 初始化运行目录 → 安装dectl命令行工具 → 关闭 SELinux、放行防火墙端口 → 安装 Docker 与 Compose → 从images/加载镜像 → 注册 systemd 服务dataease并启动。全程日志写入安装包目录下的install.log。

看到"安装完成"字样和访问信息输出，说明服务已经起来了。镜像加载较多，首次安装耐心等待即可。

✅ 首次访问验证

在浏览器打开http://服务器IP:8100，用安装结束时打印的初始账号登录：用户名admin，密码DataEase@123456。

登录后做一个 30 秒的验证动作：新建一个柱状图，选一份示例数据集，把维度字段拖到 X 轴、指标字段拖到 Y 轴。能出下图这种图形，说明数据库、服务、前端链路全部正常：

🧰 日常启停、排障与关键文件

日常命令速查

dectl安装时会被放到/usr/local/bin/dectl，日常运维基本靠它：

dectl start # 启动服务 dectl stop # 停止服务 dectl restart # 重启服务 dectl status # 查看容器状态、磁盘占用与服务健康 dectl version # 查看当前版本

备份还原、清理旧镜像和历史日志同样有对应子命令，具体见 installer/dectl 中的用法说明。日志默认在/opt/dataease2.0/logs/下，dataease/info.log和dataease/error.log是主要入口。

三个高频坑的排查

安装时警告磁盘不足：脚本要求安装目录所在磁盘至少 20G，用df -h确认后，把DE_BASE指到空间更大的分区再装。
提示端口被占：改install.conf里的DE_PORT为空闲端口，装完按新端口访问。
装完页面打不开：先dectl status看容器是否 healthy；再docker logs dataease看服务日志；若 Docker 本身没起来，查journalctl -u docker.service。

dectl status docker logs dataease journalctl -u docker.service

关键文件位置

安装配置：installer/install.conf
安装脚本：installer/install.sh
命令行工具：installer/dectl，安装后位于/usr/local/bin/dectl
Compose 模板：installer/dataease/docker-compose.yml 及同目录文件
运行产物：$DE_BASE/dataease2.0/下的conf、logs、data目录
安装日志：安装包目录下的install.log

接下来就可以导入自己的数据集，接上业务库开始出图了。功能使用与更多场景介绍，从 README.md 和 docs/use-cases.md 入手即可。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

DataEase 离线部署实战：零网服务器 3 步跑通 BI 可视化平台