MongoDB Windows 安装指南 – wiki基地

MongoDB Windows 安装指南：从零开始，一步到位

前言

作为一款开源、高性能、无模式的文档型数据库，MongoDB 在现代 Web 开发、大数据以及各种需要灵活数据结构的场景中扮演着越来越重要的角色。它的灵活性、可伸缩性以及强大的查询能力使其广受开发者欢迎。如果您正在使用 Windows 操作系统，并希望在本地环境搭建一个 MongoDB 数据库用于学习、开发或测试，那么这篇详细的安装指南将为您提供从下载到配置、验证以及基础使用的全过程指引。我们将确保您即使是初学者也能轻松完成安装。

本文将重点介绍如何在 Windows 操作系统上安装 MongoDB Community Server 版本，这是 MongoDB 的免费、开源版本，足以满足绝大多数个人用户和中小型应用的需求。

准备工作：系统要求与下载

在开始安装之前，我们需要确认您的系统满足基本要求并下载安装包。

1. 系统要求：

MongoDB Community Server 支持多种 Windows 版本。通常，它支持当前主流的 64 位 Windows 版本，包括但不限于：

Windows 10
Windows 11
Windows Server 2016
Windows Server 2019
Windows Server 2022

请确保您的 Windows 系统是 64 位版本，并且您拥有管理员权限，因为安装过程涉及写入系统目录和创建服务。

2. 下载 MongoDB Community Server：

这是获取安装文件的唯一官方渠道。

打开您的网页浏览器，访问 MongoDB 官方下载页面：https://www.mongodb.com/try/download/community
在页面上，您会看到几个选项。请确保选择以下内容：
- Version (版本): 选择您需要的版本。对于大多数新用户，推荐选择最新的稳定版本。下拉菜单会显示可用的版本列表。请注意，不同版本之间可能存在一些特性或安装过程的微小差异，但核心步骤基本一致。
- OS (操作系统): 选择 “Windows”。
- Package (包类型): 选择 “MSI”。MSI 安装包是 Windows 上推荐的标准安装方式，它提供了安装向导，可以方便地将 MongoDB 安装为 Windows 服务，并包含必要的工具。另一种是 ZIP 包，虽然更灵活，但需要手动配置较多内容，不适合初学者，本文将以 MSI 安装为主。
确认选择无误后，点击绿色的 “Download (下载)” 按钮。MSI 安装文件将开始下载到您的计算机上。文件大小可能几百MB，下载时间取决于您的网络速度。

在下载期间，您可以暂时浏览一下 MongoDB 的官方文档，或者阅读关于 MongoDB Compass 的信息（这是一个非常好用的图形用户界面工具，我们也会在安装过程中选择安装它）。

第一部分：使用 MSI 安装包进行安装

下载完成后，找到您下载的 .msi 文件（例如：mongodb-windows-x86_64-X.Y.Z-signed.msi，其中 X.Y.Z 是版本号）。双击该文件启动安装向导。

步骤 1：运行安装程序

双击下载的 MSI 文件后，可能会出现一个用户账户控制（UAC）提示，询问您是否允许此应用对您的设备进行更改。请点击 “是” 以继续。

步骤 2：欢迎界面

安装向导的欢迎界面会显示 MongoDB 的标志。点击 “Next (下一步)”。

步骤 3：接受许可协议

您需要阅读并接受 MongoDB Community Server 的许可协议。仔细阅读后，勾选 “I accept the terms in the License Agreement (我接受许可协议中的条款)” 复选框，然后点击 “Next (下一步)”。

步骤 4：选择安装类型

这里通常有两个选项：

Complete (完整安装): 这是推荐的选项，特别是对于大多数用户。它会安装所有标准的 MongoDB 程序文件到默认位置，并自动设置一些基本配置。
Custom (自定义安装): 此选项允许您选择要安装的组件以及更改安装目录、数据目录和日志目录等。如果您希望将 MongoDB 安装到非默认路径，或者对数据存储位置有特定要求，可以选择此项。对于本指南，我们将详细介绍 Custom 安装，因为它可以让您更好地理解安装路径和数据存储位置，这对于后续管理和故障排除非常重要。

选择 “Custom (自定义安装)”，然后点击 “Next (下一步)”。

步骤 5：配置自定义安装

如果您选择了 Custom 安装，这一步允许您详细配置：

