Make the MongoDB docs better! We value your opinion. Share your feedback for a chance to win $100.
Click here >
Docs 菜单
Docs 主页
/ /
在 macOS 上安装
/ / / /

使用.tgz Tarball 在 macOS 上安装MongoDB Community

使用本教程手动安装MongoDB 8.0 macOS 上的MongoDB Community Edition ,使用下载的 .tgz tarball。

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

虽然您可以按照本文档所述使用下载的 .tgz Tarball 手动安装MongoDB ,但我们建议您尽可能在系统上使用 brew包管理器。使用包管理器会自动安装所需的所有依赖项,提供示例mongod.conf文件,并简化未来的升级和维护任务。

➤ 有关说明,请参阅 使用 brew 包管理器安装 MongoDB

使用 .tgz 包安装服务器时,您需要按照 mongosh 安装说明,单独下载和安装 mongosh

MongoDB 8.0Community Edition 支持 64 位 Intel(x86_64、Haswell 或更高版本)和 Apple Silicon (arm64) 系统上的 macOS 13 或更高版本。

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

在生产环境中部署MongoDB之前,请参阅《自管理部署的生产说明》文档,了解性能注意事项和配置建议。

要从 .tgz 上手动安装 MongoDB Community Edition,请选择与您的 Mac 处理器对应的标签页并完成以下步骤:

1

从以下链接下载 MongoDB 社区版 tgz tarball:

MongoDB 下载中心

  1. Version 下拉列表中选择要下载的 MongoDB 版本。

  2. Platform 下拉菜单中,选择 macOS

  3. Package 下拉菜单中,选择 tgz

  4. 单击 Download(连接)。

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

如果您的 Web 浏览器在下载过程中自动解压该文件,则该文件会改为以 .tar 结尾。

3

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/
1

从以下链接下载 MongoDB 社区版 tgz tarball:

MongoDB 下载中心

  1. Version 下拉列表中选择要下载的 MongoDB 版本。

  2. Platform 下拉菜单中,选择 macOS ARM 64

  3. Package 下拉菜单中,选择 tgz

  4. 单击 Download(连接)。

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

如果您的 Web 浏览器在下载过程中自动解压该文件,则该文件会改为以 .tar 结尾。

3

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/
ulimit 注意事项
大多数类 Unix 操作系统都会限制进程可以使用的系统资源。这些限制可能会对 MongoDB 操作产生负面影响,应该进行调整。请参阅UNIX ulimit 自我管理部署设置,了解适用于您平台的推荐设置。

注意

如果打开文件数的 ulimit 值低于 64000,MongoDB 会生成初创企业警告。

请按照以下步骤运行 MongoDB Community Edition。 这些说明假设您使用的是默认设置。

1

首次启动 MongoDB 之前,必须创建 mongod 进程写入数据的目录。

例如,要创建 ~/data/db 目录:

sudo mkdir -p ~/data/db
2

您还必须创建 mongod 进程写入日志文件的目录:

例如,要创建 ~/data/log/mongodb 目录:

sudo mkdir -p ~/data/log/mongodb
3

确保运行 mongod 的用户帐户拥有这两个目录的读写权限。如果您以自己的用户帐户运行 mongod,而且刚刚创建了上面两个目录,那么您的用户应该已经可以访问这些目录了。否则,您可以使用 chown 来设置所有权,替换适当的用户

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

要运行 MongoDB,请在系统提示符下运行 mongod 进程,提供上面两个参数 dbpathlogpath,以及用于在后台运行 mongodfork 参数。或者,您也可以选择将 dbpathlogpathfork 以及其他许多参数的值存储在配置文件中。

在系统提示符下运行 mongod 进程,直接在命令行上提供三个必要参数:

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

在系统提示符下运行 mongod 进程,提供包含 config 参数的配置文件的路径:

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

macOS 可能会阻止 mongod 在安装后运行。如果在启动 mongod 时出现安全错误,表明无法识别或验证开发者的身份,请执行以下操作以授予 mongod 的运行权限:

  • 打开系统设置

  • 单击侧边栏中的“隐私与安全”。

  • 在“安全”部分,单击有关Open Anyway 的消息右侧的mongod 按钮。

5

验证 MongoDB 是否已成功启动:

ps aux | grep -v grep | grep mongod

如果您发现 mongod 进程不在运行,请检查日志文件中是否有任何错误消息。

6

在与 mongod 相同的主机上启动 mongosh 会话。您可以在不使用任何命令行选项的情况下运行 mongosh,从而连接到在本地主机上运行且默认端口号为 27017mongod

mongosh

如需进一步了解使用 mongosh 进行连接(例如连接在其他主机和/或端口上运行的 mongod 实例),请参阅 mongosh 文档。

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

默认情况下,MongoDB 会以将 bindIp 设为 127.0.0.1 来启动,从而绑定到本地主机网络接口。这意味着 mongod 只能接受来自同一计算机上运行的客户端的连接。远程客户端无法连接到 mongod,且 mongod 无法初始化副本集,除非将此值设为有效的网络接口。

该值可通过以下任一方式配置:

  • 在 MongoDB 配置文件中使用 bindIp,或

  • 通过命令行参数 --bind_ip

警告

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

有关配置bindIp的详细信息,请参阅自托管部署中的IP绑定。

在此页面上