需依次完成Java环境配置（JDK 17）、Mule Runtime Engine安装、MuleRun应用包部署至apps目录、启动服务并验证日志与/health端点、配置mule-deploy.properties及mulerun-config.yaml实现持久化。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您希望在本地环境中运行MuleRun服务，但尚未完成基础环境搭建与应用部署，则可能是由于缺少Java运行时、Mule Runtime Engine未正确安装或应用包未按规范放置。以下是完成MuleRun本地服务部署的全流程操作步骤：
一、确认并配置Java运行环境
MuleRun依赖JDK 11或JDK 17（推荐JDK 17），必须确保系统中已安装且JAVA_HOME环境变量指向有效JDK路径。若未配置，Mule Runtime将无法启动。
1、执行java -version命令，验证输出中包含11.或17.字样及64-Bit标识。
2、若命令报错或版本不符，需下载JDK 17 LTS（如Adoptium Temurin 17.0.10+7）并安装。
3、编辑/etc/profile（Linux/macOS）或系统环境变量（Windows），添加：
export JAVA_HOME=/path/to/jdk-17和export PATH=$JAVA_HOME/bin:$PATH。
4、执行source /etc/profile（Linux/macOS）或重启终端（Windows），再次运行java -version确认生效。
二、下载并解压Mule Runtime Engine
MuleRun需依托Mule Runtime Engine（Mule Standalone）作为底层执行容器，不可直接运行MuleRun源码或脚本。必须使用兼容Mule 4.4+的Runtime版本。
1、访问MuleSoft官方归档页面或可信镜像源，下载mule-standalone-4.4.0.tar.gz（Linux/macOS）或.zip（Windows）。
2、将压缩包解压至无中文、无空格路径，例如/opt/mule或C:\mule。
3、进入解压后目录，确认存在bin/、apps/、conf/子目录，且bin/mule（Linux/macOS）或bin/mule.bat（Windows）具有可执行权限。
4、执行./bin/mule --version（Linux/macOS）或bin\mule.bat --version（Windows），输出应含Runtime version: 4.4.0。
三、准备MuleRun应用包并部署到apps目录
MuleRun以Mule应用（.jar或.zip格式）形式部署，必须符合Mule Deployment Descriptor规范，且包含mule-artifact.json与主flow.xml。
1、获取合法MuleRun应用包，文件名须为mulerun-app-*.jar或mulerun-app-*.zip，不得为源码工程目录。
2、将该文件完整复制至Mule Runtime的apps/目录下，例如：cp mulerun-app-1.2.0.jar /opt/mule/apps/。
3、确保apps/目录内无同名残留文件夹（如mulerun-app-1.2.0/），否则Mule会跳过部署。
4、检查apps/目录权限：Linux/macOS下需保证Mule进程用户对该文件有读取权；Windows下需关闭杀毒软件实时扫描干扰。
四、启动Mule Runtime并验证MuleRun服务状态
启动Mule Runtime后，其自动扫描apps/目录并加载新应用。MuleRun服务将在指定HTTP端口监听请求，日志输出是判断是否成功的核心依据。
1、切换至Mule Runtime根目录，执行./bin/mule start（Linux/macOS后台启动）或./bin/mule（前台启动便于观察日志）。
2、等待约15–45秒，在控制台日志中查找连续出现的三行关键标记：
INFO org.mule.runtime.core.internal.registry.MuleRegistryHelper: Starting app 'mulerun-app-1.2.0'
INFO org.mule.service.http.impl.service.HttpService: HTTP Listener is up and running on http://0.0.0.0:8080/@
INFO org.mule.runtime.core.internal.lifecycle.PhaseLifecycleCallback: Started phase 'start' for app 'mulerun-app-1.2.0'
3、若出现ERROR或Failed to deploy且无上述三行，则立即停止进程，检查logs/mule_ee.log末尾100行。
4、在浏览器中访问http://localhost:8080/health，返回{"status":"UP"}即表示MuleRun核心服务已就绪。
五、配置MuleRun专属参数与持久化路径
MuleRun需独立于默认Mule应用的数据目录与配置，必须通过mule-artifact.json或mule-deploy.properties显式声明运行时参数，否则将使用临时内存存储，重启即丢失全部状态。
1、在apps/mulerun-app-1.2.0/目录下创建mule-deploy.properties文件。
2、写入以下两行内容：
redeployment.enabled=false
config.resources=flows.xml,config/mulerun-config.yaml
3、在同级config/子目录中新建mulerun-config.yaml，定义：
storage:
local_path: /var/lib/mulerun/data
server:
port: 8081
4、手动创建/var/lib/mulerun/data目录（Linux/macOS）或C:\mulerun\data（Windows），并赋予Mule进程读写权限。
