副本集节点间通信必须配置net.tls.clusterFile,否则心跳、oplog拉取、选举等内部流量默认明文传输;该文件需为未加密PEM格式(证书+私钥),且所有节点的net.tls.clusterCAFile必须与net.tls.CAFile完全一致,时间同步误差不得超过5分钟。

副本集节点间通信必须配 net.tls.clusterFile
不配 net.tls.clusterFile,副本集成员之间的心跳、oplog 拉取、选举等内部流量默认走明文——哪怕 net.tls.mode 设为 requireTLS 也没用。你会看到从节点反复重连、状态卡在 STARTUP2,主节点却仍显示 PRIMARY,日志里只有模糊的 connection refused 或 no SSL certificate provided。
-
net.tls.clusterFile必须指向一个 PEM 文件,内容是该节点的证书 + 私钥(顺序:证书在前,私钥在后),不能加密(即不能含DEK-Info行) - 这个文件可以复用
net.tls.certificateKeyFile,但不推荐——生产环境建议为集群通信单独签发、单独管理 -
net.tls.clusterCAFile必须和net.tls.CAFile完全一致,否则节点间互相校验失败,错误信息类似:SSL peer certificate validation failed: unable to get local issuer certificate
分片集群所有组件必须统一启用 requireSSL
shard、config server、mongos 之间通信不是“选配”,而是“全有或全无”。一个节点用 --sslMode requireSSL,另一个用 allowSSL 或没配,连接会直接拒绝或静默失败——不是报错,而是连不上。
- 启动参数必须完全一致:
--sslMode requireSSL --sslPEMKeyFile /path/to/node.pem --sslCAFile /path/to/ca.crt - 所有节点的
--sslCAFile必须指向**同一个** CA 根证书;混用不同 CA 签发的证书(比如 shard 用 A-CA,config server 用 B-CA),会导致部分连接通、部分不通,极难排查 - 时间不同步超过 5 分钟也会导致 SSL 握手失败,错误信息常为:
SSL handshake failed: clock skew detected
x.509 认证和 keyfile 互斥,且 x.509 用户必须提前创建
选了 x.509 就不能再用 --keyFile,否则 mongod 启动直接退出,日志里只有一行模糊提示:can't use both keyFile and x.509。更隐蔽的问题是:x.509 用户没提前建好,shard 或 config server 会卡在启动阶段,日志反复刷 Unable to aut(截断)。
- 必须先在
$external数据库中创建用户,subject 要严格匹配证书subject字段,例如:db.getSiblingDB("$external").createUser({user: "CN=shard1,O=myorg", roles: [{role:"clusterAdmin", db:"admin"}]}) - 证书里的
O(Organization)、OU(Organizational Unit)等字段,所有节点必须完全一致;MongoDB 会逐字比对,大小写、空格、顺序都算数 - 如果用了
net.tls.clusterAuthX509.attributes自定义认证字段,所有节点配置必须一模一样
客户端连 mongos 时 tls=true 和 ssl=true 别混用
驱动版本决定参数名:老驱动(如 PyMongo 3.x)认 ssl=true,新驱动(PyMongo 4.0+、Node.js MongoDB Driver 4.0+)只认 tls=true。混用会导致连接成功但数据明文传输——表面正常,实则裸奔。
- Java 驱动设
sslEnabled=true却漏掉sslInvalidHostNameAllowed=false,证书域名校验被跳过,看似连得上,其实没认证 - Python 连接串写成
mongodb://host/?ssl=true&tlsCAFile=/ca.crt,参数名不统一,驱动可能忽略tlsCAFile,握手失败 - Node.js 驱动若漏
tlsAllowInvalidHostnames: false,测试环境没问题,上线后因证书 CN/SAN 不匹配突然连不上
证书 SAN 必须覆盖所有访问入口,包括内网 IP 和 DNS 名;配置项缺一不可;节点时间、CA 一致性、驱动参数命名——这些点单独看都简单,但串在一起就容易漏掉一两个,结果就是集群启得动、连不上、查不出原因。











