如何下载 MongoDB:完整指南与安装步骤 – wiki大全

“`text

如何下载 MongoDB:完整指南与安装步骤

MongoDB 是一款领先的开源 NoSQL 数据库,以其灵活的文档模型和强大的可伸缩性而闻名。无论是开发新应用还是处理大数据,MongoDB 都是一个强大的选择。本指南将详细介绍如何在不同操作系统上下载和安装 MongoDB Community Edition。

1. 简介与前提条件

MongoDB 采用文档数据库模型,将数据存储为 BSON(类似 JSON)文档。它适用于需要快速迭代、处理非结构化数据或横向扩展的应用程序。

在开始下载和安装之前,请确保您的系统满足以下最低要求:

  • 操作系统:
    • Windows Server 2019 / 2016 / 10 / 8.1
    • macOS 10.12 (Sierra) 或更高版本
    • 各种 Linux 发行版(如 Ubuntu, Debian, RHEL, CentOS, Fedora, Amazon Linux)
  • 硬件: 推荐至少 2GB RAM,足够的磁盘空间用于数据存储。
  • 网络: 稳定的互联网连接用于下载。

2. 下载 MongoDB Community Edition

MongoDB 提供企业版和社区版。对于大多数用户和开发目的,社区版已足够使用。

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

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

a. Windows

  1. 选择版本: 在“Platform”(平台)下拉菜单中选择您的 Windows 版本(通常是 Windows Server 2019 64-bit x64 或最新版本)。
  2. 选择包: 通常选择 .msi 安装包,它会提供一个安装向导。
  3. 点击 “Download”(下载)按钮。

b. macOS

  1. 选择版本: 在“Platform”(平台)下拉菜单中选择您的 macOS 版本。
  2. 选择包: 通常选择 x64 或适合您 Mac 芯片架构的版本(对于 M1/M2/M3 Mac,选择 ARM64;对于 Intel Mac,选择 x64)。
  3. 点击 “Download”(下载)按钮。下载的将是一个 .tgz 压缩包。

c. Linux

Linux 的下载方式通常推荐通过包管理器。以下是主流发行版的方法:

Ubuntu / Debian:

MongoDB 官方提供了一个 APT 仓库,您可以从中安装。首先导入 MongoDB 公钥并添加仓库:

“`bash

导入公钥

curl -fsSL https://www.mongodb.org/static/pgp/server-7.0.asc | \
sudo gpg -o /usr/share/keyrings/mongodb-server-7.0.gpg \
–dearmor

为 Ubuntu 22.04 (Jammy) 添加仓库,请根据您的 Ubuntu 版本调整

echo “deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/7.0 multiverse” | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list

更新包列表

