企业官网建设流程全解析

如何修改 DataEase 默认安装目录 /opt？

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

DataEase v2 使用仓库installer/目录下的安装包部署时，安装目录由 install.conf 中的DE_BASE决定，默认值为/opt。如果/opt所在磁盘空间不足、或希望把整个部署放到其他数据盘路径，只需在运行安装脚本前修改这一项配置。本文适用于在一台 Linux 服务器上执行 install.sh 的全新安装场景；如果机器上已经装过 DataEase v2，脚本会沿用原目录，DE_BASE的修改不会生效（文末“边界说明”有依据）。

安装目录在脚本中的作用

理解改动范围先看两处代码逻辑：

• install.sh 在安装开始时读取install.conf，随后把运行目录固定为$DE_BASE/dataease2.0，并把dataease/下的安装文件复制过去。也就是说，DE_BASE一改，所有配置、日志、数据目录都会跟着落到新路径下。
• 安装脚本最后执行update_dectl：把新的DE_BASE写入 dectl 控制脚本，安装到/usr/local/bin/dectl并软链到/usr/bin/dectl。之后dectl的所有命令都以该脚本里写死的DE_BASE定位运行目录${DE_BASE}/dataease2.0。
• 各 docker-compose 文件（如 docker-compose.yml、docker-compose-mysql.yml）中的宿主机侧挂载点全部使用${DE_BASE}/dataease2.0/...形式，环境变量由运行目录下的.env提供，因此容器内路径不变，只有宿主机侧目录随DE_BASE移动。

准备条件

• 一台 2 核 4G 以上的 Linux 服务器（README 快速开始给出的最低配置说明），以 root 用户执行安装。
• 安装脚本会检查DE_BASE所在磁盘的剩余空间，不足 20G 时打印警告：[警告] DataEase 运行目录所在磁盘剩余空间不足 20G 可能无法正常启动!，请确认目标目录所在磁盘满足该条件。
• 手上是完整安装包目录，即包含install.conf、install.sh、dectl、dataease/子目录的目录（与 installer 工程结构一致）。

修改 install.conf 中的 DE_BASE

编辑安装包目录下的 install.conf，只改安装目录这一项：

# 基础配置 ## 安装目录 DE_BASE=<目标安装目录> ## Service 端口 DE_PORT=8100

其中<目标安装目录>替换为你要使用的绝对路径（文档默认值为/opt）。其余配置如DE_PORT、数据库与 APISIX 参数保持不动即可。脚本在初始化阶段会先执行mkdir -p ${DE_BASE}，因此路径不存在时会自动创建；脚本不会自动挂载磁盘，目标路径所在挂载点需要事先存在。

运行安装脚本

在安装包目录下执行：

/bin/bash install.sh

执行前需要知道该脚本的副作用（均由脚本源码明确）：

• 若未安装 Docker / docker-compose，会在线下载安装（离线包提供docker/目录时走离线复制），并启动 docker 服务；
• 若 SELinux 处于 Enforcing 状态，会执行setenforce 0并修改/etc/selinux/config；
• 若 firewalld 正在运行，会开放${DE_PORT}（默认 8100）TCP 端口；
• 安装完成后复制dataease.service到/etc/systemd/system/并配置开机自启，随即systemctl start dataease启动服务。

安装过程会输出编号日志，其中“设置运行目录”一节会打印运行目录 $DE_RUN_BASE，可在此确认新目录是否已生效。

验证安装结果

1. 检查运行目录落点。dectl status会输出宿主机侧目录占用与磁盘情况（脚本内置的固定输出项）：

   dectl status

   关注以下几行输出：DataEase 运行目录及文件大小 :（对应du -sh ${DE_BASE}）、DataEase 运行目录使用情况 :（对应df -H ${DE_BASE}），确认其指向新目录。脚本还会轮询容器健康状态，显示DataEase 服务状态 : 正常运行表示服务已通过健康检查；若在等待时间内未就绪，会提示稍后再次执行dectl status检查。

2. 登录系统验证。全新安装完成时脚本会打印登录信息：访问地址http://服务器IP:8100（社区版使用DE_PORT），用户名admin，初始密码DataEase@123456。能打开页面并登录，说明配置、日志、数据目录整体迁移到新路径后服务可正常工作。

新目录下的目录结构

安装脚本会在$DE_BASE/dataease2.0下创建以下结构（取自prepare_de_run_base），后续排查数据、日志、缓存位置时以此为准：

• conf/：由templates/模板渲染生成的application.yml、mysql.env等运行配置；
• logs/、cache/：运行日志与缓存；
• data/：mysql、static-resource、map、etcd_data、geo、appearance、exportData、plugin、font、i18n、report子目录；
• apisix/logs、task/logs：企业版网关与同步任务的日志；
• .env：安装时的DE_前缀环境变量快照，dectl启动时会 source 它。

边界说明

• 本文路径只覆盖全新安装。脚本在检测到/usr/bin/dectl已存在（即已装过 v2）时，会从/usr/bin/dectl中读出原有的DE_BASE并强制沿用（日志显示“升级安装”），此时修改install.conf中的DE_BASE不会改变已部署目录，仓库文档也未提供已装实例的目录迁移步骤。已有实例若需换目录，文档没有给出操作路径，不要参照本文执行。
• 磁盘空间检查仅是警告而非阻断，空间不足时服务“可能无法正常启动”，请自行保证目标磁盘余量。
• 安装完成后如需备份与恢复，使用dectl backup/dectl restore <备份文件>，二者基于dectl中记录的运行目录工作，改完目录后无需额外配置。

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