MongoDB 入门：下载与配置 – wiki基地

作者： /

MongoDB 入门：下载与配置

MongoDB 作为一个领先的 NoSQL 数据库，以其灵活的文档模型、高可扩展性和强大的性能，受到了众多开发者的青睐。无论是初学者还是经验丰富的开发者，掌握 MongoDB 的下载与配置是踏入其精彩世界的第一步。本文将详细介绍如何在不同操作系统上下载、安装并进行基础配置，助您快速入门。

1. 什么是 MongoDB？为什么选择它？

MongoDB 是一款开源的、基于文档的分布式数据库，属于 NoSQL 数据库家族。与传统的关系型数据库不同，MongoDB 以 BSON（Binary JSON）格式存储数据，这种文档结构非常灵活，易于表示层级数据，并且无需预定义严格的表结构。

为什么选择 MongoDB？

  • 灵活性： 文档模型让数据结构变更变得容易，适合快速迭代的开发模式。
  • 可扩展性： 支持水平扩展（分片），能够处理海量数据和高并发访问。
  • 高性能： 内建索引和内存映射文件机制提供了出色的读写性能。
  • 丰富的功能： 支持强大的查询语言、聚合框架、地理空间索引等。
  • 开发友好： JSON 格式与现代编程语言无缝集成。

2. 下载 MongoDB

MongoDB 提供了不同版本以适应不同的使用场景。对于初学者，我们推荐下载 Community Server 版本。

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

在该页面，您需要选择适合您操作系统的版本。

2.1 Windows

  1. 在下载页面，选择 Windows 平台。
  2. 选择最新的稳定版本（通常是推荐版本）。
  3. 选择 MSI 包类型下载。MSI 安装器会引导您完成安装过程。

2.2 macOS

  1. 在下载页面，选择 macOS 平台。
  2. 选择最新的稳定版本。

  3. 选择 TGZ 或 ZIP 包类型下载。

    • 推荐使用 Homebrew： 如果您是 macOS 用户，最简便的方式是使用 Homebrew 包管理器进行安装。请跳至 3.2 macOS 安装步骤。

2.3 Linux (以 Ubuntu/Debian 为例)

MongoDB 官方为常见的 Linux 发行版提供了包管理器的安装方式，这是推荐的方法。

  1. 在下载页面，选择 Linux 平台。
  2. 选择您的 Linux 发行版（例如 Ubuntu 22.04 LTS）。

  3. 选择最新的稳定版本。

    • 请记住页面上提供的安装指令，它们将引导您通过包管理器安装。请跳至 3.3 Linux 安装步骤。

3. 安装与配置 MongoDB

3.1 Windows 安装与基础配置

  1. 运行 MSI 安装器： 双击下载的 .msi 文件，启动安装向导。
  2. 自定义安装（推荐）：
    • 选择 Custom（自定义）安装类型。
    • 您可以更改 MongoDB 的安装路径。默认路径通常是 C:\Program Files\MongoDB\Server\<version>。
    • 重要： 确保勾选 “Install MongoDB Compass”（MongoDB 的官方 GUI 工具），它会极大地方便您的日常操作。
  3. 服务配置：
    • 安装程序会询问是否将 MongoDB 安装为 Windows 服务。建议勾选此选项，这样 MongoDB 会在系统启动时自动运行。
    • 您可以自定义数据目录 (dbPath) 和日志目录 (logPath)。默认路径通常是 C:\Program Files\MongoDB\Server\<version>\data 和 C:\Program Files\MongoDB\Server\<version>\log。为了更好的管理，建议将数据文件（data）和日志文件（log）存放在一个更方便访问且权限适当的目录，例如 C:\mongodb\data 和 C:\mongodb\log。
  4. 完成安装： 按照指示完成安装。

验证安装：

  • 打开命令提示符（CMD）或 PowerShell。
  • 输入 mongo --version 或 mongosh --version (取决于您安装的 MongoDB Shell 版本)。如果能看到版本信息，说明安装成功。
  • 输入 net start MongoDB 启动 MongoDB 服务。
  • 输入 mongosh 连接到数据库。

3.2 macOS 安装与基础配置 (使用 Homebrew)

使用 Homebrew 是在 macOS 上安装 MongoDB 最简单和推荐的方式。

  1. 安装 Homebrew (如果尚未安装):
    bash
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  2. 更新 Homebrew:
    bash
    brew update
  3. 安装 MongoDB Community Server:
    bash
    brew install mongodb-community
    Homebrew 会自动处理依赖项并安装 MongoDB。
  4. 配置数据和日志目录：
    Homebrew 默认会将数据目录创建在 /usr/local/var/mongodb，日志目录在 /usr/local/var/log/mongodb。通常这些路径可以直接使用。
  5. 启动 MongoDB 服务：
    bash
    brew services start mongodb-community
    这将把 MongoDB 配置为后台服务，并在每次系统启动时自动运行。

    • 停止服务: brew services stop mongodb-community
    • 重启服务: brew services restart mongodb-community
  6. 连接到 MongoDB：
    bash
    mongosh
    这将启动 MongoDB Shell 并连接到默认的本地数据库实例。

