Docker部署Cassandra容器：修改cassandra.yaml后重启重置问题求助

你遇到的情况是Docker容器和Cassandra官方镜像的特性共同导致的：

• Docker容器基于镜像的只读层+自身可写层运行，但官方Cassandra镜像的启动脚本（entrypoint）在容器启动时，会自动检查并重新生成/覆盖配置文件。你用docker cp修改的是容器可写层里的临时文件，一旦容器重启，启动脚本会按照镜像内的原始逻辑重置cassandra.yaml，导致你的修改丢失。
• 这种直接修改容器内文件的方式属于临时变更，没有脱离镜像的默认配置生命周期，重启必然被覆盖。

方法1：用环境变量指定配置（推荐） #

官方Cassandra镜像支持通过环境变量直接覆盖cassandra.yaml里的核心配置，无需手动修改配置文件。比如你要更新桥接IP相关配置，启动容器时可以这样写：

docker run -d \
  -e CASSANDRA_LISTEN_ADDRESS=你的新桥接IP \
  -e CASSANDRA_RPC_ADDRESS=你的新桥接IP \
  --name cassandra \
  cassandra:4.1.2

常用的环境变量与yaml配置对应关系：

• CASSANDRA_LISTEN_ADDRESS → listen_address
• CASSANDRA_RPC_ADDRESS → rpc_address
• CASSANDRA_SEEDS → seed_provider中的种子节点地址
• CASSANDRA_CLUSTER_NAME → cluster_name

这种方式的配置会被容器启动逻辑直接读取，重启也不会丢失。

方法2：挂载宿主机配置文件到容器 #

把宿主机上的cassandra.yaml挂载到容器内的对应路径，容器启动时会直接使用宿主机的配置，不会被镜像脚本覆盖：

1. 先将容器内的原始配置复制到宿主机：

docker cp cassandra:/etc/cassandra/cassandra.yaml /宿主机路径/cassandra.yaml

2. 修改宿主机上的cassandra.yaml，更新桥接IP等配置
3. 重新启动容器并挂载该文件：

docker run -d \
  -v /宿主机路径/cassandra.yaml:/etc/cassandra/cassandra.yaml \
  --name cassandra \
  cassandra:4.1.2

如果是已创建的容器无法直接添加挂载，建议导出容器数据后重新创建挂载配置的容器，不推荐用docker commit将修改后的容器做成新镜像（会导致镜像臃肿且不易维护）。

内容的提问来源于stack exchange，提问作者Sanghyeon.Jeon