MongoDB 下载完整教程 – wiki基地


MongoDB 完整下载安装教程:从零开始,一步步指引

引言

在当今数据驱动的世界里,数据库是构建几乎所有应用程序的基础。而在众多数据库类型中,NoSQL 数据库因其灵活的数据模型和高可扩展性而备受青睐。MongoDB 作为最流行的文档型 NoSQL 数据库之一,广泛应用于Web开发、大数据、移动应用等领域。

如果你是一位开发者、数据工程师或者仅仅对数据库技术感兴趣,学习和使用 MongoDB 是一个非常好的选择。而踏出第一步,就是成功地下载并安装它。

本教程旨在提供一个全面、详细的 MongoDB 下载安装指南。我们将覆盖主流操作系统(Windows、macOS、Linux)的安装方法,解释关键概念,并指导你完成安装后的基本验证。无论你是数据库新手还是有经验的工程师,希望本指南都能帮助你顺利搭建起 MongoDB 环境。

注意: MongoDB 的版本更新较快,官方的安装步骤可能会有微小调整。本教程基于撰写时的最新稳定版(通常是当前的 LTS 版本或较新的通用可用版本)提供指引。在安装前,强烈建议访问 MongoDB 官方文档 查看对应你所选择版本和操作系统的最新、最权威的安装说明。

为何选择下载安装 MongoDB?

MongoDB 提供了多种使用方式:

  1. MongoDB Atlas: MongoDB 官方提供的云数据库服务,完全托管,无需自己管理服务器,易于扩展和维护。适合生产环境和快速开发。
  2. 下载并自托管 (Self-Hosted): 将 MongoDB 安装在自己的服务器、虚拟机或本地计算机上。适合学习、开发、测试以及对环境有特殊控制需求的场景。

本教程专注于第二种方式——下载并安装 MongoDB 到你的本地机器或服务器。选择这种方式的好处在于:

  • 完全控制: 你可以完全控制数据库的环境、配置和数据。
  • 无成本(社区版): MongoDB Community Edition(社区版)是免费使用的,适合学习、开发和大多数非企业级应用。
  • 离线开发/学习: 无需网络连接即可在本地进行开发和测试。
  • 深入理解: 通过手动安装和配置,你能更深入地理解 MongoDB 的运行机制。

准备工作

在开始下载安装之前,请确保你满足以下条件:

  1. 操作系统: 确认你的操作系统版本。MongoDB 官方支持特定版本的 Windows、macOS 和多种 Linux 发行版。请查阅官方文档确认你的系统版本是否受支持。
  2. 系统要求: 确保你的计算机有足够的内存(RAM)、硬盘空间和处理能力。对于学习和开发,通常要求不高;但对于生产环境,则需要根据数据量和负载进行评估。
  3. 网络连接: 下载安装包或使用包管理器时需要稳定的网络连接。
  4. 管理员权限: 安装软件通常需要管理员权限。
  5. 文本编辑器: 用于编辑配置文件(如需)。
  6. 命令行终端: 需要使用命令行执行安装和管理命令。

MongoDB 版本选择:Community vs. Enterprise

MongoDB 提供两个主要版本:

  • Community Edition(社区版): 免费、开源,包含 MongoDB 的核心功能。适用于大多数通用用途,如Web应用、数据存储、开发测试等。
  • Enterprise Edition(企业版): 在社区版基础上增加了更多针对企业需求的功能,如高级安全特性(LDAP/Kerberos 认证)、更强大的监控工具、加密存储引擎、商业支持等。通常需要购买许可。

对于初学者、个人开发者或中小型项目,选择 Community Edition 就足够了。本教程也将主要基于社区版进行讲解。

此外,MongoDB 遵循版本号规则,并会标记 LTS (Long Term Support) 版本。对于生产环境,通常推荐使用 LTS 版本,因为它会获得更长时间的支持和维护。学习和开发可以选择最新的通用版本,以体验新特性。

下载方法概述

下载 MongoDB 二进制文件或安装程序主要有几种方式:

  1. 从 MongoDB 官方下载中心下载: 这是最直接的方式,你可以选择操作系统、版本和对应的安装包类型(如 .msi 文件 for Windows, .tgz 压缩包 for Linux/macOS)。
  2. 使用操作系统自带的包管理器: 在 Linux 和 macOS 上,这是更推荐的方式。例如,在 Ubuntu/Debian 上使用 apt,在 RHEL/CentOS/Fedora 上使用 yumdnf,在 macOS 上使用 Homebrew。通过包管理器安装更方便管理、更新和依赖。
  3. 使用 Docker: 将 MongoDB 运行在 Docker 容器中。这提供了一种轻量级、可移植的部署方式,特别适合开发和测试环境。

