MongoDB 安装教程：详细步骤与注意事项 – wiki大全

作者： /

MongoDB 安装教程：详细步骤与注意事项

前言

MongoDB 是一款流行的开源文档型数据库，以其高可扩展性、高性能和灵活的数据模型而闻名。本文将为您提供在 Windows、macOS 和 Linux (以 Ubuntu 为例) 三大主流操作系统上安装 MongoDB 的详细步骤，并分享一些重要的注意事项，帮助您顺利完成安装并开始使用。

1. Windows 系统安装

在 Windows 上安装 MongoDB 推荐使用 MSI 安装程序，它简化了安装过程并可配置为 Windows 服务。

1.1 前置条件

  • 64 位 Windows 操作系统。

1.2 安装步骤

  1. 下载 MongoDB Community Server

    • 访问 MongoDB 下载中心。
    • 在 “Community Server” 选项卡下，选择 “Windows” 作为平台，”msi” 作为包类型。
    • 点击 “Download” 下载安装包。

  2. 运行安装程序

    • 找到下载的 .msi 文件（通常在 Downloads 文件夹中），双击启动安装向导。
    • 按照提示进行操作：
      • 接受许可协议。
      • 选择 “Complete”（完整安装）以安装所有组件。
      • 在服务配置界面，建议选择 “Run service as Network Service user”（以网络服务用户运行服务），并记下数据目录路径（通常为 C:\Program Files\MongoDB\Server\<version>\data）。
      • 完成安装。

  3. 配置环境变量 (推荐)

    • 将 MongoDB 的 bin 目录添加到系统 PATH 环境变量中，这样您就可以在任何命令行窗口中运行 MongoDB 命令。
      • 右键点击 “此电脑” 或 “计算机”，选择 “属性”。
      • 点击 “高级系统设置”，然后点击 “环境变量”。
      • 在 “系统变量” 下，找到并选择 Path 变量，然后点击 “编辑”。
      • 点击 “新建”，添加 MongoDB bin 文件夹的路径（例如：C:\Program Files\MongoDB\Server\<version>\bin）。
      • 点击 “确定” 保存更改。

  4. 创建数据目录 (如必要)

    • MongoDB 需要一个数据目录来存储数据文件。安装程序通常会创建此目录，但如果遇到错误，您可能需要手动创建。
    • 以管理员身份打开命令提示符，运行：
      bash
      md C:\data\db

  5. 验证安装并启动 MongoDB 服务

    • 打开一个新的命令提示符窗口（确保环境变量已加载）。
    • 运行 mongod --version 验证 MongoDB 是否安装成功，您应该能看到版本信息。
    • MongoDB 通常在安装时被配置为 Windows 服务。要手动启动服务，请运行：
      bash
      net start MongoDB

  6. 安装 MongoDB Shell (mongosh)

    • MongoDB Shell (mongosh) 是一个独立的下载项。访问 MongoDB Shell 下载页面，选择 Windows 并下载 MSI 安装程序。
    • 运行 mongosh MSI 安装程序。确保在安装过程中将其 bin 目录添加到 PATH 中，或手动添加。
    • 打开新的命令提示符窗口，输入 mongosh 即可连接到正在运行的 MongoDB 实例。

2. macOS 系统安装

在 macOS 上安装 MongoDB 最简单和推荐的方法是使用 Homebrew 包管理器。

2.1 前置条件

  • macOS 11 (Big Sur) 或更高版本（推荐）。
  • Xcode 命令行工具：在终端中运行 xcode-select --install 进行安装。
  • Homebrew：如果尚未安装，请从其官方网站 (brew.sh) 获取安装命令并运行：
    bash
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2.2 使用 Homebrew 安装 (推荐)

  1. Tap MongoDB Homebrew Tap

    • 打开终端并运行：
      bash
      brew tap mongodb/brew
    • 如果之前已经操作过，可以跳过此步。

  2. 更新 Homebrew

    • 运行：
      bash
      brew update

  3. 安装 MongoDB Community Edition

    • 安装最新稳定版本（例如 7.0），运行：
      bash
      brew install [email protected]
      (如果存在更新的稳定版本，请调整版本号)。

  4. 将 MongoDB 作为 macOS 服务运行

    • 要将 MongoDB (mongod 进程) 作为后台服务启动，运行：
      bash
      brew services start [email protected]
      这将自动设置正确的系统 ulimit 值。
    • 停止服务：brew services stop [email protected]
    • 检查服务状态：brew services list

  5. 验证安装

    • 打开新的终端窗口，输入：
      bash
      mongosh
      这将连接到 MongoDB shell。

