MongoDB 下载安装指南 – wiki基地

作者： /

MongoDB 详尽下载安装指南：从零开始搭建你的NoSQL数据库环境

前言

在当今数据爆炸的时代，传统的关系型数据库在应对海量、多样的非结构化或半结构化数据时常常显得力不从心。NoSQL 数据库应运而生，而 MongoDB 无疑是其中最受欢迎和广泛应用的佼佼者。作为一款基于分布式文件存储的文档型数据库，MongoDB 凭借其灵活的数据模型、强大的查询能力、易于扩展的架构，在 Web 应用、大数据、物联网、游戏等众多领域展现出独特的优势。

对于初学者或希望在自己的开发环境或服务器上部署 MongoDB 的用户来说，首要任务就是完成数据库的下载与安装。本文旨在提供一份详尽、全面的 MongoDB 下载安装指南，覆盖 Windows、macOS 和主流 Linux 发行版（Ubuntu/Debian, CentOS/RHEL）等平台，从准备工作到验证安装，一步步引导你搭建起自己的 MongoDB 环境。无论你是开发者、运维工程师还是对 MongoDB 感兴趣的学生，都能在这份指南中找到清晰的指引。

我们将从选择合适的版本和平台开始，逐步深入到各个操作系统的具体安装步骤，包括使用官方安装包、包管理器等不同方式，并涵盖必要的配置和启动方法。同时，我们也会提供一些常见问题的排查思路，帮助你顺利完成安装过程。

让我们开始 MongoDB 的探索之旅吧！

第一章：准备工作与版本选择

在正式下载和安装 MongoDB 之前，进行一些必要的准备并选择合适的版本是至关重要的。

1.1 软硬件要求

虽然 MongoDB 的灵活性使其可以在多种环境下运行，但了解其基本的软硬件要求能帮助你规划部署：

  • 操作系统 (OS): MongoDB 支持多种操作系统，包括：
    • Windows Server (部分版本) 和 Windows 10/11 (用于开发和测试)。
    • macOS。
    • Linux (众多发行版，如 Ubuntu LTS、Debian、CentOS/RHEL、Amazon Linux 等)。请注意，MongoDB 官方仅为部分企业版或特定需求提供对 32 位系统的支持，对于绝大多数用户，应使用 64 位操作系统。此外，某些较旧的 Linux 内核版本可能不被支持。始终查阅 MongoDB 官方文档以获取最新、最精确的兼容性列表。
  • 硬件:
    • CPU: 64 位 x86 架构处理器是必须的。具体的 CPU 需求取决于你的工作负载。
    • 内存 (RAM): MongoDB 严重依赖内存进行数据缓存和操作。生产环境中，建议至少 8GB 或更多，甚至几十 GB 或上百 GB 是常见的。开发或测试环境可以适当降低，但低于 4GB 可能会显著影响性能。
    • 存储: 快速的存储设备对 MongoDB 的性能至关重要，特别是对于写密集型或需要大量随机读写的场景。SSD (固态硬盘) 是生产环境的首选。存储空间的需求取决于你存储的数据量。数据文件、日志文件、索引都需要空间。
    • 网络: 如果是分布式部署（副本集或分片集群），稳定的网络连接是必须的。默认端口是 27017，需要确保防火墙允许该端口的流量。

1.2 选择 MongoDB 版本

MongoDB 提供两个主要版本：

  • Community Edition (社区版): 这是免费、开源的版本，包含了 MongoDB 的核心功能，适用于开发、测试以及许多生产环境的应用。大多数用户，特别是初学者，通常选择社区版。
  • Enterprise Edition (企业版): 这是商业版本，在社区版的基础上增加了企业级功能，如高级安全特性（LDAP/Kerberos 集成、审计）、加密存储引擎、图计算、列式存储、Ops Manager/Cloud Manager 等管理工具。企业版需要付费订阅。

对于本指南，我们将主要关注 Community Edition 的安装。

