在Windows上安装MongoDB社区版
概述
使用本教程安装MongoDB 8.0社区版在Windows上使用默认安装向导。
MongoDB版本
本教程安装MongoDB 8.0版。社区要安装MongoDB的不同版本社区,请使用页面左上角的版本下拉菜单选择该版本的文档。
安装方法
本教程使用默认的MSI安装向导在Windows上安装MongoDB。要使用其他方式安装MongoDBmsiexec.exe
命令行工具,请参阅使用 msiexec.exe 安装 MongoDB。对于希望以无人值守方式使用自动化部署 MongoDB 的系统管理员来说,msiexec.exe
工具非常有用。
注意事项
MongoDB Shell,mongosh
MongoDB Shell(mongosh)并非与 MongoDB Server 一起安装。您需要按照mongosh 安装说明下载和单独安装 mongosh。
平台支持
MongoDB 8.0 社区版支持以下64位 Windows x86_64 架构版本
Windows Server 2022
Windows Server 2019
Windows 11
MongoDB 只支持这些平台的 64 位版本。
有关更多信息,请参阅平台支持。
注意
MongoDB不支持在Windows Subsystem for Linux (WSL)上运行。要在Linux上运行MongoDB,请使用受支持的Linux系统。
虚拟化
Oracle为在运行Hyper-V的Windows主机上运行的VirtualBox提供实验性支持。然而,Microsoft不支持在Hyper-V上运行VirtualBox。
如果您想在Windows上使用VirtualBox安装MongoDB,请禁用Hyper-V。
生产说明
在生产环境中部署MongoDB之前,请考虑阅读自托管部署的生产说明文档,该文档提供了性能考虑和建议的配置,用于生产MongoDB部署。
全天候诊断数据捕获
MongoDB将诊断数据记录到日志中,以协助故障排除。有关详细信息,请参阅全天候诊断数据捕获。
在Windows上,为了收集系统数据,如磁盘、CPU和内存,FTDC需要以下组的Microsoft访问权限
性能监控用户
性能日志用户
如果运行mongod
和mongos
的用户不是管理员,请将他们添加到这些组以记录FTDC数据。有关更多信息,请参阅Microsoft在此处的文档。
安装 MongoDB 社区版
步骤
按照以下步骤安装 MongoDB社区使用 MongoDB 安装向导安装版本。安装过程将安装 MongoDB 二进制文件以及默认的 配置文件 <install directory>\bin\mongod.cfg
。
按照 MongoDB社区版本安装向导。
向导会指导您安装 MongoDB 和 MongoDB Compass。
- 选择设置类型
- 您可以选择 完整(大多数用户推荐)或 自定义 设置类型。完整设置选项将 MongoDB 和 MongoDB 工具安装到默认位置。自定义设置选项允许您指定要安装的可执行文件及其位置。
- 服务配置
您可以在安装过程中将 MongoDB 设置为 Windows 服务,或者仅安装二进制文件。
您可以在安装过程中将 MongoDB 配置为 Windows 服务,并成功安装后启动 MongoDB 服务。
选择 安装 MongoD 为服务。
选择以下选项之一
以网络服务用户运行服务(默认)
这是一个内置在 Windows 中的用户帐户。
以本地或域用户运行服务
对于现有的本地用户帐户,在 帐户域 中指定一个点(
.
),并指定用户的 帐户名 和 帐户密码。对于现有的域用户,指定该用户的 帐户域、帐户名 和 帐户密码。
服务名称。指定服务名称。默认名称是
MongoDB
。如果您已有一个指定名称的服务,您必须选择另一个名称。数据目录。指定数据目录,对应于
--dbpath
。如果目录不存在,安装程序将创建目录并将目录访问权限设置为服务用户。日志目录。指定日志目录,对应于
--logpath
。如果目录不存在,安装程序将创建目录并将目录访问权限设置为服务用户。
如果您选择不将MongoDB配置为Windows服务,请取消选中 将MongoD安装为服务。
- 安装MongoDB Compass
- 可选。为了让向导安装 MongoDB Compass,请选择 安装MongoDB Compass(默认)。
准备就绪后,单击 安装。
安装 mongosh
.msi 安装程序不包括 mongosh。请按照 mongosh 安装说明下载并单独安装shell。
如果您已将MongoDB安装为Windows服务
成功安装后,MongoDB服务将启动。
如果您想自定义服务,必须先停止服务。通过编辑位于 <install directory>\bin\mongod.cfg
的配置文件来自定义 MongoDB 实例。
有关可用配置选项的信息,请参阅自管理配置文件选项。
修改后,请重新启动服务。
如果您没有将 MongoDB 作为 Windows 服务安装
如果您只安装了可执行文件而没有将 MongoDB 作为 Windows 服务安装,您必须手动启动 MongoDB 实例。
有关启动 MongoDB 实例的说明,请参阅从命令解释器运行 MongoDB 社区版。
将 MongoDB 社区版作为 Windows 服务运行
您可以在安装过程中将 MongoDB 作为 Windows 服务 进行安装和配置。MongoDB 服务在成功安装后将自动启动。使用配置文件 <install directory>\bin\mongod.cfg
配置 MongoDB 实例。
如果您尚未这样做,请按照mongosh 安装说明下载并安装 MongoDB Shell (mongosh)。
务必在安装过程中将 mongosh.exe
二进制文件的路径添加到您的 PATH
环境变量中。
打开一个新的 命令解释器 并输入 mongosh.exe
以连接到 MongoDB。
有关使用 mongod
和 mongosh.exe 连接的更多信息,例如连接到运行在不同主机和/或端口的 MongoDB 实例,请参阅 连接到部署。
有关 CRUD(创建、读取、更新、删除)操作的更多信息,请参阅
以 Windows 服务方式启动 MongoDB 社区版
要启动/重启 MongoDB 服务,请使用服务控制台
在服务控制台中找到 MongoDB 服务。
右键单击 MongoDB 服务并单击 启动。
以 Windows 服务方式停止 MongoDB 社区版
要停止/暂停 MongoDB 服务,请使用服务控制台
在服务控制台中找到 MongoDB 服务。
右键单击 MongoDB 服务并单击 停止(或 暂停)。
将 MongoDB 社区版从 Windows 服务中移除
要移除 MongoDB 服务,首先使用服务控制台停止服务。然后以管理员身份打开 Windows 命令提示符/解释器 (cmd.exe
),并运行以下命令
sc.exe delete MongoDB
从命令解释器运行 MongoDB 社区版
您可以从 Windows 命令提示符/解释器 (cmd.exe
) 运行 MongoDB 社区版,而不是作为服务。
以管理员身份打开Windows命令提示符/解释器(cmd.exe
)。
重要
您必须以管理员身份打开命令解释器。
创建数据库目录。
创建MongoDB存储数据的数据目录。MongoDB的默认数据目录路径是从您启动MongoDB的驱动器上的绝对路径\data\db
。
在命令解释器中创建数据目录
cd C:\ md "\data\db"
启动您的MongoDB数据库。
要启动MongoDB,请运行mongod.exe
。
"C:\Program Files\MongoDB\Server\8.0\bin\mongod.exe" --dbpath="c:\data\db"
--dbpath
选项指向您的数据库目录。
如果MongoDB数据库服务器运行正确,命令解释器将显示
[initandlisten] waiting for connections
重要
根据您的Windows主机上的Windows Defender防火墙设置,Windows可能会显示一个关于阻止“某些功能”的C:\Program Files\MongoDB\Server\8.0\bin\mongod.exe
在网络上通信的安全警报
对话框。要解决这个问题
点击私有网络,如我的家庭或工作网络。
点击允许访问。
有关安全和MongoDB的更多信息,请参阅安全文档。
连接到MongoDB。
如果您尚未这样做,请按照mongosh 安装说明下载并安装 MongoDB Shell (mongosh)。
务必在安装过程中将 mongosh.exe
二进制文件的路径添加到您的 PATH
环境变量中。
打开一个新的 命令解释器 并输入 mongosh.exe
以连接到 MongoDB。
有关使用mongosh.exe连接到mongod
的更多信息,例如连接到运行在不同主机和/或端口的MongoDB实例,请参阅连接到部署。
有关 CRUD(创建、读取、更新、删除)操作的更多信息,请参阅
其他注意事项
默认本地绑定
默认情况下,MongoDB启动时将bindIp
设置为127.0.0.1
,这将绑定到本地网络接口。这意味着mongod.exe
只能接受运行在同一台机器上的客户端的连接。远程客户端将无法连接到mongod.exe
,除非将此值设置为有效的网络接口,否则mongod.exe
将无法初始化副本集。
此值可以通过以下方式配置
在MongoDB配置文件中使用
bindIp
,或通过命令行参数
--bind_ip
有关配置bindIp
的更多信息,请参阅自托管部署中的IP绑定。
点发行版和.msi
如果您使用Windows安装程序(.msi
)安装MongoDB,则.msi
将在其发布系列内自动升级(例如,从7.2.1升级到7.2.2)。
升级完整的发布系列(例如,从6.0升级到7.0)需要重新安装。
将 MongoDB 二进制文件添加到系统 PATH
如果您将 C:\Program Files\MongoDB\Server\8.0\bin
添加到系统 PATH
,您就可以省略 MongoDB 服务器二进制文件的完整路径。如果您还没有这样做,也应该添加 mongosh 的路径。