接下来,我们将详细讲解每种操作系统下通过官方下载中心和包管理器(如果适用)的安装步骤。


分平台详细安装教程

1. 在 Windows 上安装 MongoDB Community Edition

在 Windows 上安装 MongoDB 最简单的方法是使用官方提供的 MSI 安装程序。

步骤 1:前往 MongoDB 官方下载中心

打开浏览器,访问 MongoDB 官方下载中心页面:https://www.mongodb.com/try/download/community

步骤 2:选择版本、操作系统和包类型

  • 在 “Version” 下拉菜单中,选择你想要安装的 MongoDB 版本。推荐选择最新的 GA (General Availability) 版本或 LTS 版本。
  • 在 “OS” 下拉菜单中,选择 “Windows”。
  • 在 “Package” 下拉菜单中,选择 “msi”。
  • 确认选择的是 “Community Server”。

步骤 3:下载 MSI 安装程序

点击 “Download” 按钮,下载 MongoDB 的 MSI 安装文件。文件大小通常在几百 MB。

步骤 4:运行 MSI 安装程序

找到下载的 .msi 文件,双击运行它。

  • 欢迎界面: 点击 “Next”。
  • 最终用户许可协议: 阅读并接受许可协议,勾选 “I accept the terms in the License Agreement”,然后点击 “Next”。
  • 安装类型选择: 你会看到 “Complete”(完整安装)和 “Custom”(自定义安装)两个选项。
    • Complete (推荐初学者): 安装所有组件到默认路径。
    • Custom: 允许你选择安装组件和安装路径。如果你对安装路径有特定要求,可以选择此项,然后点击 “Next”。在组件选择界面,通常保持默认即可,点击 “Next”。选择安装路径,点击 “Browse” 修改,然后点击 “Next”。
  • 服务配置: 这是 Windows 安装中最关键的一步。
    • 勾选 “Install MongoDB as a Service”(将 MongoDB 安装为服务)。这会让 MongoDB 在系统启动时自动运行,并在后台持续运行。
    • 选择 “Run Service as Network Service user” (使用网络服务用户运行服务)。这是默认且推荐的选项,它拥有运行 MongoDB 服务所需的最低权限。
    • Data Directory 和 Log Directory: 这里显示 MongoDB 数据文件和日志文件的默认存放路径。默认通常是 C:\Program Files\MongoDB\Server\<version>\dataC:\Program Files\MongoDB\Server\<version>\log强烈建议将这些路径修改到系统盘以外的分区,以避免系统盘空间不足或重装系统时数据丢失。点击 “Browse” 选择或手动输入路径。例如,你可以创建 D:\mongodb\dataD:\mongodb\log重要: 确保运行服务的用户(通常是 Network Service)对这些目录有读写权限。如果安装后服务无法启动,这通常是原因之一。
  • 安装 MongoDB Compass: MongoDB Compass 是一个官方提供的图形化管理工具,非常方便。勾选 “Install MongoDB Compass”。点击 “Next”。
  • 准备安装: 点击 “Install”。
  • 用户账户控制: 如果弹出用户账户控制(UAC)提示,点击 “是” 允许安装。
  • 安装过程: 等待安装完成。这可能需要几分钟。
  • 完成安装: 点击 “Finish”。

5. (可选但推荐)将 MongoDB Bin 目录添加到系统 PATH 环境变量

将 MongoDB 的 bin 目录添加到系统 PATH 环境变量后,你可以在任何命令行窗口中直接输入 mongodmongosh 命令,而无需进入到安装目录。

  • 搜索 “环境变量” 或 “Environment Variables”,打开 “编辑系统环境变量”。
  • 在 “系统属性” 窗口中,点击底部的 “环境变量” 按钮。
  • 在 “系统变量” 区域找到名为 “Path” 的变量,选中它,然后点击 “编辑”。
  • 在编辑 Path 环境变量的窗口中,点击 “新建”。
  • 输入 MongoDB bin 目录的完整路径。如果你使用的是默认安装路径,它可能是 C:\Program Files\MongoDB\Server\<version>\bin(将 <version> 替换为你安装的版本号,例如 6.0)。如果你自定义了安装路径,找到该路径下的 bin 文件夹。
  • 点击 “确定” 关闭所有打开的环境变量窗口。
  • 重要: 新的环境变量设置只会在新的命令行窗口中生效。请关闭所有已打开的命令行窗口,重新打开一个新的命令提示符或 PowerShell 窗口。

