“文档” 菜单
文档首页
/
MongoDB Manual
/ / /

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

在此页面上

  • 概述
  • 注意事项
  • 安装 MongoDB Community Edition
  • 运行 MongoDB Community Edition
  • 更多信息

注意

MongoDB 阿特拉斯

MongoDB Atlas 是在云中托管的 MongoDB 服务选项,无需安装开销,并提供免费套餐,可以立即开始使用。

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

本教程安装的是 MongoDB 7.0 Community Edition。想要安装不同版本的 MongoDB Community Edition,请移步本页面左上角的版本下拉菜单,选择该版本对应的文档进行参照。

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

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

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

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

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

在生产环境部署 MongoDB 之前,请考虑生产环境说明文档,其中提供了有关生产环境中 MongoDB 部署的性能注意事项和配置建议。

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

1

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

MongoDB 下载中心

1

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

2
3
4
2
tar -zxvf mongodb-macos-x86_64-7.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
4
2
tar -zxvf mongodb-macos-arm64-7.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 打开

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 上安装

来年

在 Windows 上安装