mongod节点间双向认证≠客户端TLS双向认证,前者依赖security.keyFile+clusterAuthMode=keyFile(或x509)实现SASL身份互信,后者通过sslMode:requireSSL与allowConnectionsWithoutCertificates:false控制客户端连接。

mongod节点间双向认证 ≠ 客户端TLS双向认证
很多人看到“双向认证”第一反应是配 sslMode: requireSSL 和 allowConnectionsWithoutCertificates: false,但这只管客户端到 mongos 或直连 mongod 的链路,**完全不作用于分片节点之间(shard↔shard、shard↔config server)的通信**。分片集群内部节点握手走的是 SASL 协议,不是 TLS;它们用的是 keyFile 或 x.509 做身份校验,和你给应用配的证书毫无关系。
必须用 clusterAuthMode + keyFile 实现分片节点互信
分片节点(mongod 类型:shard 和 config server)之间的双向认证,本质是“所有节点用同一把密钥互相证明身份”。关键不是加密,而是防冒充——比如防止一个伪造的 shard 节点接入集群窃取 oplog。
-
security.keyFile必须在所有mongod节点(含 config server)上存在、路径一致、内容完全相同(6–1024 字节二进制,推荐openssl rand -base64 756生成) -
clusterAuthMode必须显式设为keyFile,不能依赖默认值;MongoDB 4.2 不会自动推断,不写就等于没开 - 文件权限必须是
600,属主必须匹配mongod进程运行用户(如mongod:mongod),否则启动直接失败,报Permissions on /path/to/keyfile are too open -
mongos节点**禁止配置security.keyFile或任何security:块**,它不参与内部认证,加了会导致启动失败,日志只显示Failed to load configuration from file
为什么加了 keyFile 还连不上?常见静默失败点
节点启动成功、rs.status() 看似正常,但 chunk 迁移卡住、sh.status() 显示某个 shard 状态为 UNKNOWN,大概率是内部认证没通。这不是网络问题,是 SASL 握手被拒。
- 新扩容的 shard/config server 没复用原有
keyFile,而是自己生成了一份——哪怕只差一个字节,SASL 就拒绝协商 - 复制完
keyFile后忘了chown mongod:mongod /etc/mongod-keyfile,导致 mongod 进程无法读取 - 没在新节点的
admin库里手动创建本地root用户:use admin; db.createUser({user:"admin", pwd:"xxx", roles:["root"]});mongos上建的用户不会同步到新mongod实例 - 配置里写了
security.authorization: enabled,但没提前在未认证状态下连 localhost 创建好第一个用户,导致重启后彻底锁死
想用 x.509 替代 keyFile?可以,但更重
如果你已有 PKI 体系,可以用 x.509 做节点间认证,替代 keyFile。但它要求更高:
- 每个
mongod节点的证书必须包含extendedKeyUsage = clientAuth, serverAuth - 证书的
subjectName必须与副本集成员配置里的 hostname 完全一致(MongoDB 4.2 不接受 IP) -
clusterAuthMode改为x509,且所有节点共用同一个 CA 证书(通过net.ssl.CAFile指定) - 不能再混用
keyFile,二者互斥;一旦启用x509,所有节点间通信强制走证书校验
实际生产中,keyFile 因其轻量和确定性,仍是金融、政务类 MongoDB 4.2 集群的首选。x.509 更适合已深度集成证书生命周期管理的云原生环境——但别低估它的调试成本:一个 subjectAltName 漏写、一个 CAFile 路径拼错,节点就会静默停留在 STARTUP2 状态,日志里几乎不报错。


