6. 启动和停止 MongoDB 服务

如果你在安装时选择了 “Install MongoDB as a Service”,服务应该已经自动启动。

  • 检查服务状态: 搜索 “服务” 或 “Services”,打开服务管理工具。找到名为 “MongoDB” 的服务,查看其状态是否为 “正在运行”。
  • 启动服务: 如果服务未运行,右键点击 “MongoDB” 服务,选择 “启动”。
  • 停止服务: 右键点击 “MongoDB” 服务,选择 “停止”。
  • 使用命令行启动/停止(需要管理员权限的命令提示符/PowerShell):
    • 启动:net start MongoDB
    • 停止:net stop MongoDB

7. 连接到 MongoDB

安装包中包含了 mongosh,这是 MongoDB 官方的命令行 Shell。

  • 打开一个新的命令提示符或 PowerShell 窗口。
  • 输入命令:mongosh
  • 如果一切正常,你应该会看到 mongosh 的欢迎信息和连接提示符(默认为 test>)。这意味着你已经成功连接到本地运行的 MongoDB 数据库了。
  • 输入 exit 退出 shell。

如果在安装过程中遇到问题(例如服务无法启动):

  • 检查 Data Directory 和 Log Directory 的路径是否存在,并且当前用户或 Network Service 用户有权访问。
  • 查看 Log Directory 中的日志文件(通常是 mongod.log),其中会包含启动失败的具体原因。
  • 确保没有其他程序占用了默认的 MongoDB 端口 27017。

至此,你已经在 Windows 上成功安装并运行了 MongoDB。

2. 在 macOS 上安装 MongoDB Community Edition

在 macOS 上安装 MongoDB 最推荐和便捷的方式是使用 Homebrew 包管理器。

步骤 1:安装 Homebrew(如果尚未安装)

Homebrew 是 macOS 上一个非常流行的包管理器。打开终端应用程序(可以通过 Spotlight 搜索 “Terminal” 打开),然后运行以下命令安装 Homebrew:

bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

按照终端提示完成安装。安装完成后,根据提示运行 brew doctor 检查安装是否成功。

步骤 2:通过 Homebrew 安装 MongoDB

Homebrew 的主仓库不直接包含 MongoDB,需要先“tap”一个 MongoDB 的仓库。

  1. Tap MongoDB Homebrew 仓库:
    bash
    brew tap mongodb/brew
  2. 安装 MongoDB Community Edition:
    bash
    brew install mongodb-community@<版本号>

    <版本号> 替换为你想安装的具体版本,例如 6.0。如果你想安装最新版本且不关心具体小版本号,可以只写主版本号。Homebrew 会安装该版本下的最新维护版本。例如:
    bash
    brew install [email protected]

    如果你只想安装最新版本,不指定版本号也可以,但建议指定以避免意外升级导致不兼容:
    bash
    brew install mongodb-community # 安装最新版本,但不推荐长期依赖

    Homebrew 会自动下载并安装 MongoDB Server (mongod) 和 Shell (mongosh) 等工具。

3. 启动 MongoDB

使用 Homebrew 安装的 MongoDB 通常会安装在 /usr/local/var/mongodb/opt/homebrew/var/mongodb 路径(取决于你的 Mac 架构和 Homebrew 安装位置),数据文件默认会放在这里。

使用 Homebrew Service 管理 MongoDB 服务非常方便:

  • 以前台模式启动 (用于测试/调试):
    bash
    mongod --config /usr/local/etc/mongod.conf # 默认配置文件路径,可能因版本或安装方式有微小差异

    或直接运行 mongod,它会尝试在 /data/db 寻找数据目录(如果存在且有权限)。通常 Homebrew 安装的服务配置会指向 Homebrew 管理的数据路径。
  • 以后台服务模式启动 (推荐):
    bash
    brew services start mongodb-community@<版本号>

    例如:
    bash
    brew services start [email protected]

    这将把 MongoDB 注册为后台服务,并在启动时自动运行。
  • 检查服务状态:
    bash
    brew services list

    查找 mongodb-community@<版本号>,查看其状态是否是 started
  • 停止服务:
    bash
    brew services stop mongodb-community@<版本号>
  • 重启服务:
    bash
    brew services restart mongodb-community@<版本号>