Select Features (选择功能): 通常，默认勾选的组件已经足够。包括 MongoDB Server Programs、MongoDB Shell、MongoDB Compass 等。确保勾选了您需要的组件。通常，您至少需要安装 MongoDB Server 和 MongoDB Shell (mongosh)。强烈建议也安装 MongoDB Compass，它是一个图形化工具，让您更容易管理数据库。
Installation Directory (安装目录): 这是 MongoDB 程序文件将被安装的位置。默认路径通常是 C:\Program Files\MongoDB\Server\<Version>\ (例如 C:\Program Files\MongoDB\Server\6.0\)。您可以点击 “Browse (浏览)” 按钮更改此路径。建议保留默认路径，除非您有特定的理由将其安装到其他位置。 确保选择的驱动器有足够的空间。
确认功能和安装目录后，点击 “Next (下一步)”。

步骤 6：配置 MongoDB 作为服务

这是安装过程中的一个关键步骤。将 MongoDB 安装为 Windows 服务可以让它在系统启动时自动运行，并在后台持续运行，无需手动启动一个命令行窗口。

Install MongoDB as a Service (安装 MongoDB 作为服务): 勾选此选项。这是推荐的方式。
Service Name (服务名称): 默认名称通常是 “MongoDB”。您可以更改它，但在后续管理服务时需要记住这个名称。
Data Directory (数据目录): 这是 MongoDB 存储所有数据库文件的地方。默认路径通常是 C:\Program Data\MongoDB\Data\。请注意： C:\Program Data 是一个隐藏的系统文件夹。您可以点击 “Browse (浏览)” 更改此路径。强烈建议更改此路径到一个非系统盘（如果可用）并且方便您管理的目录，例如 D:\MongoDB\Data 或 E:\MongoDB\Data。确保您选择的目录存在，并且运行服务的用户（下一步配置）对此目录有读写权限。
Log Directory (日志目录): 这是 MongoDB 存储运行时日志文件的地方。默认路径通常是 C:\Program Data\MongoDB\Log\。同样，您也可以更改此路径。建议与数据目录放在同一根目录下，方便管理，例如 D:\MongoDB\Log。确保目录存在且有写入权限。
Service Account (服务账户):
- Run the service as Network Service user (将服务作为网络服务用户运行): 这是默认且通常推荐的选项。网络服务账户是 Windows 提供的一个内置账户，拥有运行服务所需的适当权限，并且安全性较高。
- Run the service as a Local or Domain User (将服务作为本地或域用户运行): 如果您需要 MongoDB 服务以特定用户的身份运行（例如，访问需要特定用户权限的网络资源），可以选择此项。但对于本地开发环境，Network Service 通常足够。如果您选择此项，需要提供用户名和密码。

重要提示： 记录下您设置的数据目录和日志目录路径，将来您可能需要访问这些目录来查看数据文件或排查问题。

配置完成后，点击 “Next (下一步)”。

步骤 7：安装 MongoDB Compass

Install MongoDB Compass (安装 MongoDB Compass): 勾选此选项。MongoDB Compass 是一个官方提供的图形用户界面 (GUI) 工具，可以极大地简化数据库的管理和数据查看操作。强烈建议安装它。
如果您已经安装了最新版本的 Compass，或者不希望安装 GUI 工具，可以取消勾选。
点击 “Next (下一步)”。

步骤 8：准备安装

安装向导会显示一个摘要，列出您选择的安装类型、安装路径、数据/日志目录等信息。检查这些信息是否正确。

点击 “Install (安装)” 开始安装过程。

步骤 9：安装过程

安装程序会开始复制文件、创建服务、配置系统。这个过程可能需要几分钟。您会看到一个进度条。

步骤 10：完成安装

安装完成后，向导会显示 “Completed the MongoDB X.Y.Z Setup Wizard (已完成 MongoDB X.Y.Z 安装向导)”。

Connect to MongoDB Compass (连接到 MongoDB Compass): 如果您安装了 Compass 并勾选了此选项，安装向导完成后会自动尝试启动 Compass。
点击 “Finish (完成)” 关闭安装向导。

至此，MongoDB Community Server 的核心程序和相关工具已经安装到您的 Windows 系统中，并且 MongoDB 服务已经被创建并默认启动。

第二部分：安装后的配置与验证

安装完成后，还有几个重要的步骤需要进行，以确保您可以方便地使用 MongoDB。

1. 验证 MongoDB 服务是否正在运行：

按下 Win + R 键，输入 services.msc 并回车，打开 Windows 服务管理器。
在服务列表中找到名为 “MongoDB”（如果您在安装时更改了名称，请找您指定的名称）的服务。
查看该服务的 “状态” 列。它应该显示为 “正在运行”。
查看该服务的 “启动类型” 列。它应该显示为 “自动”。
如果服务未运行，您可以右键点击该服务，选择 “启动”。如果启动失败，这可能是安装过程中权限或路径设置问题，需要查看日志文件进行排查（日志文件位置是您在安装时指定的 Log Directory）。

