先说结论:Apache Apollo 虽然官方早就停止更新,但我相信现在还点进这篇文章的朋友,大概率不是在选型,而是在“救火”——公司某个旧系统还在用 Apollo 做消息中间件,现在要把服务从 Windows 迁到 Linux 服务器。我上个月刚把一套生产环境的 Apollo 1.7.1 从 Windows Server 迁到了 CentOS 7.9,整个过程踩了不少坑,也整理出了一套可以照着抄的流程。今天这篇就把完整迁移过程、关键命令、配置改动和避坑点一次性说清楚。
如果你的情况和我类似:Apollo 跑在 Windows 上,数据文件已经积累了几个月甚至几年,业务方不给 downtime 太长,同时又没有专门的 MQ 运维专家,那这篇文章就是给你准备的。我不讲太虚的架构设计,只讲迁移当天你要做什么、先做哪一步、哪几个文件最容易出错、启动不了时怎么定位。
1. 迁移前准备:先搞清楚手上有什么
1.1 版本、目录结构与迁移边界
接手一个 Windows 上的 Apollo 实例,第一步不是急着打包上传,而是先看清楚它的目录结构。一个典型的 Apollo broker 实例目录包含 etc、data、log、bin 四块,分别对应配置、持久化数据、运行时日志和启动脚本。迁移时真正需要带走的只有两块:etc 和 data。
etc 目录里面是 broker.xml、users.properties、groups.properties、log4j.properties,有时候还有日志 login.config 和证书文件。data 目录则是 Apollo 使用 BDB(Berkeley DB Java Edition)落盘的消息存储,里面有事务日志、消息队列索引等文件。搞清楚这两块就够了,不要试图把整个 Windows 安装包拷过去,更不要带着 Windows 版的启动脚本去 Linux 上跑,后面我会解释为什么。
版本方面,Apollo 最多人用的是 1.7.1,几乎没有比这更新的版本。迁移前后务必保持一致,尤其是不能一边是 1.7.1、一边是 1.7.0,BDB 存储文件对版本很敏感,版本不一致轻则告警,重则直接起不来。先到 Windows 服务器上执行一下:
bash复制apollo version
或者直接看 lib 目录下 apollo 相关 jar 包的版本号,记下来,后面在 Linux 上必须用同一个版本。
1.2 Java 环境与系统架构确认
Apollo 是纯 Java 应用,核心就是一个 JVM 进程,所以迁移前要确认 Java 版本。Apollo 1.7.1 基于 Java 7/8 时代构建,实测在 JDK 8 下最稳。在 Windows 上执行:
bash复制java -version
如果在用 JDK 11 以上跑,建议你在 Linux 上还是退回 JDK 8。倒不是说完全跑不起来,而是遇到一些反射、类加载或 GC 参数问题后,排查成本会明显上升,生产环境迁移本来就是要尽量降低变量的。
还要看一眼 Windows 服务器的 CPU 架构。绝大多数是 x86_64,对应 Linux 侧直接装 amd64 的 JDK 即可。如果 Windows 跑在 arm 上,虽然少见,也要在 Linux 侧选择 arm64 版本 JDK,否则 JNI 相关的组件会出问题。
1.3 迁移方案选型:整包拷贝还是重建实例
我强烈建议采用“Linux 新建 broker 骨架 + 拷贝 etc/data 覆盖”的方案,而不是把整个 Windows broker 目录原封不动传过去。原因有三个:
- Windows 下的启动脚本是
.cmd,Linux 需要的是 shell 脚本,拷贝过去没法直接用,还会遇到 CRLF 换行符问题。 - 新建骨架能确保脚本、目录结构、权限都符合 Linux 环境习惯。
- 重建实例时你会被迫重新审视 broker.xml 中的路径,避免把 Windows 盘符路径带到 Linux。
但不要担心配置丢失,新创建的 broker 骨架里都是模板,我们只需要把 Windows 上真正的 etc 和 data 覆盖进去。等于说我们用模板搭了个架子,再把家当填进去,既干净又安全。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 在 Linux 侧搭建运行环境
2.1 安装 JDK 8 与基础依赖
Linux 服务器上先装 JDK,CentOS 7 下面我通常用 OpenJDK 8,命令如下:
bash复制sudo yum install -y java-1.8.0-openjdk java-1.8.0-openjdk-devel
装完后一定要配置 JAVA_HOME。Apollo 的启动脚本会直接引用 JAVA_HOME 来定位 java 命令,不配置后面大概率起不来。在 /etc/profile 或当前用户的 ~/.bashrc 里加上:
bash复制export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.xxx
export PATH=$JAVA_HOME/bin:$PATH
验证一下:
bash复制java -version
which java
确认