在确定了版本之后，还需要选择具体的版本号。MongoDB 有不同的发布系列，通常遵循 X.Y 的格式，例如 6.0, 7.0。其中：

  • 偶数次版本号（如 6.0, 7.0）通常是主要的稳定版本，也被视为长期支持（LTS – Long Term Support）版本或生产推荐版本。它们经过更长时间的测试和优化。
  • 奇数次版本号（如 6.1, 6.2, 7.1）通常是开发版本或功能预览版本，不推荐用于生产环境。

对于新的部署，通常建议选择最新的 生产推荐版本 (Production Recommended)，这通常是最新的稳定大版本或其最新的小版本更新。你可以在 MongoDB 官方下载页面找到推荐版本。

1.3 下载渠道

始终从 MongoDB 官方网站下载安装包或使用官方提供的包管理器仓库。这是确保你获得正版、安全、未经篡改软件的最佳方式。

在这个页面，你可以根据你的操作系统、架构、版本等选项来下载对应的安装文件。

第二章：下载 MongoDB Community Edition

访问 MongoDB 官方下载中心：https://www.mongodb.com/try/download/community

在这个页面上，你会看到如下选项供选择：

  • Version: 选择你希望下载的 MongoDB 版本。通常会默认显示最新的生产推荐版本，你也可以通过下拉菜单选择其他版本。
  • OS: 选择你的操作系统，如 Windows, macOS, Linux。
  • Package: 根据不同的 OS，Package 选项会有所不同。
    • Windows: 通常是 MSI 安装包 (msi)。
    • macOS: 通常是 TGZ 压缩包 (tgz) 或通过 Homebrew 安装（推荐）。
    • Linux: 提供多种发行版的 Package (如 deb for Debian/Ubuntu, rpm for RHEL/CentOS/Fedora) 或 TGZ 压缩包 (tgz)。使用包管理器是 Linux 上推荐的安装方式，因为它能更好地处理依赖关系和服务管理。

选择好所有选项后，点击绿色的 “Download” 按钮即可开始下载对应的安装文件。记下文件的保存位置，稍后会用到。

如果你计划在 Linux 上使用包管理器安装，则不需要手动下载文件，后续步骤将指导你如何配置仓库并通过包管理器进行安装。

第三章：Windows 平台安装指南

在 Windows 上安装 MongoDB 通常通过下载 MSI 安装包进行，过程相对直观。

3.1 使用 MSI 安装包安装

  1. 运行安装程序: 找到你下载的 mongodb-windows-x86_64-X.X.msi 文件，双击运行。
  2. 欢迎界面: 出现安装向导的欢迎界面，点击 “Next”。
  3. 许可协议: 阅读许可协议，勾选 “I accept the terms in the License Agreement”，点击 “Next”。
  4. 安装类型: 选择安装类型。
    • Complete (完整安装): 安装所有 MongoDB 组件，包括 MongoDB Server、Shell (mongosh)、Compass 等工具。推荐选择此项，特别是如果你是初次安装并希望获得全套工具。
    • Custom (自定义安装): 允许你选择安装哪些组件和安装路径。如果你只需要特定的组件或想安装到非默认位置，可以选择此项。对于大多数用户，选择 “Complete” 即可。
  5. 服务配置 (重要): 如果选择 “Complete” 安装，安装向导会询问是否安装 MongoDB 为 Windows 服务。
    • Install MongoDB as a Service: 勾选此选项（默认勾选）。这使得 MongoDB 可以在系统启动时自动运行，并且可以通过 Windows 的服务管理器进行控制。
    • Service Name: 默认是 MongoDB，你可以修改它。
    • Data Directory: 指定 MongoDB 存储数据文件的路径。默认是 C:\Program Files\MongoDB\Server\X.X\data (或 C:\data)。强烈建议更改到非系统盘符，并使用一个明确的路径，例如 D:\mongodb\data 或 E:\data。 确保选择的目录是存在的，或者有权限创建。
    • Log Directory: 指定 MongoDB 存储日志文件的路径。默认是 C:\Program Files\MongoDB\Server\X.X\log (或 C:\log)。同样，建议更改到与数据目录类似的路径，例如 D:\mongodb\log 或 E:\log。 确保选择的目录是存在的，或者有权限创建。
    • Account Name / Password: 通常情况下，使用默认的 “Run Service as Network Service user” 即可，它是一个内置的 Windows 账户，具有运行服务的必要权限。除非你有特定的安全需求，否则无需更改。
      点击 “Next”。
  6. 安装 MongoDB Compass (可选但推荐): 安装向导会询问是否安装 MongoDB Compass。Compass 是一个官方的图形化界面工具，方便连接、查询和管理 MongoDB 数据库。强烈建议勾选此项进行安装，它会极大地便利你的后续操作。点击 “Next”。
  7. 准备安装: 安装向导会显示安装路径等信息，确认无误后，点击 “Install”。
  8. 安装过程: 等待安装完成。可能需要一些时间。在安装过程中，Windows 可能会弹出用户账户控制 (UAC) 的提示，点击 “是” 允许安装。
  9. 完成安装: 安装完成后，点击 “Finish” 退出安装向导。

