容器重启后Kafka配置丢失？ZK转Kraft迁移配置持久化咨询

核心结论 #

不需要每次修改配置都重新构建镜像，通过Podman卷挂载本地配置文件即可实现配置修改的持久化，重启容器后配置依然有效。

具体操作步骤 #

1. 导出容器默认配置文件（首次操作） #

先从运行中的Kafka容器（或Kraft控制器容器）把默认的server.properties复制到本地，方便后续修改：

# 替换<container-name>为你的容器名称，/opt/kafka/config/为容器内配置文件的常规路径，可根据实际镜像调整
podman cp <container-name>:/opt/kafka/config/server.properties ./local-server.properties

2. 本地修改配置文件 #

直接编辑本地的local-server.properties，添加或修改迁移所需的配置项，比如：

zookeeper.metadata.migration.enable=true

3. 重新启动容器并挂载配置文件 #

停止并删除旧容器（已运行的容器无法动态添加挂载规则），然后用挂载命令启动新容器，让容器直接使用本地的配置文件：

# 停止并删除旧容器
podman stop <old-container-name> && podman rm <old-container-name>

# 启动新容器，挂载本地配置文件到容器对应路径
# 替换<kafka-image-name>为你的镜像名称，可根据需求添加端口映射等其他参数
podman run -d --name kafka-broker \
  -v ./local-server.properties:/opt/kafka/config/server.properties \
  <kafka-image-name>

4. Kraft控制器的配置持久化 #

Kraft控制器的配置处理逻辑完全一致：导出默认配置到本地，修改后挂载到控制器容器的对应配置路径，重启容器即可。

为什么之前的修改会丢失？ #

容器的文件系统属于临时可写层，通过podman exec进入容器修改的内容仅存在于当前容器实例中，当容器停止并销毁后，这些临时修改会被彻底清除。只有通过挂载宿主机文件或持久化卷，才能让配置在容器重启/重建后保持不变。

内容的提问来源于stack exchange，提问作者BloodFury