4. 连接到 MongoDB

安装包中已经包含了 mongosh

  • 打开终端。
  • 输入命令:mongosh
  • 如果 MongoDB 服务正在运行,你应该会成功连接到本地数据库,并看到 mongosh 的欢迎信息和提示符。
  • 输入 exit 退出 shell。

如果遇到问题:

  • 确保 MongoDB 服务已经启动 (brew services list 查看状态)。
  • 检查 Homebrew 给出的安装后提示信息,可能会包含重要配置路径或启动命令。
  • 查看 MongoDB 的日志文件,通常位于 Homebrew 安装路径下的 var/log/mongodb/mongo.log/usr/local/var/log/mongodb/mongo.log
  • 确保没有其他程序占用了默认的 MongoDB 端口 27017。

至此,你已经在 macOS 上成功安装并运行了 MongoDB。

3. 在 Linux 上安装 MongoDB Community Edition

在 Linux 上,使用包管理器是安装 MongoDB 的标准和最方便的方法。MongoDB 官方为主要的 Linux 发行版提供了专门的软件仓库。这里以 Ubuntu/DebianRHEL/CentOS/Fedora 为例。

重要: 具体命令和仓库地址可能会随着 MongoDB 版本和 Linux 发行版版本的不同而变化。务必参考 MongoDB 官方文档中针对你的具体 Linux 版本和 MongoDB 版本的安装指南。 下面的步骤是通用流程和示例命令。

通用前置步骤 (检查系统架构)

MongoDB 社区版通常只支持 x86_64 (amd64) 架构。一些版本可能也支持 ARM64 (arm64)。在安装前,可以使用 dpkg --print-architecture (Debian/Ubuntu) 或 arch (RHEL/CentOS/Fedora) 来确认你的系统架构。

方法 A: 在 Ubuntu/Debian 上使用 apt 安装

这些步骤需要在终端中以 root 用户或使用 sudo 执行。

  1. 导入 MongoDB 公钥: 需要从 MongoDB 官方导入软件仓库的 GPG 公钥,以验证下载的包是合法的。

    • 对于 Ubuntu 20.04+ / Debian 11+ (推荐使用新的 apt-key add 替代方法):
      bash
      curl -fsSL https://pgp.mongodb.com/server-6.0.asc | \
      sudo gpg --dearmor -o /usr/share/keyrings/mongodb-archive-keyring.gpg

      (将 server-6.0.asc 替换为你所需版本的对应 key 文件名)
    • 对于较旧的 Ubuntu/Debian 版本 (使用 apt-key add):
      bash
      wget -qO - https://www.mongodb.org/static/pgp/server-6.0.asc | sudo apt-key add -

      (将 server-6.0.asc 替换为你所需版本的对应 key 文件名)
    • 成功后会返回 OK
  2. 为 MongoDB 创建列表文件: 这个文件告诉 apt 去哪里找 MongoDB 的软件包。

    • 根据你的 Ubuntu/Debian 版本和 MongoDB 版本,创建 /etc/apt/sources.list.d/mongodb-org-6.0.list 文件(将 6.0 替换为你的 MongoDB 版本)。内容格式如下(请参考官方文档获取确切的仓库地址):
      bash
      echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-archive-keyring.gpg ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list

      解释:

      • focal:替换为你的 Ubuntu 版本代号 (如 bionic, focal, jammy) 或 Debian 版本代号 (如 buster, bullseye)。
      • 6.0:替换为你的 MongoDB 版本。
      • [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-archive-keyring.gpg ]:指定支持的架构和用于签名的 keyring 文件。
      • 请务必查阅 MongoDB 官方文档,获取与你的操作系统版本和 MongoDB 版本完全匹配的仓库地址和配置字符串。
  3. 更新本地包数据库:
    bash
    sudo apt update

  4. 安装 MongoDB 包: mongodb-org 是一个“元包”,安装它会自动安装以下组件:mongod (数据库服务器), mongosh (Shell), mongos (分片路由器), 以及其他一些客户端工具。
    bash
    sudo apt install mongodb-org

    如果你想安装特定版本的 MongoDB,可以使用 =<版本号> 语法,例如:
    bash
    sudo apt install mongodb-org=6.0.5 mongodb-org-server=6.0.5 mongodb-org-shell=6.0.5 mongodb-org-mongos=6.0.5 mongodb-org-tools=6.0.5

    但通常直接安装 mongodb-org 包会安装仓库中该分支的最新版本。