3.2 配置环境变量 (如果选择 Custom 安装或需要手动配置)

如果选择了 “Complete” 安装并安装为服务，并且接受了默认路径，MongoDB 的 bin 目录可能已经被添加到系统 PATH 环境变量中。你可以跳过此步骤。

如果你选择了 “Custom” 安装到非默认路径，或者安装后在命令行无法直接运行 mongosh 等命令，你需要手动将 MongoDB 的 bin 目录添加到系统 PATH 环境变量中。

  1. 右键点击 “此电脑” (或 “计算机”) -> “属性”。
  2. 点击 “高级系统设置”。
  3. 在弹出的 “系统属性” 窗口中，点击右下角的 “环境变量…” 按钮。
  4. 在 “系统变量” 区域，找到名为 Path (或 PATH) 的变量，选中它，然后点击 “编辑…”。
  5. 点击 “新建”，然后输入 MongoDB bin 目录的完整路径，例如 C:\Program Files\MongoDB\Server\X.X\bin (请根据你的实际安装路径和版本号替换 C:\Program Files\MongoDB\Server\X.X)。
  6. 点击 “确定” 保存所有打开的窗口。
  7. 重要: 你可能需要关闭并重新打开命令行窗口 (cmd 或 PowerShell)，以便环境变量的更改生效。

3.3 验证安装与启动服务

安装完成后，你可以通过以下步骤验证并启动 MongoDB 服务：

  1. 检查服务状态:
    • 按下 Win + R，输入 services.msc，回车打开服务管理器。
    • 在服务列表中找到名为 MongoDB (或你在安装时指定的名称) 的服务。
    • 查看其状态，如果显示 “正在运行”，则表示服务已成功启动。如果显示 “已停止”，右键点击该服务，选择 “启动”。
  2. 使用 mongosh 连接:
    • 打开命令提示符 (cmd) 或 PowerShell。
    • 输入 mongosh 并回车。
    • 如果一切正常，你应该能看到 MongoDB Shell 的欢迎信息和提示符 >，表示已成功连接到本地运行的 MongoDB 数据库。
    • 输入 show dbs 并回车，应该能看到默认的数据库列表 (admin, config, local)。
    • 输入 .exit 或按下 Ctrl + D 退出 shell。

3.4 配置文件 (可选但推荐)

虽然作为服务安装时，安装程序已经帮你配置好了数据和日志路径，但了解 MongoDB 的配置文件 mongod.cfg 是有益的。默认位置通常在 C:\Program Files\MongoDB\Server\X.X\bin\。你可以编辑这个文件来修改端口、绑定 IP、启用认证等更多高级设置。修改后，需要重启 MongoDB 服务才能生效。

第四章：macOS 平台安装指南

在 macOS 上安装 MongoDB 最推荐的方式是使用 Homebrew 包管理器，它能简化安装和后续管理过程。

4.1 使用 Homebrew 安装 (推荐)

如果你还没有安装 Homebrew，请先参照 Homebrew 官网的指引进行安装：https://brew.sh/。通常只需在终端运行一条命令即可。

