使用.tgz
Tarball 在 macOS 上安装MongoDB Community
Overview
使用本教程,利用下载的.tgz
tarball,即可在 macOS 上手动安装 MongoDB 5.0 MongoDB Community Edition。
MongoDB 版本
本教程将安装 MongoDB 5.0 MongoDB Community Edition。要安装不同版本的 MongoDB Community,请使用此页面左上角的版本下拉菜单选择该版本的文档。
安装方法
虽然可按本文档所述方法通过下载的 .tgz
Tarball 手动安装 MongoDB,但可能时仍建议在您的系统上使用 brew
包管理器来安装 MongoDB。使用包管理器会自动安装所需的全部依赖项,提供 mongod.conf
示例文件来帮助您入门,并简化未来的升级和维护任务。
➤ 有关说明,请参阅 使用 brew 包管理器安装 MongoDB。
Considerations
MongoDB Shell、 mongosh
使用 .tgz
包安装服务器时,您需要按照 mongosh 安装说明单独下载和安装 mongosh。
平台支持
注意
EOL Notice
MongoDB 5.0 MongoDB Community Edition 删除了对 macOS 10.13 的支持
MongoDB 5.0 社区版支持 macOS 10.14 或更高版本。
更多信息,请参阅平台支持。
生产说明
在生产环境中部署 MongoDB 之前,请参阅自管理部署的生产注意事项文档,其中提供了有关生产环境中 MongoDB 部署的性能注意事项和配置建议。
安装 MongoDB Community Edition
请按照以下步骤从 .tgz
手动安装 MongoDB Community Edition。
确保二进制文件位于 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/
确保二进制文件位于 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 Community Edition
- ulimit 注意事项
- 大多数类 Unix 操作系统都会限制进程可以使用的系统资源。 这些限制可能会对MongoDB操作产生负面影响,应该进行调整。 有关平台的建议设置,请参阅自管理部署的 UNIX
ulimit
设置。注意
如果打开文件数的ulimit
值低于64000
,MongoDB 会生成初创企业警告。
步骤
请按照以下步骤运行 MongoDB Community Edition。 这些说明假设您使用的是默认设置。
创建数据目录。
首次启动 MongoDB 之前,必须创建 mongod
进程写入数据的目录。
例如,要创建 ~/data/db
目录:
sudo mkdir -p ~/data/db
运行 MongoDB。
要运行 MongoDB,请在系统提示符下运行 mongod
进程,提供上面两个参数 dbpath
和 logpath
,以及用于在后台运行 mongod
的 fork
参数。或者,您也可以选择将 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
相关消息右侧的按钮,该按钮标有 Open Anyway 或 Allow Anyway,具体取决于您的 macOS 版本。
开始使用 MongoDB。
在与 mongod
相同的主机上启动 mongosh
会话。您可以在不使用任何命令行选项的情况下运行 mongosh
,从而连接到在本地主机上运行且默认端口号为 27017的 mongod
:
mongosh
如需进一步了解使用 mongosh
进行连接(例如连接在其他主机和/或端口上运行的 mongod
实例),请参阅 mongosh 文档。
为了帮助您开始使用 MongoDB,MongoDB 提供了各种驱动程序版本的入门指南。有关可用版本,请参阅 MongoDB 入门。
更多信息
默认绑定本地主机
By default, MongoDB launches with bindIp
set to 127.0.0.1
, which binds to the localhost network interface. This means that the mongod
can only accept connections from clients that are running on the same machine. Remote clients will not be able to connect to the mongod
, and the mongod
will not be able to initialize a replica set unless this value is set to a valid network interface which is accessible from the remote clients.
该值可通过以下任一方式配置:
警告
在绑定到非本地主机(例如 可公开访问的) IP解决,确保已保护集群免遭未经授权的访问权限。 有关安全建议的完整列表,请参阅自托管部署的安全检查清单。 至少应考虑启用身份验证并强化网络基础架构。
有关配置bindIp
的详细信息,请参阅自托管部署中的IP绑定。