在Docker中配置Cassandra多数据中心需统一设置CASSANDRA_DC、CASSANDRA_RACK、CASSANDRA_ENDPOINT_SNITCH（推荐GossipingPropertyFileSnitch）和CASSANDRA_CLUSTER_NAME；单机模拟须规避端口冲突，生产环境需跨主机网络互通并显式配置CASSANDRA_BROADCAST_ADDRESS；键空间必须使用NetworkTopologyStrategy指定各DC副本数。
在 Docker 中运行容器化的 Cassandra 并配置多数据中心（Multi-DC）拓扑，核心在于正确设置 CASSANDRA_DC、CASSANDRA_RACK、CASSANDRA_ENDPOINT_SNITCH 和跨 DC 的种子节点通信。单机模拟多 DC 时需避免端口冲突和网络混淆，生产环境则需真实隔离网络与 IP 规划。
关键配置项必须对齐
所有节点必须统一 snitch 类型，并显式声明所属数据中心与机架：
-
CASSANDRA_ENDPOINT_SNITCH：必须设为
GossipingPropertyFileSnitch（推荐）或PropertyFileSnitch；前者自动读取cassandra-rackdc.properties，无需手动挂载配置文件 -
CASSANDRA_DC：例如
datacenter1或us-east，每个 DC 内所有节点值必须完全一致 -
CASSANDRA_RACK：例如
rack1，同一物理机/VM 上的多个节点建议设不同 rack 值以提升容错 - CASSANDRA_CLUSTER_NAME：全集群唯一，所有节点必须相同
单机多 DC 模拟（开发/测试常用）
用 Docker Compose 启动两个逻辑 DC，每个 DC 至少一个种子节点。注意：不能复用相同端口映射，需为每节点分配独立 host 端口：
version: '3.8'
services:
cassandra-dc1-node1:
image: cassandra:4.0
environment:
- CASSANDRA_CLUSTER_NAME=MyCluster
- CASSANDRA_DC=datacenter1
- CASSANDRA_RACK=rack1
- CASSANDRA_ENDPOINT_SNITCH=GossipingPropertyFileSnitch
- CASSANDRA_SEEDS=cassandra-dc1-node1,cassandra-dc2-node1
ports:
- "9042:9042"
- "7000:7000"
networks:
- cassandra-net
<p>cassandra-dc2-node1:
image: cassandra:4.0
environment:</p><ul><li>CASSANDRA_CLUSTER_NAME=MyCluster</li><li>CASSANDRA_DC=datacenter2</li><li>CASSANDRA_RACK=rack1</li><li>CASSANDRA_ENDPOINT_SNITCH=GossipingPropertyFileSnitch</li><li>CASSANDRA_SEEDS=cassandra-dc1-node1,cassandra-dc2-node1
ports:</li><li>"9043:9042"</li><li>"7001:7000"
networks:</li><li>cassandra-net</li></ul><p>networks:
cassandra-net:
driver: bridge
启动后执行 docker-compose exec cassandra-dc1-node1 nodetool status，应看到两行输出，分别标记 datacenter1 和 datacenter2，状态为 UN（Up Normal）。
跨主机多 DC 部署（生产就绪）
当节点分布在不同物理机或云区域时，必须显式指定广播地址并确保网络互通：
- 每台宿主机上启动容器时，通过
-e CASSANDRA_BROADCAST_ADDRESS=宿主机公网/内网IP告知其他节点如何访问本节点 - 所有种子节点 IP 必须可被全部节点路由（如通过 VPC 对等连接、专线或开放安全组）
- 使用
SimpleSeedProvider时，CASSANDRA_SEEDS应填入各 DC 的至少一个稳定节点 IP，例如：10.10.1.10,10.20.1.10（分别属于 dc1 和 dc2） - 验证时重点检查
nodetool describecluster是否显示多个 DC，以及nodetool ring中 token 分布是否按 DC 分组
键空间级多 DC 复制策略
创建 keyspace 时必须选用支持多 DC 的复制策略，否则数据无法跨中心同步：
CREATE KEYSPACE myapp WITH REPLICATION = {
'class': 'NetworkTopologyStrategy',
'datacenter1': 3,
'datacenter2': 2
};
其中 datacenter1 和 datacenter2 必须与节点配置中的 CASSANDRA_DC 值严格一致。若使用 SimpleStrategy，仅支持单 DC，跨 DC 节点将被忽略。