安装 Homebrew 后，按照以下步骤安装 MongoDB：

  1. 打开终端 (Terminal): 在 Launchpad 中找到或通过 Spotlight 搜索打开终端应用。
  2. 导入 MongoDB 的 Homebrew Tap: MongoDB 社区版现在有自己的 Homebrew tap。运行以下命令将其添加到 Homebrew：
    bash
    brew tap mongodb/brew
    这个命令会将 MongoDB 的 Homebrew 公式添加到你的本地 Homebrew 安装中，以便你能找到并安装 MongoDB。
  3. 安装 MongoDB Community Server: 运行以下命令安装 MongoDB Community Server：
    bash
    brew install mongodb/brew/mongodb-community
    Homebrew 会自动下载、编译（如果需要）并安装 MongoDB 及其依赖。这个过程可能需要一些时间，取决于你的网络速度和电脑性能。

  4. 启动 MongoDB 服务: 安装完成后，你可以使用 Homebrew Services 来启动 MongoDB：
    bash
    brew services start mongodb/brew/mongodb-community
    这个命令会将 MongoDB 配置为在系统启动时自动运行，并在当前用户登录时启动它。你也可以使用 stop, restart, list 等命令来管理服务。

    • 停止服务: brew services stop mongodb/brew/mongodb-community
    • 重启服务: brew services restart mongodb/brew/mongodb-community
    • 查看服务状态: brew services list (查找 mongodb-community 的状态)
    • 或者，你也可以手动以后台进程方式启动 MongoDB，但这通常不推荐用于长期运行：mongod --config /usr/local/etc/mongod.conf --fork (注意：实际配置文件路径可能因 Homebrew 版本和安装位置而异，通常在 /usr/local/etc/ 或 /opt/homebrew/etc/ 下)。

  5. 验证安装:

    • MongoDB Shell (mongosh) 应该已经与服务器一起安装好了。
    • 打开新的终端窗口 (以确保 PATH 环境变量已更新)。
    • 输入 mongosh 并回车。
    • 如果服务正在运行且安装正确，你应该能看到 Shell 提示符 >.
    • 输入 show dbs 并回车，查看数据库列表。
    • 输入 .exit 退出 Shell。

4.2 配置与数据存储位置

使用 Homebrew 安装时，MongoDB 的默认数据目录通常是 /usr/local/var/mongodb/ (或 /opt/homebrew/var/mongodb/ 在 Apple Silicon Macs 上)，日志文件通常在 /usr/local/var/log/mongodb/ (或 /opt/homebrew/var/log/mongodb/)。

Homebrew 安装的 MongoDB 配置文件通常位于 /usr/local/etc/mongod.conf (或 /opt/homebrew/etc/mongod.conf)。你可以编辑此文件来修改端口、数据/日志路径、绑定 IP 等设置。修改后，需要使用 brew services restart mongodb/brew/mongodb-community 命令重启服务使更改生效。

4.3 手动安装 (TGZ 包 – 不如 Homebrew 方便)

你也可以下载 TGZ 压缩包 (mongodb-macos-x86_64-X.X.tgz) 进行手动安装。

  1. 下载 TGZ 包。
  2. 将压缩包解压到你想安装的目录，例如 /usr/local/mongodb 或 /Users/YourUsername/mongodb。
    bash
    tar -zxvf mongodb-macos-x86_64-X.X.tgz -C /usr/local/
    mv /usr/local/mongodb-macos-x86_64-X.X /usr/local/mongodb
  3. 创建数据和日志目录：
    bash
    mkdir -p /Users/YourUsername/mongodb_data
    mkdir -p /Users/YourUsername/mongodb_log
  4. 将 MongoDB bin 目录添加到 PATH 环境变量。编辑你的 shell 配置文件（如 ~/.bash_profile, ~/.zshrc），添加一行：
    bash
    export PATH="/usr/local/mongodb/bin:$PATH"
    然后运行 source ~/.bash_profile 或 source ~/.zshrc 使更改生效，或重新打开终端。
  5. 手动启动 MongoDB 服务器：
    bash
    mongod --dbpath /Users/YourUsername/mongodb_data --logpath /Users/YourUsername/mongodb_log/mongod.log --fork
    --fork 参数让 mongod 在后台运行。你需要手动停止它（通常通过 kill 命令找到进程 ID 并杀死）。手动安装方式管理起来相对复杂，因此 Homebrew 方式更推荐。

