MongoDB安装教程(Windows平台,图文并茂)
在 Windows 系统上安装 MongoDB,首先需要确定自己的 Windows 系统版本以及 MongoDB 社区版所支持的系统版本。这里使用的是 Windows 10 操作系统和 MongoDB 8.0.4 版本。
由于 MongoDB 6 版本之后不再默认安装 Mongo Shell,因此本节分为两部分,安装 MongoDB 和安装 MongoDB Shell。
1) 打开MongoDB官网的下载页面,地址为 https://www.mongodb.com/try/download/community。单击 Select Package 显示版本选择界面。在 Version 下拉列表中选择版本 8.0.4,在 Platform 下拉列表中选择 Windows X64 操作系统,安装包格式选择 msi,单击 Download 按钮,开始下载,如下图所示。

图 1 MongoDB下载页面
2) 下载完成之后,双击 .msi 安装包文件开始安装。在安装过程中会弹出安装向导界面,指导使用者安装 MongoDB 以及 MongoDB 的可视化工具 MongoDB Compass。安装包运行后,界面如下图所示:

图 2 开始安装MongoDB
3) 安装向导提示当前安装的 MongoDB 版本信息,如下图所示,单击 Next 按钮。

图 3 进入MongoDB安装向导
4) 接受当前的终端用户安装协议,选中同意协议的复选框(I accept the terms in the License Agreement),单击 Next 按钮,如下图所示。

图 4 MongoDB安装协议
5) 选择安装类型,MongoDB 支持完整安装和个性化安装。个性化安装方式支持选择所需要的安装组件,同时也支持自定义 MongoDB 的安装路径。官方推荐的是完整安装。对于初学者或对 MongoDB 使用不熟练的使用者,建议默认完整安装。此方式会将 MongoDB 安装在路径 C:\Program Files\MongoDB\Server\8.0 下。选择 Complete 安装类型后,单击 Next 按钮,如下图所示。

图 5 选择安装类型
6) 配置服务,从 4.0 版本开始,MongoDB 可以配置为一项 Windows 服务。在这个步骤中,可以选择将 MongoDB 作为 Windows 的一个系统服务,如下图所示。

图 6 配置MongoDB服务
在这个界面中,可以配置服务的名称,一般默认为 MongoDB,同时配置 MongoDB 的数据目录和日志目录。配置完成后,单击 Next 按钮。如果这里不将 MongoDB 配置为 Windows 的服务,可以手动启动,具体可以查看后面关于手动启动 MongoDB 实例的内容。
7) 安装可视化工具 MongoDB Compass。这里为可选项,既可以安装,也可以不安装。这里选中进行安装,单击 Next 按钮进入下一步,如下图所示。

图 7 选择安装可视化工具
8) 进入安装进程。上述所有配置完成,单击 Install 按钮进入安装进程,如下图所示:

图 8 进入安装进程
等待安装进程进行。整个过程可能会持续较长时间,与所使用的计算机配置有关,不同配置耗费的时间有所不同,耐心等待即可,如下图所示。

图 9 安装进行中
安装进程结束,完成 MongoDB 和 MongoDB Compass 的安装。单击 Finish 按钮,退出安装进程,如下图所示。

图 10 安装完成
如果将 MongoDB 作为服务安装,那么安装结束后,会自动开启服务。要查看 MongoDB 服务的状态,可以打开系统服务界面,按 Ctrl + Shift + Esc 组合键,打开任务管理器,切换到“服务”选项卡,或者直接通过 Windows 系统的搜索找到“服务”界面,在“服务”界面中找到 MongoDB 服务,查看服务是否正在运行。在服务名称上右击,可以选择开启或停止该服务,如下图所示。

图 11 “服务”界面
或者打开浏览器访问 https://localhost:27017,如下图所示:

图 12 在浏览器中访问MongoDB
同样,也可以通过命令查看 MongoDB 服务的状态,开启或停止 MongoDB 服务。命令如下:

图 13 查看MongoDB服务的状态
如果不作为服务安装,那么需要手动启动 MongoDB 实例,这里需要用到 mongod 命令。该命令在 MongoDB 安装目录下的 bin 文件夹(D:\MongoDB\Server\8.0\bin)下。启动时,需要配置数据目录,例如 D:\MongoDB\data,如下图所示。

图 14 mongod启动服务
MongoDB 启动后,该数据目录会生成一些数据库文件,如下图所示:

图 15 MongoDB的data目录
在 bin 目录下,存在一些关键文件,如下图所示:

图 16 MongoDB的bin目录
其中,mongod.exe 用来启动 MongoDB 服务,mongos.exe 用来管理分片集群。
首先创建 MONGO_HOM E的系统变量,如下图所示:

图 17 配置MongoDB环境变量
然后编辑环境变量 Path,在最后加入一行内容,内容为:

图 18 环境变量
这样就完成了环境变量的配置。之后使用相关命令时,不需要再进入命令所在目录。
首先,打开 cmd 命令窗口,使用如下命令:
默认安装路径为 C:\Program Files\MongoDB\Server\6.0\bin,可以使用 INSTALLLOCATION 配置项来修改安装路径:
如果同步安装可视化工具,可以使用如下命令:

图 19 服务启动错误
首先检查是否存在 MongoDB 服务,如果存在,那么尝试手动启动;如果启动失败,那么先移除服务,再尝试手动添加服务;如果不存在 MongoDB 服务,可以手动添加 MongoDB 服务。
移除 MongoDB 服务的命令如下:
添加服务的命令如下:
由于 MongoDB 6 版本之后不再默认安装 Mongo Shell,因此本节分为两部分,安装 MongoDB 和安装 MongoDB Shell。
安装MongoDB
在 Windows 平台下,MongoDB 提供了两种安装形式:直接运行 MSI 安装包和 msiexec.exe 命令行工具,默认直接安装 MSI 安装包,msiexec.exe 命令行形式更倾向于使用自动化无人值守形式部署的系统管理员。1) 打开MongoDB官网的下载页面,地址为 https://www.mongodb.com/try/download/community。单击 Select Package 显示版本选择界面。在 Version 下拉列表中选择版本 8.0.4,在 Platform 下拉列表中选择 Windows X64 操作系统,安装包格式选择 msi,单击 Download 按钮,开始下载,如下图所示。

图 1 MongoDB下载页面
2) 下载完成之后,双击 .msi 安装包文件开始安装。在安装过程中会弹出安装向导界面,指导使用者安装 MongoDB 以及 MongoDB 的可视化工具 MongoDB Compass。安装包运行后,界面如下图所示:

图 2 开始安装MongoDB
3) 安装向导提示当前安装的 MongoDB 版本信息,如下图所示,单击 Next 按钮。

图 3 进入MongoDB安装向导
4) 接受当前的终端用户安装协议,选中同意协议的复选框(I accept the terms in the License Agreement),单击 Next 按钮,如下图所示。

图 4 MongoDB安装协议
5) 选择安装类型,MongoDB 支持完整安装和个性化安装。个性化安装方式支持选择所需要的安装组件,同时也支持自定义 MongoDB 的安装路径。官方推荐的是完整安装。对于初学者或对 MongoDB 使用不熟练的使用者,建议默认完整安装。此方式会将 MongoDB 安装在路径 C:\Program Files\MongoDB\Server\8.0 下。选择 Complete 安装类型后,单击 Next 按钮,如下图所示。

图 5 选择安装类型
6) 配置服务,从 4.0 版本开始,MongoDB 可以配置为一项 Windows 服务。在这个步骤中,可以选择将 MongoDB 作为 Windows 的一个系统服务,如下图所示。

图 6 配置MongoDB服务
在这个界面中,可以配置服务的名称,一般默认为 MongoDB,同时配置 MongoDB 的数据目录和日志目录。配置完成后,单击 Next 按钮。如果这里不将 MongoDB 配置为 Windows 的服务,可以手动启动,具体可以查看后面关于手动启动 MongoDB 实例的内容。
7) 安装可视化工具 MongoDB Compass。这里为可选项,既可以安装,也可以不安装。这里选中进行安装,单击 Next 按钮进入下一步,如下图所示。

图 7 选择安装可视化工具
8) 进入安装进程。上述所有配置完成,单击 Install 按钮进入安装进程,如下图所示:

图 8 进入安装进程
等待安装进程进行。整个过程可能会持续较长时间,与所使用的计算机配置有关,不同配置耗费的时间有所不同,耐心等待即可,如下图所示。

图 9 安装进行中
安装进程结束,完成 MongoDB 和 MongoDB Compass 的安装。单击 Finish 按钮,退出安装进程,如下图所示。

