你可能听过那句著名的吐槽:MongoDB 默认不开启认证,装完就能直接用,于是它成了勒索软件最爱的目标——2017 年前后,全球有数万个 MongoDB 实例因为没有设置密码、端口直接暴露在公网上,数据被删光并留下勒索比特币的留言。这不是段子,是真实发生过的大规模事件。所以这篇教程的第一原则:装完之后的第一件事永远是开启认证,而不是开始写业务代码。下面从安装、配置、用户权限、副本集到远程连接,按顺序讲一遍生产环境该怎么部署 MongoDB。
一、安装:选择正确的版本与源
MongoDB 从 5.0 开始采用了新的版本策略(x.y 主版本每年一个大版本,z 是补丁),并且自带了新的 shell 工具 mongosh(老的 mongo 命令在 6.0 之后已从安装包中移除)。生产环境建议选择当前的 LTS 主版本,并保持补丁版本最新。
1.1 在 Ubuntu / Debian 上安装
# 导入公钥
curl -fsSL https://www.mongodb.org/static/pgp/server-7.0.asc | \
sudo gpg -o /usr/share/keyrings/mongodb-server-7.0.gpg --dearmor
# 添加官方源(以 Ubuntu 22.04 jammy 为例)
echo "deb [ signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] \
https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/7.0 multiverse" | \
sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list
sudo apt-get update
sudo apt-get install -y mongodb-org
# 锁定版本,避免 apt upgrade 意外跨大版本升级
sudo apt-mark hold mongodb-org mongodb-org-database mongodb-org-server \
mongodb-mongosh mongodb-org-mongos mongodb-org-tools
1.2 在 RHEL / CentOS / Rocky 上安装
# /etc/yum.repos.d/mongodb-org-7.0.repo [mongodb-org-7.0] name=MongoDB Repository baseurl=https://repo.mongodb.org/yum/redhat/9/mongodb-org/7.0/x86_64/ gpgcheck=1 enabled=1 gpgkey=https://www.mongodb.org/static/pgp/server-7.0.asc sudo yum install -y mongodb-org sudo systemctl enable --now mongod sudo systemctl status mongod
安装后的关键路径需要记住:配置文件 /etc/mongod.conf、数据目录 /var/lib/mongo、日志 /var/log/mongodb/mongod.log、服务名 mongod.service、默认端口 27017。
1.3 部署前必须做的系统准备
MongoDB 官方有几条硬性建议,不做会在日志里看到 WARNING:
# 1. 关闭 Transparent Huge Page(WiredTiger 在 THP 下性能明显下降) # 永久生效:创建 systemd 服务或写入 rc.local echo never > /sys/kernel/mm/transparent_hugepage/enabled echo never > /sys/kernel/mm/transparent_hugepage/defrag # 2. 调整 ulimit,MongoDB 建议 nofile 至少 64000 cat > /etc/security/limits.d/99-mongodb.conf <二、核心配置文件逐项解析
默认的
/etc/mongod.conf是 YAML 格式,缩进必须用空格,不能用 Tab。下面是一份生产可用的配置:# /etc/mongod.conf systemLog: destination: file logAppend: true path: /var/log/mongodb/mongod.log logRotate: reopen storage: dbPath: /var/lib/mongo journal: enabled: true engine: wiredTiger wiredTiger: engineConfig: cacheSizeGB: 4 # 默认约为 (RAM - 1GB) 的 50%,建议显式设置 processManagement: timeZoneInfo: /usr/share/zoneinfo fork: false # 用 systemd 管理时保持 false net: port: 27017 bindIp: 127.0.0.1,10.0.0.21 # 严禁写 0.0.0.0 maxIncomingConnections: 20000 security: authorization: enabled keyFile: /etc/mongodb/keyfile # 副本集/分片集群内部认证 replication: replSetName: rs0 oplogSizeMB: 20480 # 不指定时默认约为磁盘空间的 5%(上限 50GB) operationProfiling: mode: slowOp slowOpThresholdMs: 1002.1 bindIp:安全的第一道门
bindIp决定 mongod 监听哪个网卡地址。默认安装后是127.0.0.1,只允许本机连接。很多人为了"能连上"直接改成0.0.0.0,这是最危险的一步操作——它意味着任何能访问到这台机器 27017 端口的人都能连进来。正确做法是绑定到内网地址,并且配合防火墙做双重限制:
# 只监听内网 IP bindIp: 10.0.0.21 # 防火墙只放行内网段访问 27017 # firewalld sudo firewall-cmd --permanent --add-rich-rule='rule family="ipv4" \ source address="10.0.0.0/24" port protocol="tcp" port="27017" accept' sudo firewall-cmd --reload # 或 iptables iptables -A INPUT -p tcp -s 10.0.0.0/24 --dport 27017 -j ACCEPT iptables -A INPUT -p tcp --dport 27017 -j DROP如果确实需要跨公网访问(比如云上多个 VPC 之间),请使用 VPN、专线,或者启用 TLS 加密(
net.tls.mode: requireTLS)并配合 IP 白名单,不要裸奔。2.2 authorization:认证的开关
security.authorization有两个值:disabled(默认,不启用认证)和enabled(启用基于角色的访问控制 RBAC)。这里有个很实用的部署技巧:先在 authorization 未开启的状态下创建管理员用户,再开启认证重启。因为 MongoDB 有一个"localhost exception"机制——开启认证后,如果系统中还没有任何用户,从本机(localhost)连接的会话拥有全部权限。利用它可以直接建管理员,但更稳妥的做法是显式按顺序操作:
- 先以
authorization: disabled启动,创建 root 管理员用户;- 修改配置为
authorization: enabled并重启 mongod;- 用管理员身份登录,再创建业务用户和应用用户;
- 验证所有连接串都能通过认证,且匿名连接被拒绝。
# 验证认证是否生效:不带凭据连接后执行命令应报错 mongosh --port 27017 --quiet --eval 'db.getSiblingDB("test").coll.countDocuments({})' # MongoServerError: command count requires authentication2.3 WiredTiger cacheSizeGB
WiredTiger 的缓存默认值比较复杂:在 4.0 之后,默认值是
max(RAM × 50% - 1GB, 256MB)。对于一台 16GB 内存的专用机,默认约 7GB。但要注意这个缓存只缓存"热数据",而 MongoDB 还有一部分内存依赖操作系统的 page cache(WiredTiger 的数据文件是 mmap 方式访问的)。所以如果这台机器上还跑了别的服务,或者你希望留更多给 OS 缓存,就应该显式设置。经验值:专用机器上设为物理内存的 50%-60%;混部机器上设为 30%-40%。三、用户权限:内置角色与最小权限原则
MongoDB 的授权模型是"用户 + 角色"两层。角色定义在某个数据库上,用户创建时赋予一个或多个角色。用户存放在哪个库(authentication database,即
authSource),连接时就要指定哪个库做认证——这是远程连接最常见的踩坑点。3.1 常用内置角色速查
角色 授权范围 权限说明 典型使用者 read 指定库 只读所有非系统集合 只读查询服务 readWrite 指定库 读写所有非系统集合 业务应用主账号 dbAdmin 指定库 建索引、建集合、 dbStats、compact,不含读写数据运维/DBA dbOwner 指定库 readWrite + dbAdmin + userAdmin 的组合 库负责人 userAdmin 指定库 管理该库下的用户和角色 权限管理员 clusterAdmin 集群(admin 库) 副本集/分片集群管理, rs.*、sh.*命令,含 clusterMonitor 和 clusterManagerDBA clusterMonitor 集群(admin 库) 只读监控, serverStatus、rs.status()监控系统 backup / restore 集群(admin 库) mongodump/mongorestore 所需权限 备份任务 root 全局 超级用户,含以上全部 仅应急,禁止应用使用 3.2 创建用户的实操
// 1. 在 admin 库创建超级管理员(只在部署初期用一次) use admin db.createUser({ user: "root", pwd: passwordPrompt(), // 交互式输入,不会留在 history 里 roles: [{ role: "root", db: "admin" }] }) // 2. 创建业务库用户(注意:要在业务库下执行 createUser) use orderdb db.createUser({ user: "app_rw", pwd: passwordPrompt(), roles: [ { role: "readWrite", db: "orderdb" } ] }) // 3. 创建只读用户(给报表/BI 用) use orderdb db.createUser({ user: "bi_reader", pwd: passwordPrompt(), roles: [ { role: "read", db: "orderdb" }, { role: "read", db: "productdb" } ] }) // 4. 创建监控用户(最小权限,只给 clusterMonitor) use admin db.createUser({ user: "monitor", pwd: passwordPrompt(), roles: [{ role: "clusterMonitor", db: "admin" }] }) // 5. 创建备份用户 use admin db.createUser({ user: "backup_agent", pwd: passwordPrompt(), roles: [ { role: "backup", db: "admin" }, { role: "restore", db: "admin" } ] })3.3 用户管理常用命令
// 查看当前库所有用户 db.getUsers() // 查看某个用户 db.getUser("app_rw") // 修改密码 db.changeUserPassword("app_rw", passwordPrompt()) // 追加角色(不影响已有角色) db.grantRolesToUser("app_rw", [{ role: "dbAdmin", db: "orderdb" }]) // 回收角色 db.revokeRolesFromUser("app_rw", [{ role: "dbAdmin", db: "orderdb" }]) // 删除用户 db.dropUser("app_rw") // 自定义最小权限角色(推荐做法) use orderdb db.createRole({ role: "orderAppRole", privileges: [ { resource: { db: "orderdb", collection: "orders" }, actions: ["find", "insert", "update"] }, { resource: { db: "orderdb", collection: "order_logs" }, actions: ["find", "insert"] } ], roles: [] }) db.grantRolesToUser("app_rw", [{ role: "orderAppRole", db: "orderdb" }])权限设计上要坚持两点:应用账号绝不使用 root;能用自定义角色就不用内置大角色。一个只负责写入订单的应用账号,就不该有删集合、建索引的权限——这能在代码出现 bug 或被注入时显著降低破坏范围。
四、副本集:从单机到高可用
生产环境几乎不应该用单机 MongoDB。副本集(replica set)是 MongoDB 的高可用基础:一个主节点(primary)接受写,多个从节点(secondary)通过 oplog 复制数据,主节点故障时自动选举新主。
4.1 内部认证的 keyFile
副本集成员之间也需要互相认证。用 keyFile(共享密钥)方式:
# 生成密钥文件(内容 6-1024 字符的 base64) openssl rand -base64 756 > /etc/mongodb/keyfile chmod 400 /etc/mongodb/keyfile chown mongod:mongod /etc/mongodb/keyfile # 把同一个文件分发到所有成员,权限必须是 400 或 600 scp /etc/mongodb/keyfile root@10.0.0.22:/etc/mongodb/keyfile4.2 初始化副本集
在三台机器的配置文件里都写好相同的
replication.replSetName: rs0和security.keyFile,启动 mongod 之后,在任意一个节点执行一次rs.initiate():// 用 mongosh 连接其中一个节点 mongosh "mongodb://root@10.0.0.21:27017/admin" rs.initiate({ _id: "rs0", members: [ { _id: 0, host: "10.0.0.21:27017", priority: 2 }, // 优先成为主节点 { _id: 1, host: "10.0.0.22:27017", priority: 1 }, { _id: 2, host: "10.0.0.23:27017", priority: 1 } ] }) # 查看状态 rs.status() // 成员健康、角色、optime 同步进度 rs.conf() // 当前配置 db.hello() // 当前节点角色 isWritablePrimary / primary 字段
rs.status()里几个关键字段:members[].stateStr是PRIMARY/SECONDARY/ARBITER;members[].health是 1 或 0;members[].optimeDate表示该成员已同步到的时间点,与主节点对比就能看出延迟;members[].lag(在某些版本显示)是落后秒数。4.3 成员角色类型
类型 priority 是否持有数据 能否被选为主 用途 普通 secondary 1(默认) 是 能 标准副本 高优先级成员 2-1000 是 优先当选 指定首选主节点 隐藏成员 hidden 0 是 不能 跑备份、报表,客户端不可见 延迟成员 slaveDelay 0 是 不能 误操作回滚的"后悔药" 仲裁者 arbiter 0 否 不能 只投票凑票数,不推荐多用 // 添加一个隐藏的备份节点 rs.add({ host: "10.0.0.24:27017", priority: 0, hidden: true }) // 添加一个延迟 1 小时的成员(用于误删数据应急恢复) rs.add({ host: "10.0.0.25:27017", priority: 0, hidden: true, slaveDelay: 3600 }) // 移除成员 rs.remove("10.0.0.24:27017") // 主动让主节点下台(维护时用,会触发重新选举) rs.stepDown(60) // 60 秒内该节点不能再次当选4.4 oplog:复制的血液
oplog(operations log)是
local库里的一个固定集合(capped collection)local.oplog.rs,记录主节点上的所有写操作,从节点异步拉取并重放。oplog 是幂等的——同一条 oplog 重放多次结果相同,这是 MongoDB 复制可靠性的基础。// 查看 oplog 大小与时间窗口(这是最重要的运维指标之一) db.getSiblingDB("local").oplog.rs.stats().maxSize // 字节 rs.printReplicationInfo() // 输出示例: // configured oplog size: 20480MB // log length start to end: 38.5hrs (0.01hrs remaining) ← oplog 能覆盖多久 // 查看复制延迟 rs.printSecondaryReplicationInfo() // source: 10.0.0.22:27017 // syncedTo: Mon Oct 14 10:23:45 GMT+0800 (CST) // 0 secs (0 hrs) behind the primaryoplog 窗口(log length start to end)决定了你能容忍从节点离线多久。如果它显示只有 4 小时,那意味着任何从节点掉线超过 4 小时,它的数据就会因为 oplog 已被覆盖而"太旧",需要全量重新同步(initial sync)。生产环境建议把 oplog 窗口保持在 24-72 小时。修改 oplog 大小在 4.0+ 可以用
replSetResizeOplog在线调整:// 调整为 30GB(单位 MB) db.adminCommand({ replSetResizeOplog: 1, size: 30720 }) db.getSiblingDB("local").oplog.rs.stats().maxSize五、远程连接:连接串、写入关注与读偏好
5.1 连接字符串格式
# 连接到副本集(推荐写法,自动发现主节点并跟随选举) mongosh "mongodb://app_rw:Pass@10.0.0.21:27017,10.0.0.22:27017,10.0.0.23:27017/orderdb?replicaSet=rs0&authSource=orderdb" # 如果用户在 admin 库创建,authSource 必须是 admin mongosh "mongodb://root:Pass@10.0.0.21:27017/admin?replicaSet=rs0&authSource=admin" # 常用连接参数 # replicaSet=rs0 指定副本集名,启用自动故障转移 # authSource=admin 认证数据库(用户存在哪个库) # readPreference=secondaryPreferred 读偏好 # w=majority 写入关注 # connectTimeoutMS=5000 / socketTimeoutMS=30000 # maxPoolSize=100 连接池大小 # retryWrites=true 自动重试可重试写(4.2+ 默认开启) # tls=true 启用 TLS 加密 # 只读账号走从节点,减轻主库压力 mongosh "mongodb://bi_reader:Pass@10.0.0.21:27017,10.0.0.22:27017/orderdb?replicaSet=rs0&authSource=orderdb&readPreference=secondaryPreferred"最容易出错的一点就是
authSource。很多人在admin库下创建了所有用户(因为习惯),连接时业务库写成/orderdb却没指定authSource=admin,结果一直报Authentication failed。记住规则:authSource必须等于创建该用户时所在的那个库。5.2 readPreference:读偏好
模式 行为 一致性 适用场景 primary(默认) 只读主节点 强一致 默认,所有对一致性敏感的业务 primaryPreferred 优先主,主不可用时读从 基本强一致 主故障时仍要可读 secondary 只读从节点 最终一致,有延迟 报表、分析 secondaryPreferred 优先从,无从节点时读主 最终一致 读写分离,常用 nearest 按网络延迟选最近的(不分主从) 最终一致 跨地域部署,追求低延迟 注意:读偏好只对读操作生效,写操作永远走主节点。另外在事务中使用
secondary读偏好是不推荐的,MongoDB 4.4 之后事务支持跨分片读,但语义上事务应走 primary。5.3 writeConcern:w 与 j
写入关注决定"什么算写成功"。它由两部分组成:
w(write concern):值为数字表示"要等几个节点确认","majority"表示等待多数派(副本集多数成员数,如 3 节点集群是 2)确认,1表示只要主节点写完就返回(默认值)。j(journal):true表示要求写入已落到 journal(磁盘日志),false表示只写入内存即可。默认在w: majority时j默认为 true(取决于writeConcernMajorityJournalDefault配置,默认 true)。// 集合级别设置默认写入关注 db.createCollection("orders", { writeConcern: { w: "majority", j: true } }) // 单次操作指定 db.orders.insertOne( { order_no: "A20241014001", amount: 199.00 }, { writeConcern: { w: "majority", j: true, wtimeout: 5000 } } ) // 查看当前默认写入关注 db.getSiblingDB("admin").runCommand({ getDefaultRWConcern: 1 })
组合 语义 数据安全性 性能 w:1, j:false(部分场景默认) 主节点内存写成功即返回 主节点宕机会丢 最快 w:1, j:true 主节点 journal 落盘 主节点进程崩溃不丢,整机故障可能丢 快 w:"majority", j:true 多数派 journal 落盘 不丢已确认的写 较慢,但推荐 w:3(全部成员) 等所有成员确认 最安全 最慢,任一成员慢就卡住 生产建议:核心业务用
w: "majority",并配wtimeout(比如 5000ms)避免一直阻塞。日志类、可容忍丢失的次要数据用w: 1换取吞吐。w: majority还有一个隐藏好处:只有 majority 读(readConcern: "majority")配合 majority 写才能保证读到的数据不会"回滚"(即读到的数据一定已经被多数派持久化)。六、部署检查清单
- 安装前关闭 THP、调大 ulimit、数据盘用 XFS + noatime。
- 配置文件中
bindIp绑定内网 IP,绝不写0.0.0.0;防火墙只放行业务网段。- 先建管理员用户,再设
authorization: enabled重启;验证匿名连接被拒绝。- 应用账号单独创建,权限按最小化原则授予,禁用 root 给应用。
- 配置副本集:三节点(或五节点),
keyFile权限 400,各成员replSetName一致。- 检查
rs.printReplicationInfo()的 oplog 窗口,确保大于 24 小时,不够就replSetResizeOplog。- 显式设置
wiredTiger.engineConfig.cacheSizeGB。- 开启慢查询分析:
operationProfiling.mode: slowOp,slowOpThresholdMs: 100。- 配置日志轮转(
logRotate: reopen+ logrotate 定时任务),避免日志撑爆磁盘。- 设置备份:用
mongodump(逻辑备份,小数据量)或文件系统快照 / Ops Manager(大数据量),并定期验证恢复。- 接入监控:副本集成员状态、oplog 窗口、复制延迟、连接数、cache 命中率(
wiredTiger.cache的bytes read into cache)、慢查询数。- 做一次故障演练:kill 主节点进程,观察选举耗时(正常应该在 10-12 秒内完成)和应用报错情况。
七、避坑清单
- 不要把 mongod 端口暴露到公网。这是被勒索的头号原因。如果必须跨公网,用 VPN 或 TLS + IP 白名单。
- 注意
authSource必须匹配用户所在的库。这是"密码明明正确但报 Authentication failed"最常见的原因。- 不要滥用 arbiter。一个三节点副本集里放两个数据节点加一个 arbiter,意味着只有一份真正的数据副本,一个数据节点挂了就只剩单点。有数据成员优先于 arbiter。
- 副本集成员数要是奇数。偶数个投票成员会导致选举平票。四节点时要配一个 arbiter 或改成三节点加一个隐藏节点。
- oplog 太小会导致从节点需要全量重同步。全量同步对大库来说可能要跑十几个小时,期间主库压力大增。
- 不要在业务高峰做
rs.stepDown()或滚动重启。每次主节点切换都会有短暂的写入不可用窗口(通常几秒),客户端要配置retryWrites和合理的serverSelectionTimeoutMS。- 升级不要跨大版本。MongoDB 要求逐级升级(如 5.0 → 6.0 → 7.0),跨版本会导致数据文件格式不兼容。升级前务必检查
featureCompatibilityVersion。- keyFile 权限必须正确。权限太开放(如 644)mongod 会拒绝启动并报 "permissions on the keyfile are too open"。
- 不要用 root 用户跑应用查询。一个误操作的
dropDatabase就是全库灾难。- 记得给
local库以外的备份留出权限。备份用户需要backup角色,且mongodump默认不备份local库(这是设计如此,oplog 用--oplog单独处理)。小结
MongoDB 服务器部署的完整链路是:系统准备(关 THP、调 ulimit、XFS)→ 官方源安装并锁版本 → 配置
mongod.conf(重点是bindIp与authorization)→ 先建管理员再开认证 → 按最小权限原则创建业务用户 → 配置副本集与 keyFile 内部认证 → 检查 oplog 窗口 → 用带replicaSet和正确authSource的连接串做远程连接 → 按业务分级设置readPreference和w: majority写入关注。这条链路上最容易出问题的三个点是:认证库搞错导致连不上、bindIp 写 0.0.0.0 导致裸奔、oplog 太小导致从节点频繁全量同步。把这三件事做对,再加上定期备份和一次真实的选举演练,一套 MongoDB 部署才算真正达到了生产可用标准。
企业QQ咨询