方法 B: 在 RHEL/CentOS/Fedora 上使用 yum 或 dnf 安装

这些步骤需要在终端中以 root 用户或使用 sudo 执行。

  1. 创建 .repo 文件: 这个文件告诉 yumdnf 去哪里找 MongoDB 的软件包。

    • /etc/yum.repos.d/ (RHEL/CentOS) 或 /etc/dnf/repos.d/ (Fedora) 目录下创建一个名为 mongodb-org-6.0.repo 的文件(将 6.0 替换为你的 MongoDB 版本)。
    • 使用文本编辑器(如 nanovim)编辑该文件:
      bash
      sudo nano /etc/yum.repos.d/mongodb-org-6.0.repo
    • 将以下内容复制到文件中(请根据你的 RHEL/CentOS/Fedora 版本和 MongoDB 版本查阅官方文档获取确切内容):
      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:这是一个变量,yumdnf 会自动替换为你当前系统的主要版本号(例如 7 或 8 for CentOS/RHEL, 37 or 38 for Fedora)。
      • 6.0:替换为你的 MongoDB 版本。
      • x86_64:系统架构。
      • gpgkey:MongoDB 公钥地址。
      • 请务必查阅 MongoDB 官方文档,获取与你的操作系统版本和 MongoDB 版本完全匹配的 .repo 文件内容。
    • 保存并关闭文件。
  2. 安装 MongoDB 包:

    • 使用 yum (RHEL/CentOS):
      bash
      sudo yum install mongodb-org

      同样,也可以指定特定版本:
      bash
      sudo yum install mongodb-org-6.0.5 mongodb-org-server-6.0.5 mongodb-org-shell-6.0.5 mongodb-org-mongos-6.0.5 mongodb-org-tools-6.0.5
    • 使用 dnf (Fedora 22+ / RHEL 8+):
      bash
      sudo dnf install mongodb-org

      指定特定版本:
      bash
      sudo dnf install mongodb-org-6.0.5 mongodb-org-server-6.0.5 mongodb-org-shell-6.0.5 mongodb-org-mongos-6.0.5 mongodb-org-tools-6.0.5
    • 在安装过程中,可能会提示你确认导入 GPG 密钥,输入 y 并回车。

Linux 安装后的通用步骤:启动和管理 MongoDB 服务

通过包管理器安装的 MongoDB 通常会安装在标准路径,并使用 systemdSysVinit 进行服务管理。数据文件通常默认在 /var/lib/mongodb,日志文件在 /var/log/mongodb

  1. 启动 MongoDB 服务:
    bash
    sudo systemctl start mongod

    (如果你的系统使用 SysVinit,命令可能是 sudo service mongod start)

  2. 验证服务是否正在运行:
    bash
    sudo systemctl status mongod

    你应该会看到服务状态显示为 active (running)

  3. 设置 MongoDB 开机自启动:
    bash
    sudo systemctl enable mongod

  4. 停止服务:
    bash
    sudo systemctl stop mongod

  5. 重启服务:
    bash
    sudo systemctl restart mongod

连接到 MongoDB

安装包中已经包含了 mongosh

  • 打开终端。
  • 输入命令:mongosh
  • 如果 MongoDB 服务正在运行,你应该会成功连接到本地数据库,并看到 mongosh 的欢迎信息和提示符。
  • 输入 exit 退出 shell。

如果遇到问题:

  • 检查防火墙设置。默认情况下,MongoDB 使用端口 27017。你需要确保防火墙允许连接到这个端口(特别是如果你是从远程连接)。例如,使用 ufw (sudo ufw allow 27017) 或 firewalld (sudo firewall-cmd --zone=public --add-port=27017/tcp --permanent, sudo firewall-cmd --reload)。
  • 检查 /var/lib/mongodb/var/log/mongodb 目录的权限。运行 mongod 服务的用户(通常是 mongodb 用户)需要对这些目录有读写权限。
  • 查看日志文件 /var/log/mongodb/mongod.log,其中会包含启动失败的具体原因。
  • 确保SELinux(如果在 RHEL/CentOS 上启用)没有阻止 mongod 进程。可能需要调整 SELinux 策略。

