phpEnv是一款集成了PHP、MySQL、Nginx等多种服务的本地开发环境工具，很多开发者会用它搭建Web开发环境，而Metabase是一款轻量级的开源数据分析工具，能够连接多种数据源生成可视化报表。在phpEnv中安装Metabase可以快速搭建本地数据分析环境，满足项目数据查看和分析的需求。
安装前的前置准备
在安装Metabase之前，需要先完成以下准备工作，确保环境满足运行要求：
- 已经正确安装并启动phpEnv，且phpEnv中的MySQL服务处于运行状态，后续Metabase可以连接该MySQL存储元数据。
- Metabase是基于Java开发的应用，需要提前安装Java运行环境，建议安装Java 11及以上版本，本文以Java 11为例进行说明。
- 下载Metabase的jar安装包，建议选择最新的稳定版本，下载后放到phpEnv安装目录下的自定义文件夹中，比如新建一个metabase文件夹存放。
配置Java运行环境
phpEnv本身没有集成Java环境，需要手动安装并配置环境变量：
- 从官方渠道下载Java 11的安装包，完成安装后记录安装路径，比如默认安装路径为
C:Program FilesJavajdk-11.0.18。 - 右键点击此电脑，选择属性，进入高级系统设置，点击环境变量，在系统变量中新建变量名为
JAVA_HOME的变量，变量值为Java的安装路径。 - 在系统变量的Path变量中添加
%JAVA_HOME%bin，保存后打开命令行输入java -version，如果输出Java版本信息则说明配置成功。
部署并启动Metabase
完成前置准备后，就可以开始部署Metabase服务：
1. 放置安装包并启动服务
将下载好的Metabase jar包放到phpEnv安装目录下的metabase文件夹中，比如路径为D:phpEnvmetabasemetabase.jar，打开命令行切换到该目录，执行以下启动命令：
# 启动Metabase，默认端口为3000，可通过-p参数指定其他端口 java -jar metabase.jar
如果3000端口被phpEnv中的其他服务占用，可以指定其他端口启动，比如指定端口为3300：
java -jar metabase.jar --port 3300
2. 初始化配置
启动成功后，打开浏览器访问http://127.0.0.1:3000（如果指定了其他端口则替换对应端口号），首次访问会进入初始化配置页面：
- 设置管理员账号的邮箱和密码，填写完成后点击下一步。
- 选择数据源类型，这里选择MySQL，填写phpEnv中MySQL的连接信息：主机为127.0.0.1，端口为3306，用户名和密码为phpEnv中MySQL的配置信息，数据库可以选择新建一个专门给Metabase使用的数据库，也可以直接使用已有的数据库。
- 完成数据源配置后，点击下一步，跳过后续的示例数据配置，即可进入Metabase的主界面。
配置Metabase为系统服务（可选）
为了方便管理，避免每次手动启动命令行，可以把Metabase配置为Windows系统服务，这样开机后可以自动启动：
可以使用nssm工具来配置服务，下载nssm后放到系统路径中，打开命令行执行以下命令：
# 安装服务，Metabase为服务名称，可自定义 nssm install Metabase
在弹出的配置窗口中，Application标签下的Path选择Java的安装路径下的java.exe，Startup directory选择metabase jar包所在的目录，Arguments填写-jar metabase.jar --port 3000，点击Install service完成服务安装。之后可以在Windows服务管理中启动Metabase服务，设置为自动启动即可。
常见问题解决方法
| 问题现象 | 解决方法 |
|---|---|
| 启动时报端口被占用 | 使用netstat -ano | findstr 端口号查看占用端口的进程，关闭对应进程或者更换Metabase启动端口 |
| 连接MySQL失败 | 检查phpEnv的MySQL服务是否启动，确认连接信息填写正确，同时确保MySQL允许本地连接 |
| Java命令不识别 | 检查JAVA_HOME环境变量是否配置正确，Path中是否添加了Java的bin目录，重启命令行后重试 |
基础使用验证
进入Metabase主界面后，可以点击左侧的New按钮，选择Question，选择之前配置的MySQL数据源，选择对应的数据表，就可以拖拽字段生成可视化图表，验证数据分析环境是否正常工作。如果需要让局域网内其他设备访问，可以修改Metabase的启动参数，添加--host 0.0.0.0参数，让服务监听所有网卡，其他设备通过http://ipipp.com:3000即可访问。
phpEnvMetabase数据分析Java_environment修改时间：2026-06-10 11:06:18