图 10 安装完成
如果将 MongoDB 作为服务安装,那么安装结束后,会自动开启服务。要查看 MongoDB 服务的状态,可以打开系统服务界面,按 Ctrl + Shift + Esc 组合键,打开任务管理器,切换到“服务”选项卡,或者直接通过 Windows 系统的搜索找到“服务”界面,在“服务”界面中找到 MongoDB 服务,查看服务是否正在运行。在服务名称上右击,可以选择开启或停止该服务,如下图所示。

图 11 “服务”界面
或者打开浏览器访问 https://localhost:27017,如下图所示:

图 12 在浏览器中访问MongoDB
同样,也可以通过命令查看 MongoDB 服务的状态,开启或停止 MongoDB 服务。命令如下:
#查看MongoDB服务的状态 sc query MongoDB #停止MongoDB服务 net stop MongoDB #开启MongoDB服务 net start MongoDB执行结果如下图所示:

图 13 查看MongoDB服务的状态
如果不作为服务安装,那么需要手动启动 MongoDB 实例,这里需要用到 mongod 命令。该命令在 MongoDB 安装目录下的 bin 文件夹(D:\MongoDB\Server\8.0\bin)下。启动时,需要配置数据目录,例如 D:\MongoDB\data,如下图所示。

图 14 mongod启动服务
MongoDB 启动后,该数据目录会生成一些数据库文件,如下图所示:

图 15 MongoDB的data目录
在 bin 目录下,存在一些关键文件,如下图所示:

图 16 MongoDB的bin目录
其中,mongod.exe 用来启动 MongoDB 服务,mongos.exe 用来管理分片集群。
配置环境变量
为了方便使用 mongod 以及其他命令,可以将 MongoDB 的安装路径加入环境变量。在配置了环境变量后,以上命令就可以省略路径,只保留命令本身的名称。打开环境变量配置界面,检查是否已自动创建环境变量,如果没有,则进行手动创建。首先创建 MONGO_HOM E的系统变量,如下图所示:

图 17 配置MongoDB环境变量
然后编辑环境变量 Path,在最后加入一行内容,内容为:
%MONGO_HOME%\bin最终结果如下图所示:

图 18 环境变量
这样就完成了环境变量的配置。之后使用相关命令时,不需要再进入命令所在目录。
其他安装形式
除前面介绍的安装方式外,MongoDB 还支持使用命令行工具 msiexec.exe 来安装。这种安装形式一般用在无人值守自动部署中。首先,打开 cmd 命令窗口,使用如下命令:
msiexec.exe /l*v mdbinstall.log /qb /i mongodb-windows-x86_64-8.0.4-signed.msi
默认安装路径为 C:\Program Files\MongoDB\Server\6.0\bin,可以使用 INSTALLLOCATION 配置项来修改安装路径:
msiexec.exe /l*v mdbinstall.log /qb /i mongodb-windows-x86_64-8.0.4-signed.msi INSTALLLOCATION="C:\MongoDB\Server\6.0"
如果同步安装可视化工具,可以使用如下命令:
msiexec.exe /l*v mdbinstall.log /qb /i mongodb-windows-x86_64-8.0.4-signed.msi SHOULD_INSTALL_COMPASS="0"
除以上形式外,还支持 .zip 免安装形式。下载 .zip 文件后,解压到相应目录,根据以上操作配置环境变量即可。其他设置和操作与双击运行 .msi 安装包的形式相同。
安装MongoDB常见问题和注意事项
1) 服务无法启动
安装完成后,可能会出现服务无法启动的情况,如下图所示。
图 19 服务启动错误
首先检查是否存在 MongoDB 服务,如果存在,那么尝试手动启动;如果启动失败,那么先移除服务,再尝试手动添加服务;如果不存在 MongoDB 服务,可以手动添加 MongoDB 服务。
移除 MongoDB 服务的命令如下:
sc delete MongoDB
添加服务的命令如下:
mongod -install -f "C:\Program Files\MongoDB\Server\8.0\bin\mongod.cfg"手动添加 MongoDB 服务后,参考前述关于手动启动或停止 MongoDB 服务的描述,使用界面或命令开启 MongoDB 服务。
2) 单点发行
MongoDB 的自动版本更新须在同一大版本下,例如 4.2.1 到 4.2.2 可以自动更新,但 4.0 到 4.2 这种全量更新,需要重新安装。3) 平台支持
MongoDB 8.0 社区版目前支持以下版本的 64 位 Windows 操作系统:- Windows Server 2019;
- Windows Server 2016;
- Windows 7/10/11。