第五章：Linux 平台安装指南

在 Linux 上，使用包管理器安装是推荐的方式，它能更好地集成到系统的服务管理中，并处理依赖关系。不同的 Linux 发行版使用不同的包管理器（如 Debian/Ubuntu 使用 apt，RHEL/CentOS/Fedora 使用 yum/dnf），安装步骤略有不同。

重要提示: 以下命令通常需要 root 权限，所以需要使用 sudo。

5.1 Ubuntu / Debian 系统 (使用 apt)

以下步骤以 Ubuntu 20.04 LTS 或 22.04 LTS 为例，MongoDB 6.0 或 7.0 版本。具体版本号请根据你实际需要调整。

  1. 导入 MongoDB GPG 公钥:
    MongoDB 要求导入其公共 GPG 密钥，以验证下载的包的真实性。不同版本的 MongoDB 使用不同的密钥，请根据你安装的版本选择正确的密钥。

    • 对于 MongoDB 6.0 及更新版本:
      bash
      wget -qO - https://www.mongodb.org/static/pgp/server-6.0.asc | sudo apt-key add -
      # 或对于 7.0+:
      # wget -qO - https://www.mongodb.org/static/pgp/server-7.0.asc | sudo apt-key add -
      如果 apt-key add 被弃用，可以使用以下方法 (适用于 Debian 11+, Ubuntu 22.04+):
      bash
      wget -qO - https://www.mongodb.org/static/pgp/server-6.0.asc | sudo tee /etc/apt/trusted.gpg.d/mongodb-org-6.0.asc
      # 或对于 7.0+:
      # wget -qO - https://www.mongodb.org/static/pgp/server-7.0.asc | sudo tee /etc/apt/trusted.gpg.d/mongodb-org-7.0.asc
      （请注意文件名 /etc/apt/trusted.gpg.d/mongodb-org-X.X.asc 的命名规则）

    执行命令后，如果成功，通常不会有输出，或者返回 OK。

  2. 为 MongoDB 创建列表文件:
    在 /etc/apt/sources.list.d/ 目录下创建一个文件，用于存放 MongoDB 仓库的信息。文件名通常是 mongodb-org-X.X.list，其中 X.X 是你要安装的 MongoDB 版本。

    使用你喜欢的文本编辑器创建并编辑文件，例如 sudo nano /etc/apt/sources.list.d/mongodb-org-6.0.list。

    根据你的 Ubuntu/Debian 版本和 MongoDB 版本，将以下相应的行添加到文件中。请务必根据你的操作系统版本选择正确的 [UBUNTU_OR_DEBIAN_VERSION] 代号：

    • Ubuntu 22.04 (Jammy): jammy
    • Ubuntu 20.04 (Focal): focal
    • Debian 11 (Bullseye): bullseye
    • Debian 10 (Buster): buster

    例如，如果你在 Ubuntu 22.04 上安装 MongoDB 6.0，文件内容应为：
    deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/6.0 multiverse
    如果你在 Debian 11 上安装 MongoDB 7.0，文件内容应为：
    deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/debian bullseye/mongodb-org/7.0 main
    保存并关闭文件。

  3. 重新加载本地包数据库:
    现在你的系统中已经添加了 MongoDB 的仓库信息，需要更新 apt 的源列表：
    bash
    sudo apt update
    如果没有错误，你应该能看到 apt 成功获取了 MongoDB 仓库的信息。

  4. 安装 MongoDB 包:
    使用以下命令安装最新稳定版本的 MongoDB：
    bash
    sudo apt install -y mongodb-org
    mongodb-org 是一个元包，安装它会同时安装以下组件的相应版本：

    • mongodb-org-server: mongod 守护进程和其他服务器相关的工具。
    • mongodb-org-mongos: 用于分片集群的 mongos 路由进程。
    • mongodb-org-shell: mongosh shell。
    • mongodb-org-tools: 其他 MongoDB 工具 (如 mongodump, mongorestore, mongoimport, mongoexport 等)。

    如果你只想安装服务器，可以安装 mongodb-org-server 包，但通常安装 mongodb-org 更方便。

  5. 启动 MongoDB 服务:
    安装完成后，MongoDB 服务并不会自动启动。使用 systemd (现代 Linux 发行版通常使用) 来启动和启用服务：
    bash
    sudo systemctl start mongod
    sudo systemctl enable mongod
    start mongod 启动当前会话的服务，enable mongod 设置服务在系统启动时自动运行。

  6. 验证服务状态:
    检查 MongoDB 服务是否正在运行：
    bash
    sudo systemctl status mongod
    如果服务正在运行，你应该看到输出中显示 “active (running)”。按下 q 退出状态查看。

  7. 连接到 MongoDB:
    打开新的终端窗口，运行 mongosh 命令连接到本地数据库：
    bash
    mongosh
    进入 Shell 后，可以输入 show dbs 检查数据库列表。

