MongoDB服务器部署教程:安装配置、用户权限与远程连接

你可能听过那句著名的吐槽: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: 100

2.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)连接的会话拥有全部权限。利用它可以直接建管理员,但更稳妥的做法是显式按顺序操作:

  1. 先以 authorization: disabled 启动,创建 root 管理员用户;
  2. 修改配置为 authorization: enabled 并重启 mongod;
  3. 用管理员身份登录,再创建业务用户和应用用户;
  4. 验证所有连接串都能通过认证,且匿名连接被拒绝。
# 验证认证是否生效:不带凭据连接后执行命令应报错
mongosh --port 27017 --quiet --eval 'db.getSiblingDB("test").coll.countDocuments({})'
# MongoServerError: command count requires authentication

2.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/keyfile

4.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是否持有数据能否被选为主用途
普通 secondary1(默认)是能标准副本
高优先级成员2-1000是优先当选指定首选主节点
隐藏成员 hidden0是不能跑备份、报表,客户端不可见
延迟成员 slaveDelay0是不能误操作回滚的"后悔药"
仲裁者 arbiter0否不能只投票凑票数,不推荐多用
// 添加一个隐藏的备份节点
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 primary

oplog 窗口(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 写才能保证读到的数据不会"回滚"(即读到的数据一定已经被多数派持久化)。

六、部署检查清单

  1. 安装前关闭 THP、调大 ulimit、数据盘用 XFS + noatime。
  2. 配置文件中 bindIp 绑定内网 IP,绝不写 0.0.0.0;防火墙只放行业务网段。
  3. 先建管理员用户,再设 authorization: enabled 重启;验证匿名连接被拒绝。
  4. 应用账号单独创建,权限按最小化原则授予,禁用 root 给应用。
  5. 配置副本集:三节点(或五节点),keyFile 权限 400,各成员 replSetName 一致。
  6. 检查 rs.printReplicationInfo() 的 oplog 窗口,确保大于 24 小时,不够就 replSetResizeOplog。
  7. 显式设置 wiredTiger.engineConfig.cacheSizeGB。
  8. 开启慢查询分析:operationProfiling.mode: slowOp,slowOpThresholdMs: 100。
  9. 配置日志轮转(logRotate: reopen + logrotate 定时任务),避免日志撑爆磁盘。
  10. 设置备份:用 mongodump(逻辑备份,小数据量)或文件系统快照 / Ops Manager(大数据量),并定期验证恢复。
  11. 接入监控:副本集成员状态、oplog 窗口、复制延迟、连接数、cache 命中率(wiredTiger.cache 的 bytes read into cache)、慢查询数。
  12. 做一次故障演练: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 部署才算真正达到了生产可用标准。