至此,你已经在 Linux 上成功安装并运行了 MongoDB。

4. 使用 Docker 安装和运行 MongoDB

使用 Docker 运行 MongoDB 提供了一种隔离的环境,易于启动、停止和清理。

  1. 安装 Docker: 确保你的系统上已经安装了 Docker Desktop (Windows/macOS) 或 Docker Engine (Linux)。请参考 Docker 官方文档进行安装。
  2. 拉取 MongoDB 镜像: 打开终端或命令提示符,运行以下命令拉取官方的 MongoDB Community 镜像:
    bash
    docker pull mongo

    如果你需要特定版本的 MongoDB,可以指定标签:
    bash
    docker pull mongo:6.0
  3. 运行 MongoDB 容器: 运行以下命令创建一个并启动一个 MongoDB 容器:
    bash
    docker run --name my-mongo -p 27017:27017 -d mongo

    解释:

    • --name my-mongo: 给容器指定一个名字(你可以换成你喜欢的名字)。
    • -p 27017:27017: 将容器内部的 27017 端口映射到主机的 27017 端口,这样你就可以从主机连接到容器里的 MongoDB。
    • -d: 让容器在后台运行(detached mode)。
    • mongo: 使用刚刚拉取的 mongo 镜像。
      重要: 上述命令的数据是存储在容器内部的,如果容器被删除,数据就会丢失。在生产环境或需要持久化数据的场景,应该使用 Docker 数据卷(Volumes)来存储数据:
      “`bash

    创建一个数据卷 (只需要创建一次)

    docker volume create mongo-data

    运行容器,并将数据卷挂载到容器的数据目录

    docker run –name my-mongo-persistent -p 27017:27017 -d -v mongo-data:/data/db mongo
    这样,即使容器被删除,数据卷仍然保留,下次创建新容器并挂载同一个数据卷时,数据会得以恢复。
    4. **连接到 MongoDB 容器:**
    * **使用主机上的 mongosh (如果你已经在主机上安装了 mongosh):**
    bash
    mongosh –port 27017
    (如果映射到其他端口,请修改 `--port`)
    * **在容器内部使用 mongosh:** 如果你的主机没有安装 `mongosh`,或者你想在容器内部操作:
    bash
    docker exec -it my-mongo mongosh
    ``
    (将
    my-mongo` 替换为你容器的名字)

  4. 管理 Docker 容器:

    • 查看正在运行的容器: docker ps
    • 停止容器: docker stop my-mongo
    • 启动容器: docker start my-mongo
    • 删除容器: docker rm my-mongo (在删除前通常需要先停止容器)

使用 Docker 运行 MongoDB 非常灵活,但它与直接安装到操作系统有一些概念上的不同,需要熟悉 Docker 的基本操作。


安装后验证与基本使用

无论你使用哪种方法安装了 MongoDB,都应该进行一些基本验证来确认安装成功,并且可以连接到数据库。

  1. 验证 mongod 命令是否可用:

    • 打开一个新的终端或命令提示符。
    • 输入 mongod --version 并回车。
    • 如果命令被找到并显示了 MongoDB Server 的版本信息,说明 mongod 可执行文件已经正确安装并且在你的 PATH 中(或者你在其安装目录下执行)。
    • 如果你安装的是 Windows 服务或使用 systemctl/brew services 启动,你可能不需要直接运行 mongod 命令,但验证其版本仍然是有用的。
  2. 验证 mongosh 命令是否可用:

    • 打开一个新的终端或命令提示符。
    • 输入 mongosh --version 并回车。
    • 如果命令被找到并显示了 mongosh Shell 的版本信息,说明 mongosh 可执行文件也已经正确安装并且在你的 PATH 中。
  3. 连接到 MongoDB 数据库:

    • 确保 MongoDB Server (mongod) 正在运行(检查 Windows 服务状态,或使用 systemctl status mongod, brew services list, docker ps)。
    • 打开一个新的终端或命令提示符。
    • 输入 mongosh 并回车(如果连接到本地默认端口 27017)。
    • 如果你连接到不同主机或端口,使用 mongosh "mongodb://<主机名>:<端口>" 命令。例如 mongosh "mongodb://localhost:27018"
    • 成功连接后,你会看到类似以下的提示符:
      “`
      Current Mongosh version: 2.0.1
      Using MongoDB: 6.0.5
      Using Mongosh API version: 1

      For interactive help, type “help”.

      test>
      ``
      * 在
      test>提示符下,可以输入一些简单的命令来确认数据库可用,例如:
      *
      db.version():显示当前数据库版本。
      *
      show dbs:显示所有数据库。
      *
      use mydatabase:切换或创建一个名为mydatabase的数据库。
      *
      db.mycollection.insertOne({ name: “Test Document” }):插入一个文档(如果mydatabasemycollection不存在会自动创建)。
      *
      db.mycollection.find():查找集合中的文档。
      * 输入
      exit退出mongosh`。

  4. 检查日志文件: 如果 MongoDB 服务启动失败,查看日志文件是诊断问题的最直接方法。

    • Windows: 安装时指定的日志路径下的 mongod.log
    • macOS (Homebrew): 通常在 /usr/local/var/log/mongodb/mongo.log/opt/homebrew/var/log/mongodb/mongo.log
    • Linux: 通常在 /var/log/mongodb/mongod.log
    • Docker: 使用 docker logs <容器ID或名称> 命令查看容器日志。