5.2 CentOS / RHEL / Fedora 系统 (使用 yum 或 dnf)

以下步骤以 CentOS 7 或 RHEL 8 为例，MongoDB 6.0 或 7.0 版本。对于 CentOS 8+, Fedora 30+ 使用 dnf 代替 yum，命令基本一致。

  1. 创建 .repo 文件:
    在 /etc/yum.repos.d/ (或 /etc/dnf/repos.d/) 目录下创建一个文件，用于存放 MongoDB 仓库的信息。文件名通常是 mongodb-community.repo。

    使用你喜欢的文本编辑器创建并编辑文件，例如 sudo nano /etc/yum.repos.d/mongodb-community.repo。

    根据你的 CentOS/RHEL 版本和 MongoDB 版本，将以下内容添加到文件中。请务必根据你的操作系统版本选择正确的 [OS_VERSION] 替换：

    • RHEL/CentOS 7: 7
    • RHEL/CentOS/Rocky Linux/AlmaLinux 8: 8
    • RHEL/CentOS/Rocky Linux/AlmaLinux 9: 9
    • Amazon Linux 2: 2
    • Fedora 38: 38 (或其他版本号)

    例如，如果你在 RHEL 8 上安装 MongoDB 6.0，文件内容应为：
    ini
    [mongodb-org-6.0]
    name=MongoDB Repository
    baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/6.0/x86_64/
    gpgcheck=1
    enabled=1
    gpgkey=https://www.mongodb.org/static/pgp/server-6.0.asc
    注意：这里的 $releasever 是一个变量，yum/dnf 会自动替换为你的系统主版本号 (如 7, 8, 9)。
    如果你想安装 7.0 版本，只需将 [mongodb-org-6.0] 改为 [mongodb-org-7.0]，baseurl 中的 6.0 改为 7.0，gpgkey 中的 6.0.asc 改为 7.0.asc。

    保存并关闭文件。

  2. 安装 MongoDB 包:
    使用 yum 或 dnf 命令安装 MongoDB 包：
    “`bash
    # 对于 CentOS/RHEL 7 或使用 yum 的系统
    sudo yum install -y mongodb-org

    对于 CentOS/RHEL/Rocky Linux/AlmaLinux 8+ 或使用 dnf 的系统

    sudo dnf install -y mongodb-org

    ``mongodb-org` 包会安装服务器、shell、mongos 和其他工具。

  3. 启动 MongoDB 服务:
    安装完成后，启动并启用 MongoDB 服务：
    bash
    sudo systemctl start mongod
    sudo systemctl enable mongod

  4. 验证服务状态:
    检查 MongoDB 服务状态：
    bash
    sudo systemctl status mongod
    看到 “active (running)” 表示服务启动成功。

  5. 连接到 MongoDB:
    运行 mongosh 连接到本地数据库：
    bash
    mongosh
    进入 Shell 后，输入 show dbs 检查数据库列表。

5.3 Linux 上的配置与目录结构

