MongoDB Community Server下载与安装指南 – wiki基地

MongoDB Community Server 下载与安装指南

MongoDB 是一款流行的、开源的文档数据库，以其灵活性、可扩展性和易用性而闻名。它采用 NoSQL 文档数据库模型，存储数据为 BSON（Binary JSON）格式，使得数据结构更具适应性，易于开发和迭代。本文将详细指导您下载和安装 MongoDB Community Server，无论您是初学者还是有经验的开发者，都能从中受益。

一、准备工作

在开始安装之前，请确保满足以下先决条件：

1. 操作系统支持: MongoDB Community Server 支持多种操作系统，包括 Windows、macOS 和 Linux。在下载之前，请确认您的操作系统版本与 MongoDB 支持的版本兼容。 您可以访问 MongoDB 官方网站 (https://www.mongodb.com/docs/manual/reference/platform-support/) 查看具体的支持列表。

2. 系统权限: 在 Windows 和 Linux 系统上，您需要具有管理员权限才能安装 MongoDB。在 macOS 上，需要拥有账户的安装权限。

3. 网络连接: 需要稳定的网络连接才能下载安装包。

4. 存储空间: 确保您的硬盘上有足够的可用空间来存储 MongoDB 程序和数据。 建议至少有 10GB 的可用空间。

二、下载 MongoDB Community Server

1. 访问 MongoDB 官方网站: 打开您的 Web 浏览器并访问 MongoDB 官方网站：https://www.mongodb.com/try/download/community

2. 选择操作系统和版本:

   • 在下载页面上，您会看到一个下拉菜单，用于选择您的操作系统。 选择与您的操作系统相匹配的选项（例如，Windows、macOS、Ubuntu、Debian、Red Hat）。
   • 选择您要下载的 MongoDB 版本。 通常建议下载最新稳定版本。 MongoDB 网站会自动检测您的操作系统，但请务必确认选择正确。 您可以在 “Version” 下拉菜单中选择特定的 MongoDB 版本。
   • 选择包类型。 对于Windows， 通常选择msi 安装包， 它提供图形化安装界面。 对于 Linux 系统， 通常选择 .deb (Debian/Ubuntu) 或 .rpm (Red Hat/CentOS/Fedora) 安装包，它们可以使用相应的包管理器进行安装。

3. 开始下载: 选择完操作系统、版本和包类型后，点击 “Download” 按钮开始下载。 下载的文件通常是一个安装程序或一个压缩包。

三、安装 MongoDB Community Server (以 Windows 为例)

以下步骤以 Windows 系统为例，介绍 MongoDB 的安装过程。 其他操作系统的安装过程类似，可以参考 MongoDB 官方文档。

1. 运行安装程序: 下载完成后，找到下载的 .msi 文件并双击运行。 这将启动 MongoDB 安装向导。

2. 阅读并接受许可协议: 在安装向导中，阅读许可协议并选中 “I accept the terms in the License Agreement” 复选框，然后点击 “Next”。

3. 选择安装类型: 您可以选择 “Complete”（完整安装）或 “Custom”（自定义安装）。

   • Complete: 安装所有 MongoDB 组件，包括服务器、客户端工具和示例文件。 适合于大多数用户。
   • Custom: 允许您选择要安装的组件和安装目录。 如果您想自定义安装，可以选择此选项。 例如，您可以选择只安装服务器组件，而不安装客户端工具。

4. 选择安装目录: 默认情况下，MongoDB 将安装到 C:\Program Files\MongoDB\Server\<version> 目录。 您可以点击 “Change…” 按钮来选择不同的安装目录。建议将 MongoDB 安装到一个空间充足且易于访问的目录。

5. 配置 MongoDB 服务: 在安装过程中，您会被询问是否要将 MongoDB 作为 Windows 服务安装。 建议选择安装为服务，这样 MongoDB 将在后台自动运行，并在系统启动时自动启动。 您还可以选择配置服务名称、数据目录和日志目录。

   • Service Name: 服务的名称，默认为 MongoDB Server (<version>)。 可以根据需要修改。
   • Data Directory: MongoDB 存储数据的目录。 默认情况下，它位于 C:\data\db。 您可以将其更改为其他位置。 注意：如果该目录不存在，您需要手动创建它。
   • Log Directory: MongoDB 存储日志文件的目录。 默认情况下，它位于 C:\data\log。 您可以将其更改为其他位置。 注意：如果该目录不存在，您需要手动创建它。

6. 配置 Compass (可选): 安装程序会询问是否安装 MongoDB Compass。 MongoDB Compass 是 MongoDB 的一个图形化界面 (GUI) 工具，用于管理和查询 MongoDB 数据库。 强烈建议安装 Compass，因为它能大大简化数据库的管理和操作。 如果您不想安装 Compass，可以取消选中相应的复选框。

7. 准备安装: 点击 “Install” 按钮开始安装。 安装过程可能需要几分钟时间。

8. 完成安装: 安装完成后，点击 “Finish” 按钮退出安装向导。 如果您选择了安装 Compass，Compass 会自动启动。

四、安装 MongoDB Community Server (以 Ubuntu 为例)

以下步骤介绍在 Ubuntu 系统上安装 MongoDB 的过程。

1. 导入 MongoDB 公钥: 打开终端并执行以下命令：

   bash
wget -qO - https://www.mongodb.org/static/pgp/server-6.0.asc | sudo apt-key add -

   这条命令会从 MongoDB 官方网站下载公钥，并将其添加到您的系统中，用于验证 MongoDB 软件包的真实性。

2. 添加 MongoDB 软件包源: 执行以下命令，将 MongoDB 软件包源添加到 APT (Advanced Package Tool) 列表中。 请根据您使用的 Ubuntu 版本选择相应的命令。

   • Ubuntu 22.04 (Jammy):

     bash
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list

   • Ubuntu 20.04 (Focal):

     bash
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list

3. 更新软件包列表: 执行以下命令更新 APT 软件包列表：

   bash
sudo apt update

4. 安装 MongoDB Community Server: 执行以下命令安装 MongoDB Community Server：

   bash
sudo apt install mongodb-org

   此命令将安装 MongoDB 服务器、客户端工具和相关的依赖项。

5. 启动 MongoDB 服务: 安装完成后，MongoDB 服务会自动启动。 您可以使用以下命令检查 MongoDB 服务的状态：

   bash
sudo systemctl status mongod

   如果服务未启动，可以使用以下命令启动服务：

   bash
sudo systemctl start mongod

6. 设置 MongoDB 服务开机自启动: 要设置 MongoDB 服务在系统启动时自动启动，执行以下命令：

   bash
sudo systemctl enable mongod

五、配置 MongoDB Community Server

安装完成后，您可能需要配置 MongoDB Community Server 以满足您的特定需求。 MongoDB 的主要配置文件是 mongod.conf，它位于 /etc/mongod.conf (Linux) 或 MongoDB 安装目录下的 bin 文件夹中 (Windows)。

1. 修改配置文件 (mongod.conf): 使用文本编辑器打开 mongod.conf 文件。

   bash
sudo nano /etc/mongod.conf # Linux

   您可以使用您喜欢的任何文本编辑器。

2. 常用配置项: 在 mongod.conf 文件中，您可以修改以下常用配置项：

   • net.bindIp: 指定 MongoDB 监听的 IP 地址。 默认情况下，它设置为 127.0.0.1，表示只允许本地连接。 如果您想允许远程连接，请将其设置为 0.0.0.0 (允许所有 IP 地址连接) 或指定特定的 IP 地址。 注意：允许远程连接需要谨慎配置防火墙和安全设置，以防止未经授权的访问。
   • net.port: 指定 MongoDB 监听的端口号。 默认端口号是 27017。 您可以将其更改为其他未被占用的端口号。
   • storage.dbPath: 指定 MongoDB 存储数据的目录。 与安装过程中选择的 Data Directory 相同。
   • systemLog.path: 指定 MongoDB 存储日志文件的目录。 与安装过程中选择的 Log Directory 相同。
   • security.authorization: 启用或禁用身份验证。 默认情况下，身份验证是禁用的。 如果您需要保护您的数据库，请启用身份验证。 这将要求用户提供用户名和密码才能访问数据库。

3. 保存并关闭配置文件: 修改完成后，保存并关闭 mongod.conf 文件。

4. 重启 MongoDB 服务: 要使配置生效，您需要重启 MongoDB 服务。

   bash
sudo systemctl restart mongod # Linux

   在 Windows 上，您可以通过服务管理器重启 MongoDB 服务。

六、验证 MongoDB 安装

安装并配置 MongoDB 后，您可以验证 MongoDB 是否已成功安装。

1. 连接到 MongoDB 服务器: 打开一个终端或命令提示符，并执行以下命令：

   bash
mongo

   如果 MongoDB 已成功安装并运行，您将看到 MongoDB shell 提示符 >。

2. 查看数据库列表: 在 MongoDB shell 提示符下，执行以下命令：

   bash
show dbs

   此命令将显示当前 MongoDB 服务器上的所有数据库列表。 默认情况下，您会看到 admin、config 和 local 数据库。

3. 创建并使用一个数据库: 您可以创建一个新的数据库并使用它。 例如，要创建一个名为 mydatabase 的数据库并使用它，执行以下命令：

   bash
use mydatabase

   此命令将切换到 mydatabase 数据库。 如果数据库不存在，MongoDB 将在您第一次向其写入数据时自动创建它。

4. 插入一条文档: 您可以在 mydatabase 数据库中插入一条文档。 例如，执行以下命令：

   bash
db.mycollection.insertOne({ name: "John Doe", age: 30 })

   此命令将在 mydatabase 数据库的 mycollection 集合中插入一条包含 name 和 age 字段的文档。

5. 查询文档: 您可以查询 mycollection 集合中的文档。 例如，执行以下命令：

   bash
db.mycollection.find()

   此命令将显示 mycollection 集合中的所有文档。 您应该看到您刚刚插入的文档。

如果以上步骤都成功执行，则表示 MongoDB Community Server 已成功安装并运行。

七、使用 MongoDB Compass (可选)

如果您安装了 MongoDB Compass，可以使用它来管理和查询 MongoDB 数据库。

1. 启动 MongoDB Compass: 在 Windows 上，您可以从开始菜单启动 MongoDB Compass。 在 macOS 和 Linux 上，您可以从应用程序目录启动 MongoDB Compass。

2. 连接到 MongoDB 服务器: 在 MongoDB Compass 中，输入 MongoDB 服务器的连接字符串。 默认情况下，连接字符串是 mongodb://localhost:27017。 点击 “Connect” 按钮连接到 MongoDB 服务器。

3. 浏览数据库和集合: 连接成功后，您可以在 MongoDB Compass 中浏览数据库和集合。 您可以查看文档、执行查询、创建索引、管理用户和执行其他管理任务。

MongoDB Compass 提供了一个直观且易于使用的图形化界面，可以帮助您更轻松地管理和查询 MongoDB 数据库。

八、常见问题和故障排除

• 无法启动 MongoDB 服务: 检查 mongod.conf 文件中的配置是否正确，特别是 net.bindIp、net.port、storage.dbPath 和 systemLog.path 配置项。 确保数据目录和日志目录存在，并且 MongoDB 服务对这些目录具有读写权限。 检查 MongoDB 日志文件以获取更多错误信息。
• 无法连接到 MongoDB 服务器: 检查 MongoDB 服务是否正在运行。 确保您的防火墙允许连接到 MongoDB 端口 (默认端口是 27017)。 如果您启用了身份验证，请确保您使用的用户名和密码是正确的。
• 数据目录权限问题: 确保 MongoDB 服务对数据目录具有读写权限。 在 Linux 上，您可以使用 chown 命令更改数据目录的所有者。
• 端口冲突: 如果另一个应用程序正在使用 MongoDB 端口 (默认端口是 27017)，您需要更改 MongoDB 端口或停止使用该端口的应用程序。

九、总结

本文详细介绍了 MongoDB Community Server 的下载和安装过程，包括 Windows 和 Ubuntu 操作系统。 按照本文的步骤，您应该能够成功安装 MongoDB 并开始使用它。 记住，仔细阅读官方文档，并根据您的特定需求进行配置。 祝您使用 MongoDB 愉快！