“`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
- 选择版本: 在“Platform”(平台)下拉菜单中选择您的 Windows 版本(通常是
Windows Server 2019 64-bit x64或最新版本)。 - 选择包: 通常选择
.msi安装包,它会提供一个安装向导。 - 点击 “Download”(下载)按钮。
b. macOS
- 选择版本: 在“Platform”(平台)下拉菜单中选择您的 macOS 版本。
- 选择包: 通常选择
x64或适合您 Mac 芯片架构的版本(对于 M1/M2/M3 Mac,选择ARM64;对于 Intel Mac,选择x64)。 - 点击 “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 仓库。您需要创建一个仓库文件。
-
创建一个名为
/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。
- 对于 CentOS/RHEL 7,
-
保存文件。
3. 安装 MongoDB
下载完成后,根据您的操作系统执行安装步骤。
a. Windows 安装
- 运行 MSI 安装包: 双击下载的
.msi文件,启动安装向导。 - 接受许可协议: 阅读并同意许可条款。
- 选择安装类型:
- “Complete”(完整安装):安装所有组件,推荐。
- “Custom”(自定义安装):允许您选择安装路径和组件。如果您想更改默认路径,选择此项。
- 服务配置:
- 在 “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\data和C:\Program Files\MongoDB\Server\7.0\log。
- 安装 MongoDB Compass(可选): MongoDB Compass 是一个图形化用户界面工具,可以方便地管理您的 MongoDB 数据库。建议勾选安装。
- 完成安装: 点击 “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 会自动处理依赖关系和环境变量。
手动安装:
-
解压文件: 将下载的
.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替换为您下载的实际文件名。 -
创建数据和日志目录: 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 -
配置环境变量: 将 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 服务后,您可以通过连接到数据库来验证安装。
- 打开一个新的终端或命令提示符。
-
输入
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.