debian mongodb配置要注意什么

在 Debian 上配置 MongoDB（通常指官方 MongoDB Server，而非系统自带旧版包）时，有几个容易踩坑的点和推荐做法，下面按重要性梳理。

一、安装方式（最容易被坑）

❌ 不要直接用 apt install mongodb

Debian 默认仓库里的 mongodb 通常是很旧的版本，甚至只是客户端。

✅ 推荐：使用 MongoDB 官方 APT 源

# 示例（以 7.0 为例）
curl -fsSL https://pgp.mongodb.com/server-7.0.asc | sudo gpg -o /usr/share/keyrings/mongodb-server-7.0.gpg --dearmor
echo "deb [ signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] https://repo.mongodb.org/apt/debian bookworm/mongodb-org/7.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list
apt update
apt install -y mongodb-org

二、数据目录权限（高频故障）

MongoDB 默认数据目录：

/var/lib/mongodb

常见问题：

• 权限不对 → 启动失败
• 手动改目录后没改 owner

正确做法：

chown -R mongodb:mongodb /var/lib/mongodb
chmod 700 /var/lib/mongodb

三、systemd 启动问题

Debian 使用 systemd，注意：

systemctl enable mongod
systemctl start mongod

查看状态：

systemctl status mongod
journalctl -u mongod -n 50

⚠️ 如果启动失败，90% 原因在日志里写得很清楚（权限 / 配置 / 端口）

四、配置文件位置与写法

配置文件：

/etc/mongod.conf

常见注意点：

1️⃣ 绑定 IP（安全）

默认只监听 127.0.0.1

如果需要远程访问：

net:
  bindIp: 0.0.0.0

⚠️ 公网暴露必须加认证

2️⃣ 开启认证（非常重要）

security:
  authorization: enabled

然后创建管理员：

use admin
db.createUser({
  user: "admin",
  pwd: "强密码",
  roles: ["root"]
})

五、WiredTiger 与磁盘空间

MongoDB 默认使用 WiredTiger：

• 会预分配磁盘
• 小内存机器容易 OOM

建议：

• 至少 2GB RAM
• 生产环境单独挂载数据盘

六、透明大页（THP）问题（性能坑）

Debian 默认开启 THP，会导致 MongoDB 延迟抖动。

关闭方法：

echo never > /sys/kernel/mm/transparent_hugepage/enabled
echo never > /sys/kernel/mm/transparent_hugepage/defrag

并写入开机脚本（或 systemd unit）。

七、日志与备份

日志

systemLog:
  destination: file
  path: /var/log/mongodb/mongod.log
  logAppend: true

备份

不要用 cp 直接拷数据目录
✅ 使用：

mongodump
mongorestore

八、版本与 Debian 对应关系

九、常见错误速查

如果你愿意，我可以：

• 给你一份 Debian + MongoDB 生产级配置文件
• 或针对 单机 / 副本集 / 公网部署分别说明

你现在是 学习 / 开发 / 生产环境？