MongoDB Community Server 下载安装教程
MongoDB Community Server 下载安装教程(超详细版)
MongoDB 是一个流行的、开源的、面向文档的 NoSQL 数据库。它以高性能、高可用性和易扩展性著称,被广泛应用于各种 Web 应用、移动应用、大数据分析等场景。本教程将详细介绍如何在 Windows、macOS 和 Linux (Ubuntu) 三个主流操作系统上下载和安装 MongoDB Community Server。
文章目录
- MongoDB 简介
- 1.1 什么是 MongoDB?
- 1.2 MongoDB 的特点
- 1.3 MongoDB 适用场景
- 下载 MongoDB Community Server
- 2.1 访问 MongoDB 官网
- 2.2 选择版本和操作系统
- 2.3 下载安装包
- Windows 系统安装 MongoDB Community Server
- 3.1 双击安装程序
- 3.2 安装向导步骤
- 3.2.1 接受许可协议
- 3.2.2 选择安装类型(完整或自定义)
- 3.2.3 服务配置(作为服务运行)
- 3.2.4 数据目录和日志目录设置
- 3.2.5 安装 MongoDB Compass(可选)
- 3.3 完成安装
- 3.4 配置环境变量
- 3.5 启动 MongoDB 服务
- 3.6 连接 MongoDB Shell
- 3.7 验证安装
- macOS 系统安装 MongoDB Community Server
- 4.1 使用 Homebrew 安装(推荐)
- 4.1.1 安装 Homebrew(如果未安装)
- 4.1.2 使用 Homebrew 安装 MongoDB
- 4.2 手动安装
- 4.2.1 下载安装包
- 4.2.2 解压安装包
- 4.2.3 创建数据目录和日志目录
- 4.2.4 启动 MongoDB 服务
- 4.3 验证安装
- 4.1 使用 Homebrew 安装(推荐)
- Linux (Ubuntu) 系统安装 MongoDB Community Server
- 5.1 使用 apt 包管理器安装(推荐)
- 5.1.1 导入 MongoDB 公钥
- 5.1.2 创建 MongoDB 源列表文件
- 5.1.3 更新 apt 包索引
- 5.1.4 安装 MongoDB
- 5.2 手动安装
- 5.2.1 下载安装包
- 5.2.2 解压安装包
- 5.2.3 创建数据目录和日志目录
- 5.2.4 启动MongoDB服务
- 5.3 验证安装
- 5.1 使用 apt 包管理器安装(推荐)
- 配置 MongoDB (可选)
- 6.1 配置文件位置
- 6.2 常用配置选项
- 6.2.1
net.bindIp
(绑定 IP 地址) - 6.2.2
net.port
(端口号) - 6.2.3
storage.dbPath
(数据目录) - 6.2.4
systemLog.path
(日志文件路径) - 6.2.5
security.authorization
(启用授权)
- 6.2.1
- 安装 MongoDB Compass (可选)
- 常见问题解答 (FAQ)
- 8.1 如何停止 MongoDB 服务?
- 8.2 如何卸载 MongoDB?
- 8.3 如何升级 MongoDB?
- 8.4 如何查看 MongoDB 版本?
- 8.5 如何备份和恢复 MongoDB 数据?
- 8.6 遇到连接问题怎么办?
- 8.7 如何设置 MongoDB 用户和密码?
- 总结
1. MongoDB 简介
1.1 什么是 MongoDB?
MongoDB 是一个基于分布式文件存储的数据库。由 C++ 语言编写。旨在为 WEB 应用提供可扩展的高性能数据存储解决方案。
MongoDB 是一个介于关系数据库和非关系数据库之间的产品,是非关系数据库当中功能最丰富,最像关系数据库的。它支持的数据结构非常松散,是类似 JSON 的 BSON 格式,因此可以存储比较复杂的数据类型。Mongo 最大的特点是它支持的查询语言非常强大,其语法有点类似于面向对象的查询语言,几乎可以实现类似关系数据库单表查询的绝大部分功能,而且还支持对数据建立索引。
1.2 MongoDB 的特点
- 面向文档存储: 数据以类似 JSON 的文档形式存储,易于理解和使用。
- 高性能: 采用内存映射文件、索引等技术,提供快速读写性能。
- 高可用性: 支持副本集,实现自动故障转移和数据冗余。
- 可扩展性: 支持分片集群,实现水平扩展,处理海量数据。
- 灵活的数据模型: 无需预定义表结构,可以随时添加或删除字段。
- 丰富的查询语言: 支持强大的查询、聚合和索引功能。
- 易于使用: 提供多种语言的驱动程序和图形化管理工具。
1.3 MongoDB 适用场景
- Web 应用: 存储用户数据、会话信息、产品目录等。
- 移动应用: 存储用户配置、离线数据、日志等。
- 内容管理系统 (CMS): 存储文章、评论、用户信息等。
- 物联网 (IoT): 存储设备数据、传感器数据等。
- 大数据分析: 存储和分析海量数据。
- 实时分析: 存储和分析实时数据流。
2. 下载 MongoDB Community Server
2.1 访问 MongoDB 官网
打开浏览器,访问 MongoDB 官网下载页面:https://www.mongodb.com/try/download/community
2.2 选择版本和操作系统
在下载页面,你会看到以下选项:
- Version: 选择你需要的 MongoDB 版本。通常建议选择最新的稳定版本。
- Platform: 选择你的操作系统(Windows、macOS、Linux 等)。
- Package: 选择安装包类型(通常 Windows 选择
msi
,macOS 选择tgz
,Linux 选择tgz
或对应的包管理器)。
2.3 下载安装包
根据你的选择,点击 "Download" 按钮下载对应的安装包。
3. Windows 系统安装 MongoDB Community Server
3.1 双击安装程序
下载完成后,双击下载的 .msi
安装程序文件。
3.2 安装向导步骤
3.2.1 接受许可协议
阅读并接受 MongoDB 的许可协议。
3.2.2 选择安装类型(完整或自定义)
- Complete (完整): 安装所有 MongoDB 组件,包括 MongoDB Server、MongoDB Shell、MongoDB Compass 等。推荐新手选择此选项。
- Custom (自定义): 可以选择要安装的组件,适合有经验的用户。
3.2.3 服务配置(作为服务运行)
建议勾选 "Install MongoDB as a Service" 选项,将 MongoDB 安装为 Windows 服务。这样 MongoDB 会在后台自动运行,无需手动启动。
- Run service as Network Service user (推荐): 使用 Network Service 用户运行 MongoDB 服务。
- Run service as a local or domain user: 使用本地或域用户运行 MongoDB 服务。
3.2.4 数据目录和日志目录设置
默认情况下,MongoDB 的数据目录和日志目录位于:
- Data Directory:
C:\Program Files\MongoDB\Server\版本号\data
- Log Directory:
C:\Program Files\MongoDB\Server\版本号\log
你可以根据需要修改这些目录。重要提示: 确保所选目录具有足够的磁盘空间,并且 MongoDB 服务用户具有读写权限。
3.2.5 安装 MongoDB Compass(可选)
MongoDB Compass 是一个图形化的 MongoDB 管理工具,可以方便地查看和管理数据库。建议勾选此选项进行安装。
3.3 完成安装
点击 "Install" 按钮开始安装。安装完成后,点击 "Finish" 按钮退出安装向导。
3.4 配置环境变量
为了方便在命令行中使用 MongoDB 命令,需要将 MongoDB 的 bin
目录添加到系统的环境变量中。
- 打开系统属性: 右键点击 "此电脑"(或 "我的电脑"),选择 "属性",然后点击 "高级系统设置"。
- 点击 "环境变量" 按钮。
- 在 "系统变量" 部分,找到名为 "Path" 的变量,双击它。
- 点击 "新建",添加 MongoDB 的
bin
目录路径。 例如:C:\Program Files\MongoDB\Server\版本号\bin
- 点击 "确定" 保存所有更改。
3.5 启动 MongoDB 服务
如果 MongoDB 已经安装为 Windows 服务,它应该会在安装完成后自动启动。你可以在 "服务" 管理器中查看 MongoDB 服务的状态(搜索 "服务" 或运行 services.msc
)。
如果 MongoDB 没有自动启动,你可以手动启动它:
- 以管理员身份打开命令提示符。
- 运行以下命令:
bash
net start MongoDB
3.6 连接 MongoDB Shell
打开新的命令提示符窗口输入mongo
或mongosh
(取决于你的版本)命令就可以连接。
- 打开命令提示符或 PowerShell。
- 输入
mongo
或mongosh
并按回车键。 - 如果一切正常,你将看到 MongoDB Shell 的提示符,表示已成功连接到 MongoDB 服务器。
3.7 验证安装
在命令行连接成功后,可以测试是否正常。
在 MongoDB Shell 中,输入以下命令:
javascript
db.version()
如果显示了 MongoDB 的版本号,则表示安装成功。
4. macOS 系统安装 MongoDB Community Server
4.1 使用 Homebrew 安装(推荐)
Homebrew 是 macOS 上常用的包管理器,使用 Homebrew 安装 MongoDB 非常方便。
4.1.1 安装 Homebrew(如果未安装)
如果你的 macOS 系统还没有安装 Homebrew,请打开终端并运行以下命令:
bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
按照提示完成 Homebrew 的安装。
4.1.2 使用 Homebrew 安装 MongoDB
-
更新 Homebrew:
bash
brew update -
安装 MongoDB:
bash
brew tap mongodb/brew
brew install mongodb-community -
启动 MongoDB 服务:
bash
brew services start mongodb-community
若要停止服务,使用 brew services stop mongodb-community
。
4.2 手动安装
4.2.1 下载安装包
从 MongoDB 官网下载 macOS 版本的 .tgz
安装包。
4.2.2 解压安装包
在终端中,使用 tar
命令解压下载的安装包:
bash
tar -zxvf mongodb-macos-x86_64-*.tgz
将解压后的文件夹移动到你希望安装 MongoDB 的位置,例如 /usr/local/mongodb
。
4.2.3 创建数据目录和日志目录
默认情况下,MongoDB 需要数据目录和日志目录来存储数据和日志。你可以手动创建这些目录:
bash
sudo mkdir -p /data/db
sudo mkdir -p /var/log/mongodb
给这些目录赋予权限:
sudo chown -R `id -un` /data/db
sudo chown -R `id -un` /var/log/mongodb
4.2.4 启动 MongoDB 服务
- 打开一个终端窗口
- 进入解压后目录的bin文件夹中,执行以下命令:
bash
./mongod --dbpath /data/db --logpath /var/log/mongodb/mongod.log --fork
--dbpath
指定数据目录。--logpath
指定日志文件路径。--fork
使MongoDB在后台运行
4.3 验证安装
在 MongoDB Shell 中,输入以下命令:
javascript
db.version()
如果显示了 MongoDB 的版本号,则表示安装成功。
5. Linux (Ubuntu) 系统安装 MongoDB Community Server
5.1 使用 apt 包管理器安装(推荐)
Ubuntu 系统可以使用 apt
包管理器来安装 MongoDB,这是最方便快捷的方法。
5.1.1 导入 MongoDB 公钥
bash
wget -qO - https://www.mongodb.org/static/pgp/server-6.0.asc | sudo apt-key add -
如果提示找不到apt-key
,则可以尝试使用
curl -fsSL https://pgp.mongodb.com/server-6.0.asc | sudo gpg -o /usr/share/keyrings/mongodb-server-6.0.gpg --dearmor
5.1.2 创建 MongoDB 源列表文件
根据你的 Ubuntu 版本,创建对应的源列表文件。例如,对于 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
使用第二种公钥导入方式则:
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-6.0.gpg ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list
5.1.3 更新 apt 包索引
bash
sudo apt-get update
5.1.4 安装 MongoDB
bash
sudo apt-get install -y mongodb-org
安装完成后,MongoDB 服务会自动启动。
5.2 手动安装
5.2.1 下载安装包
从官网下载.tgz
包。
5.2.2 解压安装包
在终端中,使用 tar
命令解压下载的安装包:
bash
tar -zxvf mongodb-linux-x86_64-*.tgz
将解压后的文件夹移动到你希望安装 MongoDB 的位置,例如 /usr/local/mongodb
。
5.2.3 创建数据目录和日志目录
默认情况下,MongoDB 需要数据目录和日志目录来存储数据和日志。你可以手动创建这些目录:
bash
sudo mkdir -p /data/db
sudo mkdir -p /var/log/mongodb
给这些目录赋予权限:
sudo chown -R `id -un` /data/db
sudo chown -R `id -un` /var/log/mongodb
5.2.4启动MongoDB服务
- 打开一个终端窗口
- 进入解压后目录的bin文件夹中,执行以下命令:
bash
./mongod --dbpath /data/db --logpath /var/log/mongodb/mongod.log --fork
--dbpath
指定数据目录。--logpath
指定日志文件路径。--fork
使MongoDB在后台运行
5.3 验证安装
连接 MongoDB Shell。打开终端,输入 mongo
或 mongosh
,如果能成功连接,则表示安装成功。
在 MongoDB Shell 中,输入以下命令:
javascript
db.version()
如果显示了 MongoDB 的版本号,则表示安装成功。
6. 配置 MongoDB (可选)
6.1 配置文件位置
MongoDB 的配置文件通常位于以下位置:
- Windows:
C:\Program Files\MongoDB\Server\版本号\bin\mongod.cfg
(如果使用默认安装路径) - macOS (Homebrew):
/usr/local/etc/mongod.conf
- Linux (apt):
/etc/mongod.conf
6.2 常用配置选项
你可以使用文本编辑器打开配置文件,修改以下常用选项:
6.2.1 net.bindIp
(绑定 IP 地址)
默认情况下,MongoDB 只绑定到本地回环地址 (127.0.0.1),这意味着只能从本地连接 MongoDB。如果你希望允许远程连接,可以将 bindIp
设置为 0.0.0.0
(允许所有 IP 地址连接)或特定的 IP 地址。
警告: 将 bindIp
设置为 0.0.0.0
会将你的 MongoDB 暴露在公网上,存在安全风险。请确保同时启用授权 (security.authorization
) 并设置强密码。
6.2.2 net.port
(端口号)
MongoDB 的默认端口号是 27017。如果需要,你可以修改此端口号。
6.2.3 storage.dbPath
(数据目录)
指定 MongoDB 存储数据的目录。确保此目录具有足够的磁盘空间,并且 MongoDB 服务用户具有读写权限。
6.2.4 systemLog.path
(日志文件路径)
指定 MongoDB 存储日志文件的路径。
6.2.5 security.authorization
(启用授权)
默认情况下,MongoDB 不启用授权,这意味着任何人都可以连接到你的数据库并执行任何操作。为了安全起见,强烈建议启用授权。
将 security.authorization
设置为 enabled
,然后创建 MongoDB 用户和密码。
修改配置文件后,需要重启 MongoDB 服务才能使更改生效。
7. 安装 MongoDB Compass (可选)
MongoDB Compass 是 MongoDB 官方提供的图形化管理工具,可以方便地查看、管理和查询 MongoDB 数据库。
- Windows: 如果在安装 MongoDB 时选择了安装 MongoDB Compass,它应该已经安装好了。你可以在开始菜单中找到它。
- macOS: 可以从 MongoDB 官网下载 MongoDB Compass 的安装包,或者使用 Homebrew 安装:
bash
brew install --cask mongodb-compass - Linux: 可以从 MongoDB 官网下载 MongoDB Compass 的安装包。
安装完成后,打开 MongoDB Compass,输入 MongoDB 服务器的连接信息(主机名、端口号、用户名、密码等),即可连接到你的 MongoDB 数据库。
8. 常见问题解答 (FAQ)
8.1 如何停止 MongoDB 服务?
- Windows:
- 在 "服务" 管理器中找到 MongoDB 服务,右键点击并选择 "停止"。
- 或者在管理员命令提示符中运行:
net stop MongoDB
- macOS (Homebrew):
bash
brew services stop mongodb-community - Linux (apt):
bash
sudo systemctl stop mongod
或者
bash
sudo service mongod stop
8.2 如何卸载 MongoDB?
- Windows:
- 在 "控制面板" -> "程序和功能" 中找到 MongoDB,右键点击并选择 "卸载"。
- 删除 MongoDB 的安装目录、数据目录和日志目录。
- macOS (Homebrew):
bash
brew uninstall mongodb-community
rm -rf /usr/local/var/mongodb - Linux (apt):
bash
sudo apt-get purge mongodb-org
sudo rm -rf /var/log/mongodb
sudo rm -rf /var/lib/mongodb
8.3 如何升级 MongoDB?
升级 MongoDB 的步骤通常包括:
- 备份数据。
- 停止旧版本的 MongoDB 服务。
- 安装新版本的 MongoDB。
- 启动新版本的 MongoDB 服务。
- (可选)运行升级脚本。
具体步骤请参考 MongoDB 官方文档中关于升级的说明。
8.4 如何查看 MongoDB 版本?
在 MongoDB Shell 中,输入以下命令:
javascript
db.version()
或者在命令行中输入:
bash
mongod --version
或
mongosh --version
8.5 如何备份和恢复 MongoDB 数据?
MongoDB 提供了 mongodump
和 mongorestore
工具来备份和恢复数据。
- 备份:
bash
mongodump --host <hostname> --port <port> --username <username> --password <password> --db <database> --out <backup_directory> - 恢复:
bash
mongorestore --host <hostname> --port <port> --username <username> --password <password> --db <database> <backup_directory>
8.6 遇到连接问题怎么办?
- 检查 MongoDB 服务是否正在运行。
- 检查防火墙设置是否允许 MongoDB 的端口(默认为 27017)的连接。
- 检查
mongod.conf
配置文件中的net.bindIp
设置是否正确。 - 如果启用了授权,检查用户名和密码是否正确。
8.7 如何设置 MongoDB 用户和密码?
- 连接到 MongoDB Shell(不使用用户名和密码)。
- 切换到
admin
数据库:
javascript
use admin - 创建管理员用户:
javascript
db.createUser({
user: "admin",
pwd: "your_strong_password",
roles: [
{ role: "userAdminAnyDatabase", db: "admin" },
{ role: "readWriteAnyDatabase", db: "admin" }
]
}) - 退出 MongoDB Shell。
- 编辑
mongod.conf
配置文件,启用授权:
security:
authorization: enabled - 重启 MongoDB 服务。
- 使用用户名和密码连接到 MongoDB Shell:
bash
mongo -u admin -p your_strong_password --authenticationDatabase admin
或者
mongosh -u admin -p your_strong_password --authenticationDatabase admin
9. 总结
本教程详细介绍了在 Windows、macOS 和 Linux (Ubuntu) 系统上下载和安装 MongoDB Community Server 的步骤,包括安装前的准备、安装过程、配置选项、常见问题解答等。希望本教程能帮助你成功安装和使用 MongoDB。如果你在使用过程中遇到任何问题,可以参考 MongoDB 官方文档或在社区寻求帮助。记住,在生产环境中部署 MongoDB 时,务必采取适当的安全措施,例如启用授权、设置强密码、配置防火墙等。