通过包管理器安装的 MongoDB 在 Linux 上有一些标准的目录约定：

  • 配置文件: /etc/mongod.conf。这是 MongoDB 的主配置文件，你可以修改它来配置数据存储路径 (storage.dbPath)、日志文件路径 (systemLog.path)、监听端口 (net.port)、绑定 IP 地址 (net.bindIp) 等重要设置。修改后需要重启 mongod 服务。
  • 数据目录: /var/lib/mongodb (默认)。确保运行 mongod 进程的用户 (通常是 mongodb 用户) 对此目录有读写权限。
  • 日志目录/文件: /var/log/mongodb/mongod.log (默认)。同样需要 mongodb 用户有写权限。
  • 可执行文件: /usr/bin/ 或 /bin/ 下 (通过 $PATH 可直接访问)。
  • PID 文件: /var/run/mongodb/mongod.pid。
  • 用户/组: 包管理器安装通常会创建一个名为 mongodb 的系统用户和组，mongod 进程默认以此用户身份运行，以增强安全性。

5.4 SELinux / AppArmor 注意事项

在启用了 SELinux (CentOS/RHEL) 或 AppArmor (Ubuntu) 的系统上，它们的安全策略可能会阻止 MongoDB 访问默认或自定义的数据/日志目录，或者阻止其在特定端口监听。

  • SELinux: 如果遇到权限问题，可以检查 SELinux 审计日志 (sudo audit2why < /var/log/audit/audit.log)，并根据需要创建自定义的 SELinux 策略模块，或者（仅用于测试）暂时将 SELinux 设置为许可模式 (sudo setenforce 0)。在生产环境不建议关闭或设置为许可模式。
  • AppArmor: 检查 AppArmor 状态 (sudo apparmor_status) 和日志 (sudo dmesg | grep apparmor)。如果 AppArmor 阻止了 MongoDB 的操作，你可能需要修改 /etc/apparmor.d/usr.sbin.mongod 文件，然后重新加载 AppArmor 策略 (sudo systemctl reload apparmor)。

处理 SELinux 和 AppArmor 超出了本基础安装指南的范围，如果遇到相关问题，请查阅 MongoDB 官方文档中针对特定 OS 和版本的故障排除部分。

第六章：初次运行与连接

无论你使用哪种安装方式，安装完成后最重要的一步就是确保 MongoDB 服务器 (mongod) 正在运行，并且你可以使用 Shell (mongosh) 连接到它。

  1. 确保 mongod 正在运行:

    • Windows: 检查 “服务” 应用，确认 MongoDB 服务状态是 “正在运行”。如果不是，启动它。
    • macOS (Homebrew): 运行 brew services list，确认 mongodb-community 的状态是 “started”。如果不是，运行 brew services start mongodb/brew/mongodb-community。
    • Linux: 运行 sudo systemctl status mongod，确认状态是 “active (running)”。如果不是，运行 sudo systemctl start mongod。

  2. 打开 Shell 连接:
    打开你的终端或命令提示符，输入 mongosh 并回车。

    默认情况下，mongosh 会尝试连接到本地主机 (127.0.0.1) 的默认端口 (27017)。

    如果连接成功，你会看到类似以下的输出（具体版本信息可能不同）：
    “`
    Current Mongosh version: 2.0.2
    For interactive help, type “help”.
    For more about using connections, see
    https://docs.mongodb.com/compass/current/connect/

    test>
    ``
    提示符    test>表示你当前连接到了名为test` 的数据库（如果不存在会自动创建）。

  3. 运行基本命令:
    在 mongosh 提示符下，你可以运行一些基本的 MongoDB 命令来验证数据库功能：

    • 列出所有数据库: show dbs
    • 切换到某个数据库 (例如 admin): use admin
    • 查看当前数据库的状态: db.stats()
    • 插入一个文档: db.mycollection.insertOne({ name: "test", value: 1 }) (这会在 test 数据库中创建一个名为 mycollection 的集合)
    • 查找文档: db.mycollection.find()

  4. 退出 Shell:
    输入 .exit 或按下 Ctrl + D 退出 mongosh。

恭喜你！如果以上步骤顺利完成，你的 MongoDB 环境已经成功搭建起来了。

第七章：常见问题与故障排除

