配置服务器必须同时启用keyFile和authorization:keyFile保障集群组件间通信安全,authorization强制客户端连接时进行账号密码认证,否则存在绕过验证的安全漏洞。

配置服务器必须启用 authorization,不能只靠 keyFile
只在 configsvr 节点上配 keyFile 是不够的——它只管集群组件间通信(比如 mongos 和 config server 之间),但不控制客户端连接时的账号密码认证。要让客户端连 config server 时也必须登录,必须显式开启 authorization: enabled。
否则会出现:mongos 能正常路由,sh.status() 看起来正常,但直接连 config server(如 mongo localhost:27019/config)却能绕过所有用户验证,这是严重安全缺口。
- 配置文件中
security:块需同时包含两项: -
keyFile: /var/lib/mongo/auth/keyfile.key(所有节点一致) -
authorization: enabled(仅mongod-configsvr和mongod-shard*需要,mongos不支持该选项)
config server 的用户必须在 admin 库创建,且需同步到所有 config 节点
分片集群的 config server 是副本集(通常为 3 节点),用户数据存在 config.system.users 集合里,这个集合由 MongoDB 自动同步,但前提是:你必须在 primary config 节点上操作,并确保副本集状态健康(rs.status().members[n].stateStr === "PRIMARY")。
常见错误是:在某个 config 节点上用 use admin 创建了用户,但没确认当前连接的是 primary;或者副本集同步延迟导致新用户几秒内不可见。
- 先连 primary config 节点:
mongo --port 27019 use admindb.createUser({user:"cfgadmin", pwd:"xxx", roles:[{role:"root", db:"admin"}]})- 立刻验证:
db.auth("cfgadmin", "xxx")返回1再继续
mongos 不支持 authorization 配置,但必须用 --authenticationDatabase 指定认证库
mongos 进程本身不存用户,也不读 authorization 配置项。它把所有认证请求转发给 config server 或目标分片。所以你在 mongos 配置里加 authorization: enabled 会启动失败,报错:unrecognized field 'security.authorization'。
真正关键的是客户端怎么连 mongos:必须指定 --authenticationDatabase admin,否则即使用户名密码正确,也会提示 Authentication failed —— 因为默认尝试在 test 库查用户,而用户只建在 admin。
- 正确连接方式:
mongosh --port 20000 -u cfgadmin -p xxx --authenticationDatabase admin - 错误方式:
mongosh --port 20000 -u cfgadmin -p xxx(默认去test查,查不到) - 配置文件中 mongos 不写 security.authorization,只写
security.keyFile
config server 启动后 auth 失效的典型原因
最常被忽略的一点:config server 的 storage.dbPath 目录权限不对。如果 mongod 进程以 mongod 用户运行,但 /var/lib/mongo/config 所有者是 root,它会静默降级为无 auth 模式启动,日志里只有一行:WARNING: Access control is not enabled for the database,但进程不报错、不退出。
- 检查命令:
ls -ld /var/lib/mongo/config,确保 owner 是mongod - 修复命令:
chown -R mongod:mongod /var/lib/mongo/config - 重启前务必
systemctl stop mongod-configsvr,再systemctl start,不要用kill -2或信号重载


















