MongoDB 完整下载安装教程:从零开始,一步步指引
引言
在当今数据驱动的世界里,数据库是构建几乎所有应用程序的基础。而在众多数据库类型中,NoSQL 数据库因其灵活的数据模型和高可扩展性而备受青睐。MongoDB 作为最流行的文档型 NoSQL 数据库之一,广泛应用于Web开发、大数据、移动应用等领域。
如果你是一位开发者、数据工程师或者仅仅对数据库技术感兴趣,学习和使用 MongoDB 是一个非常好的选择。而踏出第一步,就是成功地下载并安装它。
本教程旨在提供一个全面、详细的 MongoDB 下载安装指南。我们将覆盖主流操作系统(Windows、macOS、Linux)的安装方法,解释关键概念,并指导你完成安装后的基本验证。无论你是数据库新手还是有经验的工程师,希望本指南都能帮助你顺利搭建起 MongoDB 环境。
注意: MongoDB 的版本更新较快,官方的安装步骤可能会有微小调整。本教程基于撰写时的最新稳定版(通常是当前的 LTS 版本或较新的通用可用版本)提供指引。在安装前,强烈建议访问 MongoDB 官方文档 查看对应你所选择版本和操作系统的最新、最权威的安装说明。
为何选择下载安装 MongoDB?
MongoDB 提供了多种使用方式:
- MongoDB Atlas: MongoDB 官方提供的云数据库服务,完全托管,无需自己管理服务器,易于扩展和维护。适合生产环境和快速开发。
- 下载并自托管 (Self-Hosted): 将 MongoDB 安装在自己的服务器、虚拟机或本地计算机上。适合学习、开发、测试以及对环境有特殊控制需求的场景。
本教程专注于第二种方式——下载并安装 MongoDB 到你的本地机器或服务器。选择这种方式的好处在于:
- 完全控制: 你可以完全控制数据库的环境、配置和数据。
- 无成本(社区版): MongoDB Community Edition(社区版)是免费使用的,适合学习、开发和大多数非企业级应用。
- 离线开发/学习: 无需网络连接即可在本地进行开发和测试。
- 深入理解: 通过手动安装和配置,你能更深入地理解 MongoDB 的运行机制。
准备工作
在开始下载安装之前,请确保你满足以下条件:
- 操作系统: 确认你的操作系统版本。MongoDB 官方支持特定版本的 Windows、macOS 和多种 Linux 发行版。请查阅官方文档确认你的系统版本是否受支持。
- 系统要求: 确保你的计算机有足够的内存(RAM)、硬盘空间和处理能力。对于学习和开发,通常要求不高;但对于生产环境,则需要根据数据量和负载进行评估。
- 网络连接: 下载安装包或使用包管理器时需要稳定的网络连接。
- 管理员权限: 安装软件通常需要管理员权限。
- 文本编辑器: 用于编辑配置文件(如需)。
- 命令行终端: 需要使用命令行执行安装和管理命令。
MongoDB 版本选择:Community vs. Enterprise
MongoDB 提供两个主要版本:
- Community Edition(社区版): 免费、开源,包含 MongoDB 的核心功能。适用于大多数通用用途,如Web应用、数据存储、开发测试等。
- Enterprise Edition(企业版): 在社区版基础上增加了更多针对企业需求的功能,如高级安全特性(LDAP/Kerberos 认证)、更强大的监控工具、加密存储引擎、商业支持等。通常需要购买许可。
对于初学者、个人开发者或中小型项目,选择 Community Edition 就足够了。本教程也将主要基于社区版进行讲解。
此外,MongoDB 遵循版本号规则,并会标记 LTS (Long Term Support) 版本。对于生产环境,通常推荐使用 LTS 版本,因为它会获得更长时间的支持和维护。学习和开发可以选择最新的通用版本,以体验新特性。
下载方法概述
下载 MongoDB 二进制文件或安装程序主要有几种方式:
- 从 MongoDB 官方下载中心下载: 这是最直接的方式,你可以选择操作系统、版本和对应的安装包类型(如
.msi
文件 for Windows,.tgz
压缩包 for Linux/macOS)。 - 使用操作系统自带的包管理器: 在 Linux 和 macOS 上,这是更推荐的方式。例如,在 Ubuntu/Debian 上使用
apt
,在 RHEL/CentOS/Fedora 上使用yum
或dnf
,在 macOS 上使用 Homebrew。通过包管理器安装更方便管理、更新和依赖。 - 使用 Docker: 将 MongoDB 运行在 Docker 容器中。这提供了一种轻量级、可移植的部署方式,特别适合开发和测试环境。
接下来,我们将详细讲解每种操作系统下通过官方下载中心和包管理器(如果适用)的安装步骤。
分平台详细安装教程
1. 在 Windows 上安装 MongoDB Community Edition
在 Windows 上安装 MongoDB 最简单的方法是使用官方提供的 MSI 安装程序。
步骤 1:前往 MongoDB 官方下载中心
打开浏览器,访问 MongoDB 官方下载中心页面:https://www.mongodb.com/try/download/community
步骤 2:选择版本、操作系统和包类型
- 在 “Version” 下拉菜单中,选择你想要安装的 MongoDB 版本。推荐选择最新的 GA (General Availability) 版本或 LTS 版本。
- 在 “OS” 下拉菜单中,选择 “Windows”。
- 在 “Package” 下拉菜单中,选择 “msi”。
- 确认选择的是 “Community Server”。
步骤 3:下载 MSI 安装程序
点击 “Download” 按钮,下载 MongoDB 的 MSI 安装文件。文件大小通常在几百 MB。
步骤 4:运行 MSI 安装程序
找到下载的 .msi
文件,双击运行它。
- 欢迎界面: 点击 “Next”。
- 最终用户许可协议: 阅读并接受许可协议,勾选 “I accept the terms in the License Agreement”,然后点击 “Next”。
- 安装类型选择: 你会看到 “Complete”(完整安装)和 “Custom”(自定义安装)两个选项。
- Complete (推荐初学者): 安装所有组件到默认路径。
- Custom: 允许你选择安装组件和安装路径。如果你对安装路径有特定要求,可以选择此项,然后点击 “Next”。在组件选择界面,通常保持默认即可,点击 “Next”。选择安装路径,点击 “Browse” 修改,然后点击 “Next”。
- 服务配置: 这是 Windows 安装中最关键的一步。
- 勾选 “Install MongoDB as a Service”(将 MongoDB 安装为服务)。这会让 MongoDB 在系统启动时自动运行,并在后台持续运行。
- 选择 “Run Service as Network Service user” (使用网络服务用户运行服务)。这是默认且推荐的选项,它拥有运行 MongoDB 服务所需的最低权限。
- Data Directory 和 Log Directory: 这里显示 MongoDB 数据文件和日志文件的默认存放路径。默认通常是
C:\Program Files\MongoDB\Server\<version>\data
和C:\Program Files\MongoDB\Server\<version>\log
。强烈建议将这些路径修改到系统盘以外的分区,以避免系统盘空间不足或重装系统时数据丢失。点击 “Browse” 选择或手动输入路径。例如,你可以创建D:\mongodb\data
和D:\mongodb\log
。重要: 确保运行服务的用户(通常是 Network Service)对这些目录有读写权限。如果安装后服务无法启动,这通常是原因之一。
- 安装 MongoDB Compass: MongoDB Compass 是一个官方提供的图形化管理工具,非常方便。勾选 “Install MongoDB Compass”。点击 “Next”。
- 准备安装: 点击 “Install”。
- 用户账户控制: 如果弹出用户账户控制(UAC)提示,点击 “是” 允许安装。
- 安装过程: 等待安装完成。这可能需要几分钟。
- 完成安装: 点击 “Finish”。
5. (可选但推荐)将 MongoDB Bin 目录添加到系统 PATH 环境变量
将 MongoDB 的 bin
目录添加到系统 PATH 环境变量后,你可以在任何命令行窗口中直接输入 mongod
或 mongosh
命令,而无需进入到安装目录。
- 搜索 “环境变量” 或 “Environment Variables”,打开 “编辑系统环境变量”。
- 在 “系统属性” 窗口中,点击底部的 “环境变量” 按钮。
- 在 “系统变量” 区域找到名为 “Path” 的变量,选中它,然后点击 “编辑”。
- 在编辑 Path 环境变量的窗口中,点击 “新建”。
- 输入 MongoDB
bin
目录的完整路径。如果你使用的是默认安装路径,它可能是C:\Program Files\MongoDB\Server\<version>\bin
(将<version>
替换为你安装的版本号,例如6.0
)。如果你自定义了安装路径,找到该路径下的bin
文件夹。 - 点击 “确定” 关闭所有打开的环境变量窗口。
- 重要: 新的环境变量设置只会在新的命令行窗口中生效。请关闭所有已打开的命令行窗口,重新打开一个新的命令提示符或 PowerShell 窗口。
6. 启动和停止 MongoDB 服务
如果你在安装时选择了 “Install MongoDB as a Service”,服务应该已经自动启动。
- 检查服务状态: 搜索 “服务” 或 “Services”,打开服务管理工具。找到名为 “MongoDB” 的服务,查看其状态是否为 “正在运行”。
- 启动服务: 如果服务未运行,右键点击 “MongoDB” 服务,选择 “启动”。
- 停止服务: 右键点击 “MongoDB” 服务,选择 “停止”。
- 使用命令行启动/停止(需要管理员权限的命令提示符/PowerShell):
- 启动:
net start MongoDB
- 停止:
net stop MongoDB
- 启动:
7. 连接到 MongoDB
安装包中包含了 mongosh
,这是 MongoDB 官方的命令行 Shell。
- 打开一个新的命令提示符或 PowerShell 窗口。
- 输入命令:
mongosh
- 如果一切正常,你应该会看到
mongosh
的欢迎信息和连接提示符(默认为test>
)。这意味着你已经成功连接到本地运行的 MongoDB 数据库了。 - 输入
exit
退出 shell。
如果在安装过程中遇到问题(例如服务无法启动):
- 检查 Data Directory 和 Log Directory 的路径是否存在,并且当前用户或 Network Service 用户有权访问。
- 查看 Log Directory 中的日志文件(通常是
mongod.log
),其中会包含启动失败的具体原因。 - 确保没有其他程序占用了默认的 MongoDB 端口 27017。
至此,你已经在 Windows 上成功安装并运行了 MongoDB。
2. 在 macOS 上安装 MongoDB Community Edition
在 macOS 上安装 MongoDB 最推荐和便捷的方式是使用 Homebrew 包管理器。
步骤 1:安装 Homebrew(如果尚未安装)
Homebrew 是 macOS 上一个非常流行的包管理器。打开终端应用程序(可以通过 Spotlight 搜索 “Terminal” 打开),然后运行以下命令安装 Homebrew:
bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
按照终端提示完成安装。安装完成后,根据提示运行 brew doctor
检查安装是否成功。
步骤 2:通过 Homebrew 安装 MongoDB
Homebrew 的主仓库不直接包含 MongoDB,需要先“tap”一个 MongoDB 的仓库。
- Tap MongoDB Homebrew 仓库:
bash
brew tap mongodb/brew - 安装 MongoDB Community Edition:
bash
brew install mongodb-community@<版本号>
将<版本号>
替换为你想安装的具体版本,例如6.0
。如果你想安装最新版本且不关心具体小版本号,可以只写主版本号。Homebrew 会安装该版本下的最新维护版本。例如:
bash
brew install [email protected]
如果你只想安装最新版本,不指定版本号也可以,但建议指定以避免意外升级导致不兼容:
bash
brew install mongodb-community # 安装最新版本,但不推荐长期依赖
Homebrew 会自动下载并安装 MongoDB Server (mongod
) 和 Shell (mongosh
) 等工具。
3. 启动 MongoDB
使用 Homebrew 安装的 MongoDB 通常会安装在 /usr/local/var/mongodb
或 /opt/homebrew/var/mongodb
路径(取决于你的 Mac 架构和 Homebrew 安装位置),数据文件默认会放在这里。
使用 Homebrew Service 管理 MongoDB 服务非常方便:
- 以前台模式启动 (用于测试/调试):
bash
mongod --config /usr/local/etc/mongod.conf # 默认配置文件路径,可能因版本或安装方式有微小差异
或直接运行mongod
,它会尝试在/data/db
寻找数据目录(如果存在且有权限)。通常 Homebrew 安装的服务配置会指向 Homebrew 管理的数据路径。 - 以后台服务模式启动 (推荐):
bash
brew services start mongodb-community@<版本号>
例如:
bash
brew services start [email protected]
这将把 MongoDB 注册为后台服务,并在启动时自动运行。 - 检查服务状态:
bash
brew services list
查找mongodb-community@<版本号>
,查看其状态是否是started
。 - 停止服务:
bash
brew services stop mongodb-community@<版本号> - 重启服务:
bash
brew services restart mongodb-community@<版本号>
4. 连接到 MongoDB
安装包中已经包含了 mongosh
。
- 打开终端。
- 输入命令:
mongosh
- 如果 MongoDB 服务正在运行,你应该会成功连接到本地数据库,并看到
mongosh
的欢迎信息和提示符。 - 输入
exit
退出 shell。
如果遇到问题:
- 确保 MongoDB 服务已经启动 (
brew services list
查看状态)。 - 检查 Homebrew 给出的安装后提示信息,可能会包含重要配置路径或启动命令。
- 查看 MongoDB 的日志文件,通常位于 Homebrew 安装路径下的
var/log/mongodb/mongo.log
或/usr/local/var/log/mongodb/mongo.log
。 - 确保没有其他程序占用了默认的 MongoDB 端口 27017。
至此,你已经在 macOS 上成功安装并运行了 MongoDB。
3. 在 Linux 上安装 MongoDB Community Edition
在 Linux 上,使用包管理器是安装 MongoDB 的标准和最方便的方法。MongoDB 官方为主要的 Linux 发行版提供了专门的软件仓库。这里以 Ubuntu/Debian 和 RHEL/CentOS/Fedora 为例。
重要: 具体命令和仓库地址可能会随着 MongoDB 版本和 Linux 发行版版本的不同而变化。务必参考 MongoDB 官方文档中针对你的具体 Linux 版本和 MongoDB 版本的安装指南。 下面的步骤是通用流程和示例命令。
通用前置步骤 (检查系统架构)
MongoDB 社区版通常只支持 x86_64 (amd64) 架构。一些版本可能也支持 ARM64 (arm64)。在安装前,可以使用 dpkg --print-architecture
(Debian/Ubuntu) 或 arch
(RHEL/CentOS/Fedora) 来确认你的系统架构。
方法 A: 在 Ubuntu/Debian 上使用 apt 安装
这些步骤需要在终端中以 root 用户或使用 sudo
执行。
-
导入 MongoDB 公钥: 需要从 MongoDB 官方导入软件仓库的 GPG 公钥,以验证下载的包是合法的。
- 对于 Ubuntu 20.04+ / Debian 11+ (推荐使用新的
apt-key add
替代方法):
bash
curl -fsSL https://pgp.mongodb.com/server-6.0.asc | \
sudo gpg --dearmor -o /usr/share/keyrings/mongodb-archive-keyring.gpg
(将server-6.0.asc
替换为你所需版本的对应 key 文件名) - 对于较旧的 Ubuntu/Debian 版本 (使用
apt-key add
):
bash
wget -qO - https://www.mongodb.org/static/pgp/server-6.0.asc | sudo apt-key add -
(将server-6.0.asc
替换为你所需版本的对应 key 文件名) - 成功后会返回
OK
。
- 对于 Ubuntu 20.04+ / Debian 11+ (推荐使用新的
-
为 MongoDB 创建列表文件: 这个文件告诉
apt
去哪里找 MongoDB 的软件包。- 根据你的 Ubuntu/Debian 版本和 MongoDB 版本,创建
/etc/apt/sources.list.d/mongodb-org-6.0.list
文件(将6.0
替换为你的 MongoDB 版本)。内容格式如下(请参考官方文档获取确切的仓库地址):
bash
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-archive-keyring.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
解释:focal
:替换为你的 Ubuntu 版本代号 (如bionic
,focal
,jammy
) 或 Debian 版本代号 (如buster
,bullseye
)。6.0
:替换为你的 MongoDB 版本。[ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-archive-keyring.gpg ]
:指定支持的架构和用于签名的 keyring 文件。- 请务必查阅 MongoDB 官方文档,获取与你的操作系统版本和 MongoDB 版本完全匹配的仓库地址和配置字符串。
- 根据你的 Ubuntu/Debian 版本和 MongoDB 版本,创建
-
更新本地包数据库:
bash
sudo apt update -
安装 MongoDB 包:
mongodb-org
是一个“元包”,安装它会自动安装以下组件:mongod
(数据库服务器),mongosh
(Shell),mongos
(分片路由器), 以及其他一些客户端工具。
bash
sudo apt install mongodb-org
如果你想安装特定版本的 MongoDB,可以使用=<版本号>
语法,例如:
bash
sudo apt install mongodb-org=6.0.5 mongodb-org-server=6.0.5 mongodb-org-shell=6.0.5 mongodb-org-mongos=6.0.5 mongodb-org-tools=6.0.5
但通常直接安装mongodb-org
包会安装仓库中该分支的最新版本。
方法 B: 在 RHEL/CentOS/Fedora 上使用 yum 或 dnf 安装
这些步骤需要在终端中以 root 用户或使用 sudo
执行。
-
创建 .repo 文件: 这个文件告诉
yum
或dnf
去哪里找 MongoDB 的软件包。- 在
/etc/yum.repos.d/
(RHEL/CentOS) 或/etc/dnf/repos.d/
(Fedora) 目录下创建一个名为mongodb-org-6.0.repo
的文件(将6.0
替换为你的 MongoDB 版本)。 - 使用文本编辑器(如
nano
或vim
)编辑该文件:
bash
sudo nano /etc/yum.repos.d/mongodb-org-6.0.repo - 将以下内容复制到文件中(请根据你的 RHEL/CentOS/Fedora 版本和 MongoDB 版本查阅官方文档获取确切内容):
ini
[mongodb-org-6.0]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/6.0/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-6.0.asc
解释:$releasever
:这是一个变量,yum
或dnf
会自动替换为你当前系统的主要版本号(例如 7 或 8 for CentOS/RHEL, 37 or 38 for Fedora)。6.0
:替换为你的 MongoDB 版本。x86_64
:系统架构。gpgkey
:MongoDB 公钥地址。- 请务必查阅 MongoDB 官方文档,获取与你的操作系统版本和 MongoDB 版本完全匹配的
.repo
文件内容。
- 保存并关闭文件。
- 在
-
安装 MongoDB 包:
- 使用 yum (RHEL/CentOS):
bash
sudo yum install mongodb-org
同样,也可以指定特定版本:
bash
sudo yum install mongodb-org-6.0.5 mongodb-org-server-6.0.5 mongodb-org-shell-6.0.5 mongodb-org-mongos-6.0.5 mongodb-org-tools-6.0.5 - 使用 dnf (Fedora 22+ / RHEL 8+):
bash
sudo dnf install mongodb-org
指定特定版本:
bash
sudo dnf install mongodb-org-6.0.5 mongodb-org-server-6.0.5 mongodb-org-shell-6.0.5 mongodb-org-mongos-6.0.5 mongodb-org-tools-6.0.5 - 在安装过程中,可能会提示你确认导入 GPG 密钥,输入
y
并回车。
- 使用 yum (RHEL/CentOS):
Linux 安装后的通用步骤:启动和管理 MongoDB 服务
通过包管理器安装的 MongoDB 通常会安装在标准路径,并使用 systemd
或 SysVinit
进行服务管理。数据文件通常默认在 /var/lib/mongodb
,日志文件在 /var/log/mongodb
。
-
启动 MongoDB 服务:
bash
sudo systemctl start mongod
(如果你的系统使用 SysVinit,命令可能是sudo service mongod start
) -
验证服务是否正在运行:
bash
sudo systemctl status mongod
你应该会看到服务状态显示为active (running)
。 -
设置 MongoDB 开机自启动:
bash
sudo systemctl enable mongod -
停止服务:
bash
sudo systemctl stop mongod -
重启服务:
bash
sudo systemctl restart mongod
连接到 MongoDB
安装包中已经包含了 mongosh
。
- 打开终端。
- 输入命令:
mongosh
- 如果 MongoDB 服务正在运行,你应该会成功连接到本地数据库,并看到
mongosh
的欢迎信息和提示符。 - 输入
exit
退出 shell。
如果遇到问题:
- 检查防火墙设置。默认情况下,MongoDB 使用端口 27017。你需要确保防火墙允许连接到这个端口(特别是如果你是从远程连接)。例如,使用
ufw
(sudo ufw allow 27017
) 或firewalld
(sudo firewall-cmd --zone=public --add-port=27017/tcp --permanent
,sudo firewall-cmd --reload
)。 - 检查
/var/lib/mongodb
和/var/log/mongodb
目录的权限。运行mongod
服务的用户(通常是mongodb
用户)需要对这些目录有读写权限。 - 查看日志文件
/var/log/mongodb/mongod.log
,其中会包含启动失败的具体原因。 - 确保SELinux(如果在 RHEL/CentOS 上启用)没有阻止 mongod 进程。可能需要调整 SELinux 策略。
至此,你已经在 Linux 上成功安装并运行了 MongoDB。
4. 使用 Docker 安装和运行 MongoDB
使用 Docker 运行 MongoDB 提供了一种隔离的环境,易于启动、停止和清理。
- 安装 Docker: 确保你的系统上已经安装了 Docker Desktop (Windows/macOS) 或 Docker Engine (Linux)。请参考 Docker 官方文档进行安装。
- 拉取 MongoDB 镜像: 打开终端或命令提示符,运行以下命令拉取官方的 MongoDB Community 镜像:
bash
docker pull mongo
如果你需要特定版本的 MongoDB,可以指定标签:
bash
docker pull mongo:6.0 -
运行 MongoDB 容器: 运行以下命令创建一个并启动一个 MongoDB 容器:
bash
docker run --name my-mongo -p 27017:27017 -d mongo
解释:--name my-mongo
: 给容器指定一个名字(你可以换成你喜欢的名字)。-p 27017:27017
: 将容器内部的 27017 端口映射到主机的 27017 端口,这样你就可以从主机连接到容器里的 MongoDB。-d
: 让容器在后台运行(detached mode)。mongo
: 使用刚刚拉取的mongo
镜像。
重要: 上述命令的数据是存储在容器内部的,如果容器被删除,数据就会丢失。在生产环境或需要持久化数据的场景,应该使用 Docker 数据卷(Volumes)来存储数据:
“`bash
创建一个数据卷 (只需要创建一次)
docker volume create mongo-data
运行容器,并将数据卷挂载到容器的数据目录
docker run –name my-mongo-persistent -p 27017:27017 -d -v mongo-data:/data/db mongo
这样,即使容器被删除,数据卷仍然保留,下次创建新容器并挂载同一个数据卷时,数据会得以恢复。
bash
4. **连接到 MongoDB 容器:**
* **使用主机上的 mongosh (如果你已经在主机上安装了 mongosh):**
mongosh –port 27017
(如果映射到其他端口,请修改 `--port`)
bash
* **在容器内部使用 mongosh:** 如果你的主机没有安装 `mongosh`,或者你想在容器内部操作:
docker exec -it my-mongo mongosh
``
my-mongo` 替换为你容器的名字)
(将 -
管理 Docker 容器:
- 查看正在运行的容器:
docker ps
- 停止容器:
docker stop my-mongo
- 启动容器:
docker start my-mongo
- 删除容器:
docker rm my-mongo
(在删除前通常需要先停止容器)
- 查看正在运行的容器:
使用 Docker 运行 MongoDB 非常灵活,但它与直接安装到操作系统有一些概念上的不同,需要熟悉 Docker 的基本操作。
安装后验证与基本使用
无论你使用哪种方法安装了 MongoDB,都应该进行一些基本验证来确认安装成功,并且可以连接到数据库。
-
验证
mongod
命令是否可用:- 打开一个新的终端或命令提示符。
- 输入
mongod --version
并回车。 - 如果命令被找到并显示了 MongoDB Server 的版本信息,说明
mongod
可执行文件已经正确安装并且在你的 PATH 中(或者你在其安装目录下执行)。 - 如果你安装的是 Windows 服务或使用
systemctl
/brew services
启动,你可能不需要直接运行mongod
命令,但验证其版本仍然是有用的。
-
验证
mongosh
命令是否可用:- 打开一个新的终端或命令提示符。
- 输入
mongosh --version
并回车。 - 如果命令被找到并显示了 mongosh Shell 的版本信息,说明
mongosh
可执行文件也已经正确安装并且在你的 PATH 中。
-
连接到 MongoDB 数据库:
- 确保 MongoDB Server (
mongod
) 正在运行(检查 Windows 服务状态,或使用systemctl status mongod
,brew services list
,docker ps
)。 - 打开一个新的终端或命令提示符。
- 输入
mongosh
并回车(如果连接到本地默认端口 27017)。 - 如果你连接到不同主机或端口,使用
mongosh "mongodb://<主机名>:<端口>"
命令。例如mongosh "mongodb://localhost:27018"
。 -
成功连接后,你会看到类似以下的提示符:
“`
Current Mongosh version: 2.0.1
Using MongoDB: 6.0.5
Using Mongosh API version: 1For interactive help, type “help”.
test>
``
test>
* 在提示符下,可以输入一些简单的命令来确认数据库可用,例如:
db.version()
*:显示当前数据库版本。
show dbs
*:显示所有数据库。
use mydatabase
*:切换或创建一个名为
mydatabase的数据库。
db.mycollection.insertOne({ name: “Test Document” })
*:插入一个文档(如果
mydatabase或
mycollection不存在会自动创建)。
db.mycollection.find()
*:查找集合中的文档。
exit
* 输入退出
mongosh`。
- 确保 MongoDB Server (
-
检查日志文件: 如果 MongoDB 服务启动失败,查看日志文件是诊断问题的最直接方法。
- Windows: 安装时指定的日志路径下的
mongod.log
。 - macOS (Homebrew): 通常在
/usr/local/var/log/mongodb/mongo.log
或/opt/homebrew/var/log/mongodb/mongo.log
。 - Linux: 通常在
/var/log/mongodb/mongod.log
。 - Docker: 使用
docker logs <容器ID或名称>
命令查看容器日志。
- Windows: 安装时指定的日志路径下的
重要注意事项
- 安全性: 默认安装的 MongoDB 通常没有启用身份验证,这意味着任何能够连接到服务器(默认为 localhost)的人都可以完全访问数据库。在生产环境或任何公开网络可访问的环境中,务必启用身份验证并配置用户角色! 这是非常关键的安全步骤,本下载安装教程不包含详细的安全配置,请务必查阅官方文档进行设置。
- 配置文件: MongoDB 服务器 (
mongod
) 的行为可以通过配置文件进行控制。Windows 服务安装和 Linux 包管理器安装通常会创建一个默认的配置文件(例如 Linux 上的/etc/mongod.conf
)。你可以编辑这个文件来修改端口、数据/日志路径、绑定 IP 地址、存储引擎选项等。修改配置文件后,通常需要重启mongod
服务才能生效。 - 绑定 IP 地址: 默认情况下,MongoDB 可能只绑定到本地回环地址 (
127.0.0.1
),这意味着你只能从安装 MongoDB 的同一台机器上连接。如果你需要从其他机器连接,需要修改配置文件中的bindIp
参数,将其设置为服务器的实际 IP 地址或0.0.0.0
(表示绑定所有可用 IP 地址,但请注意安全风险)。修改后需要重启服务。 - 升级: MongoDB 提供了升级指南。在升级时,特别是跨主要版本升级,务必仔细阅读官方的升级文档,遵循建议的步骤和兼容性说明,并进行充分的备份。
常见问题及解决
mongod
或mongosh
命令找不到: 确保你已经将 MongoDBbin
目录添加到了系统的 PATH 环境变量中,并且在修改后重启了终端或命令提示符。或者直接切换到 MongoDBbin
目录执行命令。- 服务无法启动:
- 查看日志文件 (
mongod.log
) 获取详细错误信息。 - 检查数据目录 (
/data/db
或你在配置文件中指定的路径) 和日志目录是否存在,并且运行mongod
进程的用户(Windows 上的 Network Service, Linux 上的mongodb
用户)对这些目录有读写权限。 - 检查端口 27017 是否被其他程序占用。
- 检查配置文件路径是否正确,文件内容是否有误。
- 在 Linux 上,检查 SELinux 或防火墙设置。
- 查看日志文件 (
mongosh
无法连接:- 确保
mongod
服务正在运行。 - 检查连接字符串中的主机名和端口是否正确。
- 确认防火墙允许连接到 MongoDB 端口(默认为 27017)。
- 检查 MongoDB 服务绑定的 IP 地址 (
bindIp
配置) 是否允许来自你尝试连接的机器的连接。
- 确保
结论
恭喜你!通过按照本教程的步骤,你应该已经成功地在你的计算机上下载并安装了 MongoDB Community Edition,并学会了基本的启动、停止和连接方法。
安装只是第一步。接下来,你可以开始学习 MongoDB 的基本操作:
- 使用
mongosh
进行 CRUD (创建、读取、更新、删除) 操作。 - 学习 MongoDB 的数据模型和模式设计。
- 了解索引、聚合、复制集和分片等高级概念。
- 学习如何使用各种编程语言的 MongoDB 驱动程序来开发应用程序。
MongoDB 是一个强大而灵活的数据库,潜力巨大。持续的学习和实践是掌握它的关键。祝你在探索 MongoDB 的旅程中一切顺利!