必须用权限600的keyfile启动所有节点,内容完全一致;启动时需--replSet和--bind_ip_all,初始化后创建admin用户并启用security.authorization。

必须用 keyfile 启动所有节点,且文件权限必须为 600;否则 mongod 直接拒绝启动,报错 keyfile permissions are too open。
keyfile 文件生成与权限设置
keyfile 本质就是一个随机字符串文件,MongoDB 不校验格式,只读取前 1024 字节。重点在于生成方式和系统级权限:
- 用
openssl rand -base64 756 > /data/mongodb/keyfile生成(长度 ≥ 756 字节,避免某些旧版本警告) - 必须执行
chmod 600 /data/mongodb/keyfile,且属主为运行 mongod 的用户(如chown mongodb:mongodb /data/mongodb/keyfile) - 不能放在 NFS 或容器临时卷上——部分系统会忽略 chmod,导致权限检查失败
- 所有副本集成员(包括 arbiter)必须使用**完全相同的文件内容**,建议用 scp 或配置管理工具分发,不要手动生成多次
mongod 启动参数中启用 internal authentication
仅靠 --keyFile 不够,必须配合 --replSet 和关闭绑定限制(否则初始化时无法连接):
- 启动命令必须包含:
mongod --replSet rs0 --keyFile /data/mongodb/keyfile --bind_ip_all --port 27017 -
--bind_ip_all是临时必需的——初始化 replica set 阶段需允许其他节点连入;认证启用后,访问控制由security.authorization: enabled管理,而非网络层 - 若已在配置文件中管理,对应字段为:
security.keyFile: "/data/mongodb/keyfile"+replication.replSetName: "rs0" - 切勿在未初始化 replica set 前就加
security.authorization: true,否则初始化命令rs.initiate()会因无权限被拒绝
初始化 replica set 后必须创建 admin 用户
keyfile 只解决节点间通信认证(internal authentication),不提供客户端登录能力。没有 admin 用户,后续任何操作都会被拒绝:
- 先连到 primary 节点(如
mongo --port 27017),执行rs.initiate()完成初始配置 - 再执行:
db.getSiblingDB("admin").createUser({user: "admin", pwd: "xxx", roles: ["root"]}) - 之后重启所有节点,并在配置中加入
security.authorization: true(或启动加--auth) - 客户端连接必须带凭证:
mongo -u admin -p xxx --authenticationDatabase admin --host rs0/localhost:27017
常见报错与定位路径
出问题时优先查日志,而不是反复改配置。典型错误基本都落在三个位置:
-
Failed to load keyfile: Permission denied→ 检查ls -l /data/mongodb/keyfile和ps aux | grep mongod看运行用户 -
No host described in new configuration with { _id: "rs0", ... } for replica set rs0→ 初始化前某个节点已用不同 replSetName 启动过,删掉dbpath下的local.*文件再试(注意备份) - 节点状态为
STARTUP2卡住、日志出现could not find member xxx in replset→ keyfile 内容不一致,或防火墙/hosts 解析阻断了节点间通信(用telnet other-host 27017测试)
keyfile 认证本身不加密传输,它只是让节点确认“你是不是自己人”;真正的数据安全依赖 TLS 和角色权限体系,别把它当成万能锁。











