MongoDB如何与Ubuntu集成

在 Ubuntu 上集成 MongoDB 的实操指南

一 环境准备与版本选择

• 确认系统版本与架构：仅 x86_64 的 Ubuntu 24.04 LTS（Noble）/ 22.04 LTS（Jammy）/ 20.04 LTS（Focal） 受 MongoDB 8.0 Community 官方支持。执行：cat /etc/lsb-release 查看版本。
• 资源建议：将打开文件数限制提升到至少 64000（MongoDB 启动会给出警告）：ulimit -n 64000。
• 安装基础工具：sudo apt-get install -y software-properties-common gnupg apt-transport-https ca-certificates。
  以上为后续安装与稳定运行的前提条件。

二 安装 MongoDB Community Edition

• 导入 MongoDB 公共 GPG 密钥（以 8.0 为例，其他版本替换版本号）：
  curl -fsSL https://www.mongodb.org/static/pgp/server-8.0.asc | sudo gpg -o /usr/share/keyrings/mongodb-server-8.0.gpg --dearmor
• 添加 APT 源（按你的 Ubuntu 代号替换 noble/jammy/focal）：
  echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu noble/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
• 刷新索引并安装：
  sudo apt-get update
sudo apt-get install -y mongodb-org
  安装完成后会自动创建数据目录 /var/lib/mongodb 与日志目录 /var/log/mongodb，并以 mongodb 用户运行。

三 服务管理与基础验证

• 启动与自启：
  sudo systemctl start mongod
sudo systemctl enable mongod
  若提示 Unit 未找到，先执行 sudo systemctl daemon-reload。
• 状态与端口检查：
  sudo systemctl status mongod（应见 Active: active (running)）
  ss -pnltu | grep 27017（应见监听 27017 端口）
• 连接测试：
  mongosh（默认连接本机 127.0.0.1:27017）
  以上确保 MongoDB 以系统服务方式稳定运行并与本地 Shell 正常联通。

四 安全与远程访问配置

• 启用认证（先以无认证模式创建管理员，再开启安全）：
  1. 连接 Shell：mongosh
  2. 切换到 admin：use admin
  3. 创建管理员：
     db.createUser({ user: "yourAdmin", pwd: "StrongPass!", roles: [ { role: "userAdminAnyDatabase", db: "admin" }, "readWriteAnyDatabase" ] })
  4. 退出：exit
  5. 编辑配置文件：sudo nano /etc/mongod.conf，在文件任意位置加入：
     security: authorization: enabled
  6. 重启生效：sudo systemctl restart mongod
• 允许远程访问：
  1. 编辑：sudo nano /etc/mongod.conf，将 net.bindIp 改为：
     bindIp: 0.0.0.0（仅 IPv4）或 bindIp: 0.0.0.0,::（IPv4 与 IPv6）
  2. 重启：sudo systemctl restart mongod
  3. 防火墙放行（UFW）：
     sudo ufw allow 27017/tcp
sudo ufw reload
• 连接串示例（远程）：mongosh "mongodb://yourAdmin:StrongPass!@your_server_ip:27017/admin"
  以上完成最小化的认证与远程访问闭环，生产环境应结合 TLS/SSL、VPC 安全组、最小权限角色 进一步强化。

五 常见问题与快速排查

• 启动失败并提示 Unit mongod.service not found：执行 sudo systemctl daemon-reload 后重试启动。
• 端口未监听：确认 mongod 已启动且配置 net.port: 27017，用 ss -pnltu | grep 27017 校验。
• 无法远程连接：核对 bindIp 是否为 0.0.0.0、云服务器安全组/本机 UFW 是否放行 27017/tcp，以及认证凭据是否正确。
• 资源限制告警：确保 ulimit -n >= 64000，避免文件描述符不足影响性能与稳定性。
  以上为高频故障点与对应处置，可据此快速定位并恢复服务。