2.3 手动安装 (.tgz 包)

  1. 下载 MongoDB

    • 访问 MongoDB 下载中心，选择 “Community Server”，macOS 平台，并下载 .tgz 包。

  2. 解压 Tarball

    • 将下载的 .tgz 文件解压到您希望的位置（例如 ~/mongodb）。

  3. 创建数据目录

    • 对于 macOS Catalina 及更高版本，由于 Apple 对 /data/db 的限制，请创建一个自定义路径，例如 ~/data/db。
    • 运行：mkdir -p ~/data/db （对于旧版 macOS，可能使用 sudo mkdir -p /data/db，然后 sudo chown -R $(id -un) /data/db 设置权限）。

  4. 运行 MongoDB 服务器

    • 进入解压后的 MongoDB bin 目录（例如 cd ~/mongodb/bin）。
    • 启动 MongoDB 守护进程，并指定数据目录：
      bash
      ./mongod --dbpath ~/data/db
      (将 ~/data/db 替换为您的实际路径)。
    • 此命令将在前台运行。如需在后台运行，可以使用 --fork 参数或 screen 等工具。

  5. 连接到 MongoDB Shell

    • 打开一个 新的 终端窗口。
    • 进入 MongoDB bin 目录。
    • 运行：./mongosh （对于旧版 shell 使用 ./mongo）。

3. Linux 系统安装 (以 Ubuntu 为例)

本指南重点介绍如何使用 apt 包管理器在 Ubuntu LTS 版本上安装 MongoDB Community Edition，这是推荐的方法。

3.1 前置条件

  • 64 位 Ubuntu LTS 版本（例如 22.04 LTS, 20.04 LTS）。
  • sudo 权限。

3.2 安装步骤

  1. 导入 MongoDB 公共 GPG 密钥
    bash
    curl -fsSL https://www.mongodb.org/static/pgp/server-7.0.asc | \
    sudo gpg --dearmor -o /usr/share/keyrings/mongodb-server-7.0.gpg
    (如果您安装的是不同版本，请调整版本号)。

  2. 为 MongoDB 创建一个列表文件

    • 根据您的 Ubuntu 版本，创建 /etc/apt/sources.list.d/mongodb-org-7.0.list 文件。
    • 对于 Ubuntu 22.04 (Jammy)：
      bash
      echo "deb [ arch=amd64,arm64 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
    • 对于 Ubuntu 20.04 (Focal)：
      bash
      echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list
    • (根据需要调整 jammy 或 focal 以及版本号)。

  3. 更新本地软件包数据库
    bash
    sudo apt update

  4. 安装 MongoDB 软件包

    • 安装最新稳定版本的 MongoDB：
      bash
      sudo apt install -y mongodb-org
    • 这将安装 mongod 守护进程、mongosh shell 和其他实用工具。

  5. 启动 MongoDB 服务

    • 启动 MongoDB 服务：
      bash
      sudo systemctl start mongod
    • 设置 MongoDB 开机自启：
      bash
      sudo systemctl enable mongod

  6. 验证安装

    • 检查 MongoDB 服务的状态：
      bash
      sudo systemctl status mongod
      您应该看到 “active (running)”。
    • 连接到 MongoDB shell：
      bash
      mongosh
      这将打开 MongoDB shell，表明安装成功。

4. 安装后的常见配置与注意事项

4.1 数据目录与日志文件

  • 数据目录 (dbPath): MongoDB 默认将数据存储在 /data/db (Linux/macOS) 或 C:\data\db (Windows) 中。您可以在启动 mongod 时通过 --dbpath 参数或在配置文件 (/etc/mongod.conf 或 Windows 服务属性) 中指定自定义路径。请确保此目录具有正确的读写权限。
  • 日志文件 (logPath): MongoDB 的日志文件对于故障排除至关重要。默认日志路径通常在数据目录附近。建议在配置文件中明确指定日志文件的路径和名称，并定期查看日志以监控数据库的运行状况。

4.2 端口与防火墙

  • 默认端口: MongoDB 默认监听 27017 端口。如果此端口已被占用或您需要运行多个 MongoDB 实例，可以通过 --port 参数或配置文件更改。
  • 防火墙: 如果您的系统启用了防火墙，请确保允许来自客户端应用程序的入站连接访问 MongoDB 监听的端口 (默认为 27017)。否则，外部应用程序将无法连接到您的数据库。

4.3 安全性

  • 启用认证: 默认情况下，MongoDB 没有启用用户认证，这意味着任何人都可以连接到数据库并执行操作。在生产环境中，务必启用认证。您需要在配置文件中设置 security.authorization: enabled，并创建管理员用户。
  • 网络绑定: 默认情况下，MongoDB 可能绑定到所有可用的网络接口。为增强安全性，建议将 bindIp 配置为仅监听必要的 IP 地址，例如 127.0.0.1 (仅限本地访问) 或特定服务器的 IP 地址。

4.4 资源限制 (Linux)

  • 在 Linux 系统上，为了使 MongoDB 稳定运行，可能需要调整操作系统的资源限制 (ulimit)。例如，增加文件描述符和进程数限制。Homebrew 在 macOS 上通常会自动处理这些，但在 Linux 上可能需要手动配置 /etc/security/limits.conf。

4.5 连接测试

  • 安装完成后，您可以使用 mongosh 连接到数据库，并尝试执行一些基本操作，如 show dbs; 或 db.test.insertOne({a:1}); 来确认数据库是否正常工作。

总结

通过遵循本教程中的详细步骤，您应该能够在 Windows、macOS 和 Linux 系统上成功安装 MongoDB。请务必关注安装后的配置和安全注意事项，尤其是在生产环境中，以确保您的 MongoDB 数据库安全、高效地运行。祝您使用愉快！

滚动至顶部