Keyfile认证需严格遵循硬性契约:所有mongod节点共用同一份6–1024字节、权限400、属主为运行用户、无换行空格的密钥文件;security块中keyFile与authorization必须共存;mongos严禁配置keyFile;节点host必须为可解析主机名,禁用IP。

Keyfile认证不是“加个配置就能用”的功能,它是一套启动即锁定的硬性契约:所有 mongod 节点(shard、config server)必须共用同一份严格权限的二进制密钥文件,且 mongos 绝对不能配 security.keyFile,否则直接启动失败。
keyFile 文件生成与权限设置必须一步到位
生成命令必须用 openssl rand -base64 756 > /etc/mongod-keyfile,不能用 echo 或 dd;内容长度必须落在 6–1024 字节区间,且不能含换行或空格。MongoDB 5.0+ 强制要求权限为 400(仅所有者可读),chmod 600 会被拒绝并报错 Keyfile permissions are too open。属主必须是运行 mongod 的用户(如 mongod 或 mongodb),不能是 root。
mongod 配置中 security 块必须同时启用两项
security.keyFile 和 security.authorization: enabled 必须共存于同一级 security: 下,缺一不可:
security: keyFile: /etc/mongod-keyfile authorization: enabled
只开 keyFile 不开 authorization,客户端仍可无密码连接;只开 authorization 不配 keyFile,节点间同步会失败,日志出现 No keys found for replica set。另外,clusterAuthMode: keyFile 在 4.2+ 版本中必须显式声明,否则内部通信协商失败。
mongos 配置里严禁出现 security.keyFile
mongos 是无状态路由进程,不参与数据存储和节点间同步,因此不支持 keyFile。若在 mongos.conf 中误写 security: 块(哪怕只有一行 keyFile:),mongos 启动时会静默失败,日志只提示 Failed to load configuration from file,实际是配置语法校验不通过。正确做法是:确保 mongos.conf 中只有 sharding: 和 net: 块,完全移除 security:。
节点主机名必须全部可解析,IP 地址会被拒绝
从 MongoDB 5.0 开始,rs.initiate() 或分片集群初始化时,任意成员使用 IP(如 "192.168.1.10:27017")将导致该节点启动失败。所有 replSet 成员、shard、config server 的 host 字段必须是 DNS 主机名(如 "shard1.example.com:27017")。无 DNS 环境下,必须在每台机器的 /etc/hosts 中静态映射全部节点,且需验证 nslookup shard1.example.com 成功。SELinux/AppArmor 也常拦截 keyFile 读取,即使权限正确,也要检查 audit.log 或临时禁用验证。


















