Apache Apollo 从 Windows 迁移至 Linux 服务器全流程及避坑指南

四、Linux 端适配：避坑关键！

Windows 和 Linux 的'差异'是迁移的坑点，这一步必须做：

1. 修复文件权限（Linux 特有）

Windows 传过来的文件默认权限可能不足，导致 Apollo 启动失败：

chmod -R 755 /home/apollo/apache-apollo-1.7.1/bin/mybroker

2. 配置文件路径适配

打开 Linux 端的 mybroker/etc/apollo.xml，检查路径配置：

• Windows 用 \ 作为路径分隔符，Linux 用 /；
• 但 Apollo 支持 ${apollo.base} 变量（自动识别实例目录），所以只要原配置用了相对路径，Linux 会自动适配，无需手动修改。
• 举个例子：
  • 原 Windows 配置 directory="D:\apollo\data" → Linux 自动变成 ${apollo.base}/data。

五、启动 + 验证：确保服务正常

1. 启动 Linux 端 Apollo

用之前写好的 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

2. 三步验证服务可用性

1. 管理后台：浏览器访问 http://Linux 服务器 IP:61680，用默认账号 admin/password 登录（和 Windows 端一致）；
2. MQTT 连接：用 MQTTX 等工具，连接 tcp://Linux 服务器 IP:61613，发一条测试消息，能收到则正常；
3. 数据完整性：在管理后台查看'队列 / 主题'，和 Windows 端的数量、名称一致，说明数据迁移成功。

六、收尾：生产环境优化

1. 设置开机自启 避免服务器重启后服务挂掉，把 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
   

2. 关闭 Windows 端服务 确认 Linux 端完全正常后，彻底关掉 Windows 端的 Apollo，避免端口冲突。

七、避坑手册：常见问题解决

总结

Apollo 跨系统迁移的核心逻辑是 '复制实例文件 + 适配 Linux 环境'，只要注意'权限''路径'这两个坑，基本能一次成功。