2. 配置环境变量（将 MongoDB 的 bin 目录添加到 PATH）：

这一步非常重要，它允许您在任何命令提示符或 PowerShell 窗口中直接运行 mongosh 或其他 MongoDB 工具，而无需切换到 MongoDB 的安装目录。

右键点击 “此电脑” 或 “计算机”，选择 “属性”。
点击左侧的 “高级系统设置”。
在弹出的 “系统属性” 窗口中，点击底部的 “环境变量” 按钮。
在 “环境变量” 窗口中，找到下方的 “系统变量(S)” 区域。
在系统变量列表中找到名为 Path 或 PATH 的变量，双击它进行编辑。
在 “编辑环境变量” 窗口中，点击 “新建(N)”。
输入您的 MongoDB 安装目录下的 bin 文件夹的完整路径。例如，如果您将 MongoDB 安装到默认位置，路径可能是 C:\Program Files\MongoDB\Server\6.0\bin (请将 6.0 替换为您安装的实际版本号)。确保路径正确，以 \bin 结尾。
点击 “确定” 关闭 “编辑环境变量” 窗口。
点击 “确定” 关闭 “环境变量” 窗口。
点击 “确定” 关闭 “系统属性” 窗口。

重要提示： 在更改了环境变量后，您需要关闭所有已经打开的命令提示符或 PowerShell 窗口，然后重新打开一个新的窗口，环境变量的更改才会生效。

3. 验证环境变量和 mongosh：

打开一个新的命令提示符窗口（搜索 cmd 并打开）或 PowerShell 窗口。
输入命令：mongosh --version
如果您看到类似 MongoDB Shell version vX.Y.Z 的输出（其中 X.Y.Z 是版本号），则说明 mongosh 已成功安装并且环境变量配置正确，您可以在任何地方调用 MongoDB shell 了。
如果出现 'mongosh' 不是内部或外部命令，也不是可运行的程序或批处理文件。 这样的错误提示，则说明环境变量没有设置正确，或者新的命令行窗口没有重新打开。请仔细检查步骤 2。

4. 连接到 MongoDB：

在验证 mongosh 成功的同一个命令行窗口中，直接输入 mongosh 并回车。

如果 MongoDB 服务正在运行（步骤 1 中已验证），并且您没有修改默认端口（默认为 27017），mongosh 将会尝试连接到本地运行的 MongoDB 实例。
连接成功后，您会看到一些连接信息，并且命令提示符会变成 >，表示您已经进入了 MongoDB shell 环境。
您可以在这里输入 MongoDB 命令，例如 show dbs 来查看所有数据库。
要退出 shell，输入 .exit 并回车，或者按下 Ctrl + C 两次。

5. 启动 MongoDB Compass (GUI 工具):

如果您在安装时选择了安装 Compass，现在可以启动它。

在 Windows 搜索栏中搜索 “MongoDB Compass” 并打开。
第一次打开时，它可能会提示您连接到数据库。如果您使用默认设置安装了 MongoDB，可以直接点击 “Connect” 按钮，它会尝试连接到 mongodb://localhost:27017/。
连接成功后，您将看到一个图形界面，可以方便地查看数据库、集合、文档等信息，并执行查询操作。Compass 是学习和管理 MongoDB 的强大工具。

至此，您已经在 Windows 上成功安装并基本配置了 MongoDB，并且可以通过命令行工具 mongosh 或图形界面工具 Compass 进行连接和操作。

第三部分：管理 MongoDB 服务

由于我们将 MongoDB 安装为了 Windows 服务，您可以通过 Windows 服务管理器来方便地管理它的生命周期。

打开 Windows 服务管理器 (services.msc)。
找到 “MongoDB” 服务。
启动服务： 如果服务状态是 “已停止”，右键点击服务，选择 “启动”。
停止服务： 右键点击服务，选择 “停止”。停止服务会终止所有对数据库的连接，并在安全关闭后退出。
重启服务： 右键点击服务，选择 “重新启动”。这会先停止服务，然后自动启动它。
修改启动类型： 右键点击服务，选择 “属性”，在 “常规” 选项卡中可以修改启动类型（自动、手动、禁用）。通常设置为 “自动” 即可。

此外，您也可以使用命令行来管理服务（需要以管理员身份运行命令提示符或 PowerShell）：

启动服务：net start MongoDB
停止服务：net stop MongoDB

第四部分：故障排除

在安装或配置过程中可能会遇到一些问题，以下是一些常见的故障及其解决方法：

