使用以下教程手动安装 MongoDB 8.0在 macOS 上使用下载的 `.tgz` 归档文件安装 MongoDB 社区版。

本页内容

概述

注意事项
安装 MongoDB 社区版
运行 MongoDB 社区版
更多信息

概述

使用本教程手动安装 MongoDB 8.0社区版在 macOS 上使用下载的 .tgz 归档文件。

MongoDB 版本

此教程安装 MongoDB 8.0社区版。要安装不同版本的 MongoDB，社区请使用页面左上角的版本下拉菜单选择该版本的文档。

安装方法

尽管MongoDB可以通过下载的.tgz压缩包按本文档所述手动安装，但如果可能的话，建议使用系统上的brew包管理器来安装MongoDB。使用包管理器可以自动安装所有所需的依赖项，提供一个示例mongod.conf文件以帮助您开始，并简化未来的升级和维护任务。

➤请参阅使用brew包管理器安装MongoDB以获取说明。

注意事项

MongoDB Shell，`mongosh`

当您使用.tgz包安装服务器时，您需要按照mongosh安装说明下载并安装mongosh。

平台支持

MongoDB 8.0 社区版支持 macOS 11 或更高版本。

有关更多信息，请参阅平台支持。

生产说明

在将 MongoDB 部署到生产环境之前，请考虑阅读《自管理部署的生产说明》文档，该文档提供了关于生产 MongoDB 部署的性能考虑和配置建议。

安装 MongoDB 社区版

手动安装 MongoDB社区从 .tgz 版本安装，选择与您的 Mac 处理器对应的选项卡，并完成以下步骤

下载 tarball 文件。

下载 MongoDB社区从以下链接下载 tgz tarball 文件

➤ MongoDB 下载中心

在版本下拉菜单中，选择要下载的 MongoDB 版本。
在平台下拉菜单中，选择 macOS。
在包下拉菜单中，选择 tgz。
点击下载。

从下载的压缩文件中提取文件。

tar -zxvf mongodb-macos-x86_64-8.0.tgz

如果您的网络浏览器在下载过程中自动解压缩文件，则文件以 .tar 结尾。

确保二进制文件位于您的 `PATH` 环境变量列出的目录中。

MongoDB 二进制文件位于 tarball 的 bin/ 目录中。您可以选择

将二进制文件复制到您的 PATH 变量列出的目录中，例如 /usr/local/bin。将 /path/to/the/mongodb-directory/ 替换为您安装目录。
```
sudo cp /path/to/the/mongodb-directory/bin/* /usr/local/bin/
```
将二进制文件从您PATH环境变量中列出的目录创建符号链接，例如/usr/local/bin。将/path/to/the/mongodb-directory/替换为您的安装目录。
```
sudo ln -s  /path/to/the/mongodb-directory/bin/* /usr/local/bin/
```

下载压缩包。

下载 MongoDB社区从以下链接下载 tgz tarball 文件

➤ MongoDB 下载中心

在版本下拉菜单中，选择要下载的MongoDB版本。
在平台下拉菜单中，选择macOS ARM 64。
在包下拉菜单中，选择 tgz。
点击下载。

从下载的压缩包中提取文件。

tar -zxvf mongodb-macos-arm64-8.0.tgz

如果您的网络浏览器在下载过程中自动解压缩文件，则文件以 .tar 结尾。

确保二进制文件在您的`PATH`环境变量中列出的目录中。

MongoDB 二进制文件位于 tarball 的 bin/ 目录中。您可以选择

将二进制文件复制到您的 PATH 变量列出的目录中，例如 /usr/local/bin。将 /path/to/the/mongodb-directory/ 替换为您安装目录。
```
sudo cp /path/to/the/mongodb-directory/bin/* /usr/local/bin/
```
将二进制文件从您PATH环境变量中列出的目录创建符号链接，例如/usr/local/bin。将/path/to/the/mongodb-directory/替换为您的安装目录。
```
sudo ln -s  /path/to/the/mongodb-directory/bin/* /usr/local/bin/
```

运行MongoDB社区版

ulimit注意事项: 大多数类Unix操作系统会限制进程可能使用的系统资源。这些限制可能会对MongoDB的运行产生负面影响，并且应该进行调整。请参阅自管理部署的UNIX ulimit 设置，了解您平台推荐的设置。
注意
如果打开文件的ulimit值小于64000，MongoDB会在启动时生成一个警告。

步骤

按照以下步骤运行MongoDB社区版本。这些说明假设您正在使用默认设置。

创建数据目录。

在首次启动MongoDB之前，您必须创建一个目录，以便mongod进程将数据写入其中。

例如，创建~/data/db目录

sudo mkdir -p ~/data/db

创建日志目录。

您还必须创建一个目录，该目录用于 mongod 进程写入其日志文件

例如，创建 ~/data/log/mongodb 目录

sudo mkdir -p ~/data/log/mongodb

设置数据和日志目录的权限。

确保运行 mongod 的用户账户有这两个目录的读写权限。如果您是以自己的用户账户运行 mongod，并且刚刚创建了上述两个目录，它们应该已经对您的用户可访问。否则，您可以使用 chown 来设置所有权，用适当的用户替换

sudo chown <user> ~/data/db
sudo chown <user> ~/data/log/mongodb

运行MongoDB.

要运行MongoDB，请在系统提示符中运行 mongod 进程，并提供上面提到的两个参数 dbpath 和 logpath，以及 fork 参数以在后台运行 mongod。或者，您可以选择将 dbpath、logpath、fork 以及许多其他参数存储在一个配置文件中。

使用命令行参数运行 `mongod`

在系统提示符中运行 mongod 进程，直接在命令行上提供三个必要的参数

mongod --dbpath ~/data/db --logpath ~/data/log/mongodb/mongo.log --fork

使用配置文件运行 `mongod`，请参阅

在系统提示符下运行 mongod 进程，并使用 config 参数提供配置文件的路径

mongod --config /usr/local/etc/mongod.conf

macOS 可能会阻止安装后运行 mongod。如果在启动 mongod 时收到安全错误，指出开发者无法识别或验证，请按照以下步骤授予 mongod 运行权限

打开 系统偏好设置
选择 安全和隐私 选项卡。
在通用选项卡下，点击关于 mongod 的消息右侧的按钮，按钮标签可能是仍然打开或总是允许，具体取决于您的 macOS 版本。

验证 MongoDB 是否已成功启动。

验证 MongoDB 是否已成功启动

ps aux | grep -v grep | grep mongod

如果您没有看到正在运行的 mongod 进程，请检查日志文件以查找任何错误消息。

开始使用 MongoDB。

在同一台主机上启动一个与mongod相同的mongosh会话。您可以在没有任何命令行选项的情况下运行mongosh，以连接到运行在您的localhost上的默认端口27017的mongod。

mongosh

有关使用mongosh连接的更多信息，例如连接到运行在不同主机和/或端口上的mongod实例，请参阅mongosh 文档。

为了帮助您开始使用 MongoDB，MongoDB 提供了各种驱动程序版本的入门指南。有关可用版本，请参阅MongoDB 入门。

警告

在将实例绑定到公开可访问的IP地址之前，您必须保护您的集群免受未经授权的访问。有关安全建议的完整列表，请参阅自管理部署的安全清单。至少，请考虑启用身份验证和强化网络基础设施。

有关配置bindIp的更多信息，请参阅自管理部署中的IP绑定。

在 macOS 上安装

在 Windows 上安装

概述