上个月刚帮一台老掉牙的Windows Server上的Apache Apollo消息服务迁到了Linux虚拟机,前前后后折腾了三个晚上。这台Apollo是公司下单通知系统的消息中转站,每天有一批定时任务和实时消息往里塞,消息量不算大,但谁也不敢让它长时间停。说实话Apache Apollo本身已经停止维护好多年了,能在Windows上跑着已经算运气好,Windows服务器又时不时因为补丁、登录会话、内存占用闹脾气,老板终于松口:迁到Linux服务器上。
这篇文章不准备写那种“点几下鼠标就完成”的假教程,而是把真实的迁移命令、配置对照、踩坑记录都摊开来讲。不管你是还在维护老消息中间件,还是要把其他Java类服务从Windows搬到Linux,这套思路都能直接套用。核心就一句话:Apollo的配置和消息数据都在文件目录里,迁移的重点不是重装一个软件,而是把这套目录原封不动地搬过去,再把路径、权限、JDK、启动方式全部调整成Linux风格。
1. 迁移前必须搞明白的三件事
1.1 Apollo的“家底”到底放在哪里
很多人一开始会习惯性去找数据库迁移工具,其实Apollo根本不依赖外部的MySQL或者PostgreSQL,它的消息、队列、持久化订阅、虚拟主机配置都写在文件目录里。一个broker实例就是一个完整的目录,Windows上通常长这样:
text复制D:\apollo\bin\mybroker\
├── etc\ # 配置文件,包括broker.xml、users.properties、logback.xml
├── data\ # 消息数据,队列积压、游标、持久化订阅都在这里
├── log\ # 运行日志
├── tmp\ # 临时文件
└── bin\ # Windows下还会生成一些辅助脚本
这里最关键的是data目录,它是整个迁移的命根子。队列里积压了八千条消息、有一堆消费者订阅还没消费完,这些状态全部在data下面。配置文件丢了可以重新写,用户权限丢了可以补,唯独data丢了,业务方积压的消息就全没了,那才是事故。
所以我的第一条建议是:迁移前先搞清楚你的broker实例路径。别想当然认为Apollo装在D盘根目录就一切在D盘里,先到Windows服务管理器里看启动命令,或者看apollo-broker的进程路径,把真实路径找出来再说。
1.2 版本与JDK环境核对
Apache Apollo的版本号看着不复杂,但对JDK的要求比较死。我这次用的是1.7.1,官方要求JDK 8。Windows上原来装的是JDK 8,这个没问题,但如果你迁到Linux后图省事装了系统自带的OpenJDK 17,启动时十有八九会遇到UnsupportedClassVersionError,一查就是class文件版本不兼容。
建议迁移前先在Windows上执行一条命令把版本信息留个底:
bash复制apollo-broker --version
java -version
然后把Linux侧的JDK固定成JDK 8的某个OpenJDK版本。不要用JDK 11、不要用JDK 17,就算能强行跑起来,后面遇到奇怪的GC或者反射异常,排查成本远高于你提前装对版本的成本。
1.3 迁移范围与停机窗口
搞清楚数据在哪、版本匹配之后,第三个关键问题就是停机窗口。Apollo不像Kafka那样有原生的跨集群复制能力,想做到无缝切换很难,一般是停旧、搬数据、启动新、验证切换,整个流程要控制在业务允许的停机时间内。
我会先做一次预演:把Windows上的broker实例完整打包拷到测试Linux机器,启动后确认队列消息数、订阅关系、消息收发都正常,再约业务方正式切换。正式切换前还要通知所有消息生产方和消费方停写停读,等存量消息消费得差不多了再停broker,这样迁移过去的data目录会比较干净,积压消息也不容易丢。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 从备份到启动:迁移全程实操
2.1 源端:Windows上的数据备份与干净停机
迁移的第一步不是打包,而是先让Apollo“安静下来”。我见过有人直接对着运行中的目录Ctrl+C复制,结果到Linux一启动,store文件不一致,broker直接拒绝启动。
正确操作分几步:
先记下当前运行状态,包括端口占用、连接数、队列积压,方便迁移后对比。然后通知业务方暂停写操作,观察队列消息是否被消费掉。等消息清得差不多了,用Windows下的broker脚本执行停止:
bash复制apollo-broker.cmd stop mybroker
如果这时候进程还没退干净,再看一眼任务管理器,确认jav