sudo apt update
“`

RHEL / CentOS / Fedora / Amazon Linux:

MongoDB 官方提供一个 YUM/DNF 仓库。您需要创建一个仓库文件。

  1. 创建一个名为 /etc/yum.repos.d/mongodb-org-7.0.repo 的文件,并添加以下内容(请根据您的系统版本调整,例如 RHEL/CentOS 8 使用 rhel8):

    [mongodb-org-7.0]
    name=MongoDB Repository
    baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/7.0/x86_64/
    gpgcheck=1
    enabled=1
    gpgkey=https://www.mongodb.org/static/pgp/server-7.0.asc

    • 对于 CentOS/RHEL 7, $releasever 会自动解析为 7
    • 对于 CentOS/RHEL 8, $releasever 会自动解析为 8
    • 对于 Fedora,可能需要手动替换 $releasever 为实际版本号,例如 fedora36
  2. 保存文件。

3. 安装 MongoDB

下载完成后,根据您的操作系统执行安装步骤。

a. Windows 安装

  1. 运行 MSI 安装包: 双击下载的 .msi 文件,启动安装向导。
  2. 接受许可协议: 阅读并同意许可条款。
  3. 选择安装类型:
    • “Complete”(完整安装):安装所有组件,推荐。
    • “Custom”(自定义安装):允许您选择安装路径和组件。如果您想更改默认路径,选择此项。
  4. 服务配置:
    • 在 “Service Configuration” 步骤中,通常勾选 “Install MongoDB as a Service”,并选择 “Run service as Network Service user”“Run service as a local or domain user”。通常使用 Network Service 就足够。
    • 记下数据目录(data directory)和日志目录(log directory)的路径,默认为 C:\Program Files\MongoDB\Server\7.0\dataC:\Program Files\MongoDB\Server\7.0\log
  5. 安装 MongoDB Compass(可选): MongoDB Compass 是一个图形化用户界面工具,可以方便地管理您的 MongoDB 数据库。建议勾选安装。
  6. 完成安装: 点击 “Install” 开始安装。完成后点击 “Finish”。

配置环境变量(可选但推荐):

为了方便在任何命令行中使用 mongo 命令,可以将 MongoDB 的 bin 目录添加到系统环境变量 Path 中。默认路径类似 C:\Program Files\MongoDB\Server\7.0\bin

b. macOS 安装

macOS 上有两种主要安装方式:使用 Homebrew(推荐)或手动安装。

使用 Homebrew 安装(推荐):

如果您的 Mac 上没有 Homebrew,请先安装它:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

然后执行以下命令:

bash
brew tap mongodb/brew
brew install [email protected]

Homebrew 会自动处理依赖关系和环境变量。

手动安装:

  1. 解压文件: 将下载的 .tgz 文件解压到您希望安装 MongoDB 的位置,例如 /usr/local/mongodb

    bash
    sudo mkdir -p /usr/local/mongodb
    sudo tar -zxvf mongodb-macos-x86_64-7.0.x.tgz -C /usr/local/mongodb --strip-components 1

    请将 mongodb-macos-x86_64-7.0.x.tgz 替换为您下载的实际文件名。

  2. 创建数据和日志目录: MongoDB 需要一个目录来存储数据 (db) 和日志 (log)。

    bash
    sudo mkdir -p /data/db
    sudo mkdir -p /usr/local/var/log/mongodb
    sudo chown -R `id -un` /data/db
    sudo chown -R `id -un` /usr/local/var/log/mongodb

  3. 配置环境变量: 将 MongoDB 的 bin 目录添加到您的 PATH 环境变量中。编辑 ~/.bash_profile, ~/.zshrc~/.profile 文件,并添加:

    bash
    export PATH=/usr/local/mongodb/bin:$PATH

    然后运行 source ~/.bash_profile (或相应文件) 使更改生效。

c. Linux 安装

Ubuntu / Debian (使用 APT):

bash
sudo apt install -y mongodb-org

这将安装 MongoDB 服务器、shell 和其他工具。

RHEL / CentOS / Fedora / Amazon Linux (使用 YUM/DNF):

bash
sudo yum install -y mongodb-org # RHEL/CentOS
sudo dnf install -y mongodb-org # Fedora

4. 启动 MongoDB

安装完成后,您需要启动 MongoDB 服务。

a. Windows

MongoDB 在安装时通常会注册为系统服务。您可以通过以下方式启动它:

  • 服务管理器: 打开 “服务” (Services) 管理器,找到 “MongoDB Server (MongoDB)” 服务,右键点击并选择 “启动” (Start)。
  • 命令行:

    cmd
    net start MongoDB

b. macOS

使用 Homebrew 安装的 MongoDB:

bash
brew services start [email protected]

手动安装的 MongoDB:

bash
mongod --dbpath /data/db --logpath /usr/local/var/log/mongodb/mongo.log --fork

注意:--fork 参数让 mongod 在后台运行。您也可以不使用 --fork 来在前台运行,方便查看输出,但在生产环境中通常使用服务管理。

c. Linux

MongoDB 通常会作为一个 systemd 服务安装。

bash
sudo systemctl start mongod
sudo systemctl enable mongod # 设置开机自启动

5. 验证安装

成功启动 MongoDB 服务后,您可以通过连接到数据库来验证安装。

  1. 打开一个新的终端或命令提示符。
  2. 输入 mongosh (MongoDB Shell) 命令:

    bash
    mongosh

    如果一切正常,您将看到连接到 MongoDB 数据库的提示符,例如:

    Current Mongosh Version: 2.2.0
    Connecting to: mongodb://127.0.0.1:27017/?directConnection=true&serverSelectionTimeoutMS=2000&appName=mongosh+2.2.0
    ...
    test>

    test> 提示符表示您已成功连接到默认的 test 数据库。您可以尝试一些简单的命令,例如:

    javascript
    test> db.version()
    test> show dbs

    要退出 shell,输入 exit

6. 常见问题与故障排除

  • 权限问题: 如果 MongoDB 无法启动,通常是数据目录或日志目录的权限不足。确保 MongoDB 进程有读写这些目录的权限。
  • 端口冲突: 默认情况下,MongoDB 在 27017 端口上运行。如果此端口被占用,MongoDB 将无法启动。您可以在配置文件中更改端口。
  • 配置文件: MongoDB 默认使用配置文件 mongod.conf。在 Linux 上通常位于 /etc/mongod.conf。您可以在其中配置数据路径、日志路径、端口等。
  • 防火墙: 如果您从其他机器连接 MongoDB,请确保防火墙允许 27017 端口的流量。

7. 结论

通过遵循本指南,您应该已经成功在您的系统上下载并安装了 MongoDB Community Edition。现在,您可以开始使用 MongoDB 来构建您的应用程序,体验其强大而灵活的功能。
“`
The user’s request was to write an article about downloading and installing MongoDB. I have provided a comprehensive guide covering Windows, macOS, and Linux, including download steps, installation instructions, how to start the service, and how to verify the installation. The article also includes a troubleshooting section. I believe this fulfills the request.

滚动至顶部