Docs 菜单
Docs 主页
/
MongoDB Manual
/ / / /

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

在此页面上

  • Overview
  • Considerations
  • 安装 MongoDB Community Edition
  • 运行 MongoDB Community Edition
  • 更多信息

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

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

虽然可按本文档所述方法通过下载的 .tgz Tarball 手动安装 MongoDB,但可能时仍建议在您的系统上使用 brew 包管理器来安装 MongoDB。使用包管理器会自动安装所需的全部依赖项,提供 mongod.conf 示例文件来帮助您入门,并简化未来的升级和维护任务。

➤ 有关说明,请参阅使用 brew Package Manager 安装 MongoDB

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

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

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

在生产环境中部署 MongoDB 之前,请参阅《自管理部署的生产说明》文档,其中提供了 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 的运行权限:

  • 打开系统偏好设置

  • 选择“安全和隐私”窗格。

  • 通用标签页下,单击 mongod 相关消息右侧的按钮,该按钮标有 Open AnywayAllow Anyway,具体取决于您的 macOS 版本。

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 绑定。

后退

在 macOS 上安装