重要注意事项

  • 安全性: 默认安装的 MongoDB 通常没有启用身份验证,这意味着任何能够连接到服务器(默认为 localhost)的人都可以完全访问数据库。在生产环境或任何公开网络可访问的环境中,务必启用身份验证并配置用户角色! 这是非常关键的安全步骤,本下载安装教程不包含详细的安全配置,请务必查阅官方文档进行设置。
  • 配置文件: MongoDB 服务器 (mongod) 的行为可以通过配置文件进行控制。Windows 服务安装和 Linux 包管理器安装通常会创建一个默认的配置文件(例如 Linux 上的 /etc/mongod.conf)。你可以编辑这个文件来修改端口、数据/日志路径、绑定 IP 地址、存储引擎选项等。修改配置文件后,通常需要重启 mongod 服务才能生效。
  • 绑定 IP 地址: 默认情况下,MongoDB 可能只绑定到本地回环地址 (127.0.0.1),这意味着你只能从安装 MongoDB 的同一台机器上连接。如果你需要从其他机器连接,需要修改配置文件中的 bindIp 参数,将其设置为服务器的实际 IP 地址或 0.0.0.0 (表示绑定所有可用 IP 地址,但请注意安全风险)。修改后需要重启服务。
  • 升级: MongoDB 提供了升级指南。在升级时,特别是跨主要版本升级,务必仔细阅读官方的升级文档,遵循建议的步骤和兼容性说明,并进行充分的备份。

常见问题及解决

  • mongodmongosh 命令找不到: 确保你已经将 MongoDB bin 目录添加到了系统的 PATH 环境变量中,并且在修改后重启了终端或命令提示符。或者直接切换到 MongoDB bin 目录执行命令。
  • 服务无法启动:
    • 查看日志文件 (mongod.log) 获取详细错误信息。
    • 检查数据目录 (/data/db 或你在配置文件中指定的路径) 和日志目录是否存在,并且运行 mongod 进程的用户(Windows 上的 Network Service, Linux 上的 mongodb 用户)对这些目录有读写权限。
    • 检查端口 27017 是否被其他程序占用。
    • 检查配置文件路径是否正确,文件内容是否有误。
    • 在 Linux 上,检查 SELinux 或防火墙设置。
  • mongosh 无法连接:
    • 确保 mongod 服务正在运行。
    • 检查连接字符串中的主机名和端口是否正确。
    • 确认防火墙允许连接到 MongoDB 端口(默认为 27017)。
    • 检查 MongoDB 服务绑定的 IP 地址 (bindIp 配置) 是否允许来自你尝试连接的机器的连接。

结论

恭喜你!通过按照本教程的步骤,你应该已经成功地在你的计算机上下载并安装了 MongoDB Community Edition,并学会了基本的启动、停止和连接方法。

安装只是第一步。接下来,你可以开始学习 MongoDB 的基本操作:

  • 使用 mongosh 进行 CRUD (创建、读取、更新、删除) 操作。
  • 学习 MongoDB 的数据模型和模式设计。
  • 了解索引、聚合、复制集和分片等高级概念。
  • 学习如何使用各种编程语言的 MongoDB 驱动程序来开发应用程序。

MongoDB 是一个强大而灵活的数据库,潜力巨大。持续的学习和实践是掌握它的关键。祝你在探索 MongoDB 的旅程中一切顺利!


发表评论

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

滚动至顶部