3.3 Linux (Ubuntu/Debian) 安装与基础配置

  1. 导入 MongoDB 公钥：
    bash
    sudo apt-get install gnupg curl
    curl -fsSL https://www.mongodb.org/static/pgp/server-7.0.asc | \
    sudo gpg -o /usr/share/keyrings/mongodb-archive-keyring.gpg \
    --dearmor
    (请注意，server-7.0.asc 中的 7.0 应替换为您下载的 MongoDB 版本号。)

  2. 为 MongoDB 创建列表文件：
    bash
    echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-archive-keyring.gpg ] https://repo.mongodb.org/apt/ubuntu $(lsb_release -cs)/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list
    (同样，7.0 替换为您下载的 MongoDB 版本号，$(lsb_release -cs) 会自动检测您的 Ubuntu 版本，如 focal 或 jammy。)

  3. 重新加载本地包数据库：
    bash
    sudo apt-get update

  4. 安装 MongoDB 包：
    bash
    sudo apt-get install -y mongodb-org
    这将安装 MongoDB 服务器、Shell (mongosh) 和其他工具。

  5. 启动 MongoDB 服务：
    bash
    sudo systemctl start mongod

  6. 验证 MongoDB 服务状态：
    bash
    sudo systemctl status mongod
    确保服务处于 active (running) 状态。

  7. 配置 MongoDB 开机自启动：
    bash
    sudo systemctl enable mongod

  8. 连接到 MongoDB：
    bash
    mongosh

重要配置路径：

  • 配置文件： /etc/mongod.conf
  • 数据目录： /var/lib/mongodb
  • 日志目录： /var/log/mongodb

您可以编辑 /etc/mongod.conf 文件来修改这些路径或其他配置。

3.4 MongoDB 核心配置文件 mongod.conf

mongod.conf 是 MongoDB 服务器的主要配置文件。了解和修改它对于定制您的 MongoDB 部署至关重要。

以下是一些关键配置项：

“`yaml

systemLog 配置

systemLog:
destination: file
logAppend: true
path: /var/log/mongodb/mongod.log # 日志文件路径 (Linux 示例)

storage 配置

storage:
dbPath: /var/lib/mongodb # 数据文件存储路径 (Linux 示例)
journal:
enabled: true

processManagement 配置

processManagement:
fork: true # 启动时作为后台进程运行
pidFilePath: /var/run/mongodb/mongod.pid # PID 文件路径

network interfaces 配置

net:
port: 27017 # 监听端口，默认 27017
bindIp: 127.0.0.1 # 监听 IP 地址，默认只监听本地，若需远程访问，可改为 0.0.0.0 (不推荐生产环境直接这样配置)

security 配置 (入门阶段可暂时忽略，但生产环境必须启用)

security:

authorization: enabled # 启用权限认证

“`

修改配置后：

  • Linux/macOS (Homebrew): 重启 mongod 服务：sudo systemctl restart mongod (Linux) 或 brew services restart mongodb-community (macOS)。
  • Windows: 如果您安装为服务，可能需要通过“服务”管理器重启 MongoDB 服务，或在命令行使用 net stop MongoDB 后 net start MongoDB。

3.5 绑定 IP 地址 (bindIp)

默认情况下，MongoDB 只监听 127.0.0.1（本地回环地址），这意味着它只能从运行在同一台机器上的应用程序访问。

  • 仅限本地开发： 保持 bindIp: 127.0.0.1。
  • 允许特定 IP 访问： 如果您希望从同一网络中的其他机器访问，可以将其设置为服务器的私有 IP 地址，例如 bindIp: 192.168.1.100。
  • 允许所有 IP 访问（不推荐生产环境）： 将其设置为 bindIp: 0.0.0.0。注意： 在生产环境中这样做非常危险，会使您的数据库暴露在互联网上。生产环境应配合防火墙规则和认证机制来保障安全。

4. 连接到 MongoDB

安装完成后，您可以使用 mongosh（MongoDB Shell）连接到数据库。

bash
mongosh

如果您的 MongoDB 服务器运行在默认端口 (27017) 且监听本地 IP，上述命令即可直接连接。

若服务器运行在非默认端口或远程机器上：

“`bash
mongosh –host –port

例如：

mongosh –host my.remote.server.com –port 27017

“`

连接成功后，您会看到 > 提示符，表示您已进入 MongoDB Shell，可以开始执行数据库操作了。

5. 总结与下一步

恭喜您！您已经成功下载、安装并配置了 MongoDB，并学会了如何连接到它。这是您 MongoDB 之旅的重要里程碑。

接下来，您可以开始：

  • 学习 MongoDB 的基本命令（如 show dbs, use <dbname>, db.collection.insertOne(), db.collection.find() 等）。
  • 探索 MongoDB Compass，它提供了一个直观的图形界面来管理您的数据库。
  • 深入研究 MongoDB 的索引、聚合框架和复制集等高级功能。
  • 在您选择的编程语言中使用 MongoDB 驱动程序来构建应用程序。

祝您在 MongoDB 的学习和使用中一切顺利！

滚动至顶部