'mongosh' 不是内部或外部命令...：
- 原因：MongoDB 的 bin 目录未添加到系统 PATH 环境变量中，或者环境变量更改后没有重新打开命令行窗口。
- 解决方法：
  1. 仔细按照第二部分步骤 2 检查和修改系统 PATH 环境变量，确保路径指向正确的 bin 目录（例如 C:\Program Files\MongoDB\Server\6.0\bin）。
  2. 务必关闭所有现有命令行窗口，然后重新打开一个新的窗口再尝试运行 mongosh。
MongoDB 服务无法启动 (在 services.msc 中启动失败)：
- 原因：常见原因包括：数据目录或日志目录不存在，或者运行服务的用户（通常是 Network Service）对这些目录没有足够的读写权限；配置文件错误（如果您手动修改过）；端口被占用等。
- 解决方法：
  1. 查看日志文件： 前往您在安装时指定的日志目录（例如 D:\MongoDB\Log），打开最新的日志文件 (mongod.log)。日志文件中会记录服务启动失败的具体原因，这是最重要的排查信息来源。
  2. 检查目录权限： 确保您指定的数据目录和日志目录存在。右键点击这些目录，选择 “属性” -> “安全” 选项卡。确保运行服务的用户（通常是 NETWORK SERVICE）具有 “完全控制” 或至少 “修改”、”读取和执行”、”列出文件夹内容”、”读取”、”写入” 等权限。如果权限不足，点击 “编辑” -> “添加” -> 输入 NETWORK SERVICE -> 点击 “检查名称” -> “确定” -> 赋予权限 -> “确定”。
  3. 检查数据目录是否为空： 如果数据目录之前被其他 MongoDB 实例使用过，并且不是正常关闭，可能会导致启动问题。尝试清空数据目录（请注意：这将删除所有数据库数据，请谨慎操作！）后重试启动。
  4. 检查端口占用： MongoDB 默认使用 27017 端口。可能有其他程序占用了这个端口。可以在命令行中使用 netstat -ano | findstr 27017 命令查看哪个进程占用了该端口。如果端口被占用，您可以停止占用端口的程序，或者修改 MongoDB 的配置文件（mongod.cfg，通常位于安装目录的 bin 或根目录，需要手动创建或修改）来使用不同的端口。修改配置文件后，需要重启 MongoDB 服务。
Compass 无法连接到 MongoDB：
- 原因：MongoDB 服务未运行；连接字符串错误；防火墙阻止了连接。
- 解决方法：
  1. 验证服务状态： 确保 MongoDB 服务正在运行 (services.msc 中状态为 “正在运行”)。
  2. 检查连接字符串： 默认连接到本地实例通常是 mongodb://localhost:27017/。确保端口号正确。
  3. 检查防火墙： Windows 防火墙可能阻止了外部或本地程序连接到 MongoDB 的 27017 端口。需要配置防火墙规则，允许来自本地的连接通过 TCP 端口 27017。您可以通过 “控制面板” -> “系统和安全” -> “Windows Defender 防火墙” -> “高级设置” 来配置入站规则。

第五部分：进一步学习

成功安装 MongoDB 只是第一步。接下来，您可以：

学习基本命令： 在 mongosh 中练习创建数据库、集合、插入文档、查询文档、更新文档和删除文档等基本操作。MongoDB 官方文档是最好的学习资源。
深入使用 Compass： 探索 Compass 的各种功能，例如数据可视化、查询构建器、性能分析等。
了解配置文件： 熟悉 mongod.cfg 文件的位置和内容，学习如何配置端口、存储引擎、日志级别等。
学习索引： 索引对于提高查询性能至关重要。
了解驱动程序： 如果您是开发者，学习如何在您使用的编程语言（如 Node.js, Python, Java, .NET 等）中使用 MongoDB 官方驱动程序连接和操作数据库。

结论

通过本篇详细的 Windows 安装指南，您应该已经成功地在您的计算机上搭建了 MongoDB 环境。我们从下载 MSI 安装包开始，详细介绍了安装向导的每一步，特别是自定义安装、服务配置以及数据/日志目录的设置。随后，我们指导您验证了服务的运行状态，配置了至关重要的环境变量，并验证了 mongosh 工具的可用性，最后启动了方便的图形界面工具 Compass。文章还包含了一些常见的故障排除方法，帮助您解决可能遇到的问题。

希望这篇指南对您有所帮助！现在，您可以开始探索 MongoDB 的强大功能，并在您的项目或学习中充分利用这个优秀的文档型数据库。记住，遇到问题时，查阅 MongoDB 的官方文档通常是获取最准确和最新信息的地方。祝您使用愉快！