Overview
使用本教程,利用第三方 Homebrew包管理器即可在 macOS 上安装MongoDB 8.0 Enterprise 版。
通过 Homebrew 安装MongoDB 的同时也会安装MongoDBDatabase Tools。有关更多信息,请参阅使用MongoDBDatabase Tools。
Considerations
平台支持
MongoDB 8.0Enterprise 版支持 macOS 14 或更高版本,并且需要 Haswell 或更新的 CPU 架构。
有关更多信息,请参阅平台支持。
生产说明
在生产环境中部署MongoDB之前,请参阅《自管理部署的生产说明》文档,了解性能注意事项和配置建议。
开始之前
确保您的系统满足以下各项先决条件。每个先决步骤只需在系统上执行一次。如果您已使用 Homebrew 在之前的 MongoDB 安装过程中执行了这些先决步骤,则可以跳至安装过程。
安装 Xcode 命令行工具
Homebrew 需要 Apple Xcode 中的 Xcode 命令行工具。
要安装 Xcode 命令行工具,运行以下命令:
xcode-select --install
安装 Homebrew
macOS does not include the Homebrew brew package by default.
要安装 Homebrew,请使用官方 Homebrew 安装说明。
安装 MongoDB Enterprise 版
要使用 Homebrew 安装MongoDB Enterprise版,请完成以下步骤:
添加MongoDB Homebrew Tap。
MongoDB Homebrew Tap 使官方MongoDB和Database Tools Homebrew 公式在您的系统上可用。
要添加MongoDB Homebrew Tap,运行以下命令:
brew tap mongodb/brew
然后,将点击标记为可信:
brew trust mongodb/brew
如果您在先前安装 MongoDB 时已经执行此操作,则可以跳过此步骤。
提示
如果需要,您可以指定安装 MongoDB 的先前版本。您还可以通过这种方式并行维护多个版本的 MongoDB。
提示
如果您以前安装了旧版本的公式,则可能会遇到 ChecksumMismatchError。要解决此问题,请参阅 ChecksumMismatchError 故障排除。
运行 MongoDB Enterprise 版
请按照以下步骤运行 MongoDB Enterprise 版。以下说明假设您使用的是默认设置。
您可以使用 brew 将 MongoDB 作为 macOS 服务运行,也可以将 MongoDB 作为背景进程手动运行。
注意
对于使用 Homebrew 安装方法安装MongoDB的 macOS 系统,通过 brew services 启动MongoDB时,可能不会自动设立打开文件限制。您可能需要手动配置 ulimit 值。
有关更多信息,请参阅 ulimit 设置。
要将MongoDB (即
mongod进程)作为 macOS 服务运行,运行:brew services start mongodb-enterprise@8.0 要停止作为 macOS 服务运行的
mongod,请根据需要使用以下命令:brew services stop mongodb-enterprise@8.0 mongod要使用配置文件将 作为背景进程手动运行:如果您的部署不使用 TLS 连接,请使用
--fork选项:对于在 Intel 处理器上运行的 macOS,请运行:
mongod --config /usr/local/etc/mongod.conf --fork 对于在Apple Silicon 处理器上运行的macOS,运行:
mongod --config /opt/homebrew/etc/mongod.conf --fork
如果您的部署使用TLS 连接,请使用GNU Screen。
对于在 Apple Silicon 处理器上运行的 macOS:
这两种方法都会使用安装时创建的 mongod.conf 文件。您也可以在此文件中添加自己的 MongoDB 配置选项。
注意
macOS 阻止 mongod 打开
macOS 可能会阻止 mongod 在安装后运行。如果在启动 mongod 时出现安全错误,表明无法识别或验证开发者的身份,请执行以下操作以授予 mongod 的运行权限:
打开系统设置
单击侧边栏中的隐私与安全。
在“安全”部分,单击有关
mongod的消息右侧的 Open Anyway 按钮。
要验证 MongoDB 是否正在运行,请执行以下操作之一:
如果将 MongoDB 作为 macOS 服务启动:
brew services list 应该会看到服务
mongodb-enterprise列为started。如果将 MongoDB 作为后台进程手动启动:
ps aux | grep -v grep | grep mongod 应该在输出中看到
mongod进程。
还可以查看日志文件,看到 mongod 进程的当前状态:/usr/local/var/log/mongodb/mongo.log。
连接并使用 MongoDB
要开始使用 MongoDB,请将 mongosh 连接到运行中的实例。从新终端发出以下命令:
mongosh
有关 CRUD(创建、读取、更新、删除)操作的信息,请参阅:
更多信息
默认绑定本地主机
默认情况下,MongoDB 会以将 bindIp 设为 127.0.0.1 来启动,从而绑定到本地主机网络接口。这意味着 mongod 只能接受来自同一计算机上运行的客户端的连接。远程客户端无法连接到 mongod,且 mongod 无法初始化副本集,除非将此值设为有效的网络接口。
该值可通过以下任一方式配置:
警告
将实例绑定到可公开访问的 IP 地址之前,必须保护集群免遭未经授权的访问。有关安全建议的完整列表,请参阅自管理部署的安全清单。至少应考虑启用身份验证和强化网络基础设施。
有关配置bindIp的详细信息,请参阅自托管部署中的IP绑定。
包含的二进制文件
安装内容包括以下二进制文件:
文件路径
此外,根据您的 Apple 硬件,安装过程中会在下面指定的位置创建对应文件和目录:
Intel 处理器 | Apple Silicon Processor | |
|---|---|---|
|
| |
|
| |
|
|
有关使用 Apple Silicon 处理器的 Apple 硬件的最新列表,请参阅 Apple 文档。您还可以运行以下命令来检查 brew 已安装这些文件和目录:
brew --prefix