在安装过程中，你可能会遇到一些问题。以下是一些常见的问题及其排查思路：

  1. mongosh 命令找不到:

    • 原因: MongoDB bin 目录没有添加到系统的 PATH 环境变量中，或者环境变量没有生效。
    • 解决方法: 检查你的 PATH 环境变量设置，确保包含了 MongoDB 的 bin 目录。在修改环境变量后，需要重新打开命令行窗口。

  2. MongoDB 服务无法启动或启动后立即停止:

    • 原因: 最常见的原因是数据目录或日志目录权限问题，或者配置文件错误。
    • 解决方法:
      • 检查日志文件: 查看 MongoDB 的日志文件（默认位置：Windows 在安装目录下的 log 文件夹，Linux 在 /var/log/mongodb/mongod.log）。日志文件中会包含详细的错误信息，例如权限拒绝、文件不存在、配置错误等。
      • 检查目录权限: 确保运行 mongod 进程的用户对数据目录 (dbPath) 和日志目录 (logPath) 具有读写权限。在 Linux 上，通常需要将这些目录的所有权设置为 mongodb 用户和组 (sudo chown -R mongodb:mongodb /path/to/data /path/to/log) 并设置适当的权限 (sudo chmod -R 755 /path/to/data /path/to/log 或更严格的权限）。
      • 检查配置文件: 如果你修改了 mongod.conf (Linux/macOS) 或 mongod.cfg (Windows)，检查是否存在语法错误或无效的配置项。可以使用 mongod --config /path/to/mongod.conf --dryRun 来验证配置文件语法。
      • 检查磁盘空间: 确保数据目录所在的磁盘分区有足够的空间。
      • 检查 SELinux/AppArmor: 在 Linux 上，如果启用了 SELinux 或 AppArmor，检查它们是否阻止了 MongoDB 的操作（参考第五章的注意事项）。

  3. mongosh 连接失败 (Connection refused):

    • 原因: mongod 服务没有运行，或者防火墙阻止了连接，或者 MongoDB 绑定了错误的 IP 地址。
    • 解决方法:
      • 确认服务运行: 按照第六章的步骤确认 mongod 服务正在运行。
      • 检查防火墙: 默认情况下，MongoDB 运行在端口 27017。确保你的系统防火墙允许对 27017 端口的入站连接 (如果从远程连接)。在 Windows 上检查 Windows Defender 防火墙或其他第三方防火墙；在 Linux 上检查 ufw 或 firewalld (例如，对于 ufw: sudo ufw allow 27017)。
      • 检查绑定 IP: 在 mongod.conf 或 mongod.cfg 文件中查找 net.bindIp 配置项。默认通常是 127.0.0.1 (只允许本地连接)。如果你需要从其他机器连接，需要将其修改为服务器的内网 IP 地址或 0.0.0.0 (监听所有可用 IP，注意安全风险)。修改后需要重启服务。

  4. 在 Linux 上使用 sudo 的问题:

    • 确保你在安装和启动服务时使用了 sudo。直接以 root 用户运行 mongod 是不推荐的，因为它会以 root 权限运行数据库进程，带来安全风险。包管理器安装默认会创建一个 mongodb 用户并以此用户身份运行服务。

  5. 版本兼容性问题:

    • 确保你下载的 MongoDB 版本与你的操作系统版本兼容。查阅 MongoDB 官方文档获取兼容性矩阵。

遇到问题时，耐心阅读错误信息，仔细检查日志文件，并对照本指南中的步骤进行排查通常能解决大部分问题。如果问题依然存在，可以搜索 MongoDB 官方文档、Stack Overflow 或 MongoDB 社区论坛，很可能有人已经遇到并解决了类似的问题。

结论

通过本篇详尽的指南，你应该已经成功地在你的 Windows、macOS 或 Linux 系统上完成了 MongoDB Community Edition 的下载和安装。我们涵盖了从准备工作、版本选择、不同平台的详细安装步骤，到初次运行连接和常见的故障排除。

成功安装 MongoDB 仅仅是开始。接下来，你可以深入学习 MongoDB 的数据建模、CRUD 操作、索引优化、聚合管道、复制集（Replica Set）和分片集群（Sharded Cluster）等高级特性。

MongoDB 灵活的文档模型和强大的功能将为你的应用开发或数据管理带来全新的体验。祝你在使用 MongoDB 的旅程中一切顺利！

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部