Apache Apollo 跨系统迁移涉及环境准备、文件传输、权限适配及服务验证。需确保 JDK 与 Apollo 版本一致，将 Windows 实例目录完整迁移至 Linux，修复文件权限并调整路径分隔符。通过配置开机自启和防火墙规则优化生产环境，最终验证管理后台与 MQTT 连接正常即可实现平滑迁移。
背景：作为轻量级消息中间件，Apache Apollo 常被用于 MQTT 协议的消息通信场景。但实际部署中，不少同学会遇到从 Windows 测试环境迁移到 Linux 生产环境的需求 —— 这过程看似简单，却容易踩'路径兼容''权限''数据完整性'的坑。
先明确迁移的基础信息，避免版本 / 环境不兼容：
D:\apache-apollo-1.7.1\bin\mybroker/home/apollo/apache-apollo-1.7.1/bin/mybroker迁移前先把 Linux 环境配置到位，避免后续'卡壳'。
Apollo 依赖 JDK 1.8，高版本会报类加载错误，所以必须严格匹配：
# 下载 JDK 1.8（或上传本地安装包）
wget https://repo.huaweicloud.com/java/jdk/8u202-b08/jdk-8u202-linux-x64.tar.gz
# 解压到 /usr/local
tar -zxvf jdk-8u202-linux-x64.tar.gz -C /usr/local/
# 配置环境变量（编辑 /etc/profile）
echo 'export JAVA_HOME=/usr/local/jdk1.8.0_202' >> /etc/profile
echo 'export PATH=$JAVA_HOME/bin:$PATH' >> /etc/profile
source /etc/profile
# 验证 java -version
# 下载 Apollo 安装包
wget http://apache.fayea.com/activemq/activemq-apollo/1.7.1/apache-apollo-1.7.1-unix-distro.tar.gz
# 解压
tar -zxvf apache-apollo-1.7.1-unix-distro.tar.gz -C /home/apollo/
# 赋予执行权限（Linux 必须！）
chmod -R 755 /home/apollo/apache-apollo-1.7.1
Apollo 的配置、数据都存在 实例目录（mybroker） 里，只需把这些文件从 Windows 传到 Linux 即可。
要迁移的文件清单（必传） 用 WinSCP/FileZilla 把 Windows 端 mybroker 目录下的这些内容，传到 Linux 端的 mybroker 目录：
| Windows 路径 | Linux 路径 | 作用 |
|---|---|---|
| mybroker/etc/ | /home/apollo/apache-apollo-1.7.1/bin/mybroker/etc/ | 端口、认证等核心配置 |
| mybroker/data/ | /home/apollo/apache-apollo-1.7.1/bin/mybroker/data/ | 持久化消息数据（重要！） |
| mybroker/etc/users.properties | /home/apollo/apache-apollo-1.7.1/bin/mybroker/etc/users.properties | 管理后台账号密码 |
Windows 和 Linux 的'差异'是迁移的坑点，这一步必须做：
Windows 传过来的文件默认权限可能不足，导致 Apollo 启动失败：
chmod -R 755 /home/apollo/apache-apollo-1.7.1/bin/mybroker
打开 Linux 端的 mybroker/etc/apollo.xml，检查路径配置：
\ 作为路径分隔符，Linux 用 /；${apollo.base} 变量（自动识别实例目录），所以只要原配置用了相对路径，Linux 会自动适配，无需手动修改。directory="D:\apollo\data" → Linux 自动变成 ${apollo.base}/data。用之前写好的 apollo.sh 脚本启动（没脚本的话，直接用实例的启动命令）：
cd /home/apollo/apache-apollo-1.7.1/bin
# 启动服务
./apollo.sh start
# 查看状态（显示'运行中'则成功）
./apollo.sh status
此处为启动脚本：
#!/bin/bash
# Apache Apollo Linux 启动脚本
# 功能：替代 Windows 的 apollo.cmd，支持启动/停止/重启/状态查询
# ======================== 配置区（根据你的实际路径修改）========================
# Apollo 安装根目录（替换为你的 apollo 解压路径）
APOLLO_HOME="/home/你的用户名/Downloads/apache-apollo-1.7.1"
# Broker 实例目录（创建的 mybroker 路径）
APOLLO_BASE="${APOLLO_HOME}/bin/mybroker"
# Java 安装目录（如果已配置 JAVA_HOME 环境变量，可留空）
JAVA_HOME="/usr/lib/jvm/jdk1.8.0_381"
# JVM 参数配置（和 Windows 版保持一致）
JVM_FLAGS="-server -Xmx1G -XX:-UseBiasedLocking"
# 日志输出目录
LOG_DIR="${APOLLO_BASE}/logs"
# 进程 PID 文件路径
PID_FILE="${LOG_DIR}/apollo.pid"
# ==============================================================================
# 确保日志目录存在
mkdir -p ${LOG_DIR}
# 日志文件
LOG_FILE="${LOG_DIR}/apollo.out"
# 颜色输出函数（可选，提升可读性）
red_echo(){ echo -e "\033[31m$1\033[0m"; }
green_echo(){ echo -e "\033[32m$1\033[0m"; }
yellow_echo(){ echo -e "\033[33m$1\033[0m"; }
# 检查 Java 环境
check_java(){
if [ -n "${JAVA_HOME}" ] && [ -x "${JAVA_HOME}/bin/java" ]; then
JAVACMD="${JAVA_HOME}/bin/java"
else
JAVACMD=$(which java 2>/dev/null)
if [ -z "${JAVACMD}" ]; then
red_echo "错误：未找到 Java 环境，请配置 JAVA_HOME 或确保 java 命令在 PATH 中！"
exit 1
fi
yellow_echo "警告：未配置 JAVA_HOME，使用系统默认 java: ${JAVACMD}"
fi
}
# 检查 Apollo 目录
check_apollo(){
if [ ! -d "${APOLLO_HOME}" ]; then
red_echo "错误：APOLLO_HOME 路径不存在：${APOLLO_HOME}"
exit 1
fi
if [ ! -d "${APOLLO_BASE}" ]; then
red_echo "错误：Broker 实例目录不存在，请先执行 ./apollo create mybroker 创建实例！"
exit 1
fi
}
# 启动函数（前台/后台）
start(){
# 先检查环境
check_java
check_apollo
# 检查是否已运行
if [ -f "${PID_FILE}" ] && ps -p $(cat ${PID_FILE}) >/dev/null 2>&1; then
yellow_echo "Apollo 已在运行中（PID: $(cat ${PID_FILE})）"
return 0
fi
# 组装完整 JVM 参数（和 Windows 版 apollo.cmd 逻辑一致）
FULL_JVM_FLAGS="${JVM_FLAGS}"
# 开启 JMX 远程管理（可选）
FULL_JVM_FLAGS="${FULL_JVM_FLAGS} -Dcom.sun.management.jmxremote"
# 绑定 Apollo 路径
FULL_JVM_FLAGS="${FULL_JVM_FLAGS} -Dapollo.home=${APOLLO_HOME}"
FULL_JVM_FLAGS="${FULL_JVM_FLAGS} -Dapollo.base=${APOLLO_BASE}"
# 类路径
FULL_JVM_FLAGS="${FULL_JVM_FLAGS} -classpath ${APOLLO_HOME}/lib/apollo-boot.jar"
# 核心启动命令（和 Windows 版的 Java 调用逻辑完全对应）
BOOT_CMD="${JAVACMD} ${FULL_JVM_FLAGS} org.apache.activemq.apollo.boot.Apollo ${APOLLO_HOME}/lib org.apache.activemq.apollo.cli.Apollo run"
green_echo "开始启动 Apollo..."
if [ "$1" = "foreground" ]; then
# 前台启动（调试用，日志输出到终端）
${BOOT_CMD}
else
# 后台启动（生产用，日志输出到文件）
nohup ${BOOT_CMD} > ${LOG_FILE} 2>&1 &
echo $! > ${PID_FILE}
sleep 3
# 检查启动结果
if ps -p $(cat ${PID_FILE}) >/dev/null 2>&1; then
green_echo "Apollo 启动成功！PID: $(cat ${PID_FILE})，日志文件：${LOG_FILE}"
else
red_echo "Apollo 启动失败！请查看日志：${LOG_FILE}"
rm -f ${PID_FILE}
exit 1
fi
fi
}
# 停止函数
stop(){
if [ ! -f "${PID_FILE}" ]; then
yellow_echo "Apollo 未运行（PID 文件不存在）"
return 0
fi
PID=$(cat ${PID_FILE})
if ps -p ${PID} >/dev/null 2>&1; then
green_echo "正在停止 Apollo（PID: ${PID}）..."
kill ${PID}
# 等待进程退出
sleep 5
if ps -p ${PID} >/dev/null 2>&1; then
red_echo "优雅停止失败，强制杀死进程..."
kill -9 ${PID}
fi
rm -f ${PID_FILE}
green_echo "Apollo 已停止"
else
yellow_echo "Apollo 未运行（PID: ${PID} 不存在）"
rm -f ${PID_FILE}
fi
}
# 状态查询
status(){
if [ -f "${PID_FILE}" ] && ps -p $(cat ${PID_FILE}) >/dev/null 2>&1; then
green_echo "Apollo 正在运行中！PID: $(cat ${PID_FILE})"
else
red_echo "Apollo 未运行"
fi
}
# 帮助信息
usage(){
echo "用法：$0 [命令]"
echo "支持的命令："
echo " start - 后台启动 Apollo（生产环境推荐）"
echo " start-fg - 前台启动 Apollo（调试用，日志输出到终端）"
echo " stop - 停止 Apollo"
echo " restart - 重启 Apollo"
echo " status - 查看 Apollo 运行状态"
echo " help - 显示帮助信息"
exit 1
}
# 主逻辑
case "$1" in
start) start ;;
start-fg) start foreground ;;
stop) stop ;;
restart) stop sleep 2 start ;;
status) status ;;
help|*) usage ;;
esac
exit 0
http://Linux 服务器 IP:61680，用默认账号 admin/password 登录（和 Windows 端一致）；tcp://Linux 服务器 IP:61613，发一条测试消息，能收到则正常；设置开机自启 避免服务器重启后服务挂掉，把 Apollo 注册为系统服务：
sudo ln -s /home/apollo/apache-apollo-1.7.1/bin/mybroker/bin/apollo-broker-service /etc/init.d/
sudo update-rc.d apollo-broker-service defaults
关闭 Windows 端服务 确认 Linux 端完全正常后，彻底关掉 Windows 端的 Apollo，避免端口冲突。
| 问题现象 | 原因 + 解决方法 |
|---|---|
| 启动失败，日志报'权限不足' | Linux 权限问题 → 执行 chmod -R 755 mybroker |
| 管理后台打不开 | 防火墙没开 61680 端口 → sudo firewall-cmd --add-port=61680/tcp --permanent |
| MQTT 连不上 | 61613 端口没开放 → 开放端口，或检查 apollo.xml 端口配置 |
总结
Apollo 跨系统迁移的核心逻辑是 '复制实例文件 + 适配 Linux 环境'，只要注意'权限''路径'这两个坑，基本能一次成功。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online