安装参考自mongo官网:在 Ubuntu 上安装 MongoDB Community Edition - MongoDB 手册 v7.0
MongoDB 版本
本教程安装的是 MongoDB 7.0 Community Edition。想要安装不同版本的 MongoDB Community Edition,请移步本页面左上角的版本下拉菜单,选择该版本对应的文档进行参照。
注意事项
平台支持
MongoDB 7.0 社区版支持以下采用 64 位 架构的 x86_64 Ubuntu LTS(长期支持)版本:
-
22.04 LTS ("Jammy")
-
20.04 LTS ("Focal")
MongoDB 仅支持这些平台的 64 位版本。要确定您的主机当前正在运行的 Ubuntu 版本,请在主机的终端上运行以下命令:
cat /etc/lsb-release |
Ubuntu 上的 MongoDB 7.0 社区版还支持某些平台上的 ARM64 架构。
更多信息,请参阅平台支持。
生产说明
在生产环境部署 MongoDB 之前,请考虑生产环境说明文档,其中提供了有关生产环境中 MongoDB 部署的性能注意事项和配置建议。
官方 MongoDB 软件包
要在 Ubuntu 系统上安装 MongoDB Community,以下说明将使用由 MongoDB Inc. 维护和支持的官方 mongodb-org
软件包。官方 mongodb-org
软件包始终包含最新版本的 MongoDB,并且可以从其专用存储库中获取。
重要
Ubuntu 提供的mongodb
包并不由 MongoDB Inc. 维护,且与官方的 mongodb-org
包冲突。如果您已在您的 Ubuntu 系统上安装了 mongodb
包,则必须先卸载 mongodb
包,才能继续执行这些操作。
请参阅MongoDB Community Edition软件包,获取官方软件包的完整清单。
安装 MongoDB Community Edition
按照以下步骤使用 apt
软件包管理器安装 MongoDB Community Edition。
1
导入包管理系统使用的公钥
从终端安装 gnupg
和 curl
(如果尚未安装):
sudo apt-get install gnupg curl |
要导入 MongoDB 公共 GPG 密钥,请运行以下命令:
curl -fsSL https://www.mongodb.org/static/pgp/server-7.0.asc | \ |
sudo gpg -o /usr/share/keyrings/mongodb-server-7.0.gpg \ |
--dearmor |
2
为 MongoDB 创建列表文件
为您的 Ubuntu 版本创建列表文件 /etc/apt/sources.list.d/mongodb-org-7.0.list
。
Ubuntu 22.04 (Jammy)
Ubuntu 20.04 (Focal)
为 Ubuntu 20.04 (Focal) 创建/etc/apt/sources.list.d/mongodb-org-7.0.list
文件:
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list |
3
重新加载本地包数据库
发出以下命令以重新加载本地软件包数据库:
sudo apt-get update |
4
安装 MongoDB 软件包
您可以安装最新稳定版本的 MongoDB 或指定版本的 MongoDB。
安装最新版本的 MongoDB
安装特定版本的 MongoDB
要安装最新的稳定版本,请执行以下命令:
sudo apt-get install -y mongodb-org |
可选。虽然您可以指定任意可用版本的 MongoDB,但当有新版本可用时,apt-get
仍会升级这些包。要防止意外升级,可将此包固定到当前安装的版本:
echo "mongodb-org hold" | sudo dpkg --set-selections |
echo "mongodb-org-database hold" | sudo dpkg --set-selections |
echo "mongodb-org-server hold" | sudo dpkg --set-selections |
echo "mongodb-mongosh hold" | sudo dpkg --set-selections |
echo "mongodb-org-mongos hold" | sudo dpkg --set-selections |
echo "mongodb-org-tools hold" | sudo dpkg --set-selections |
在 Ubuntu 中安装 MongoDB 时,如需对过程中遇到的错误进行故障排查,请参阅故障排查指南。
运行 MongoDB Community Edition
ulimit 注意事项
大多数类 Unix 操作系统都会对每个进程可以使用的系统资源进行限制。这些限制可能会对 MongoDB 操作产生负面影响,应进行适当调整。有关您平台的建议设置,请参阅 UNIX ulimit 设置 。
注意
如果打开文件数的 ulimit
值低于 64000
,MongoDB 会生成初创企业警告。
目录
如果通过软件包管理器安装,则在安装过程中会创建数据目录 /var/lib/mongodb
和日志目录 /var/log/mongodb
。
默认情况下,MongoDB 使用 mongodb
用户账户运行。如果更改运行 MongoDB 进程的用户,您还必须修改数据和日志目录以赋予该用户访问这些目录的权限。
配置文件
MongoDB 官方软件包有一份配置文件 (/etc/mongod.conf
)。这些设置(如数据目录和日志目录规范)将在启动时生效。换言之,如果在 MongoDB 实例运行时更改该配置文件,则必须重新启动实例才能使更改生效。
步骤
请按照以下步骤在系统上运行 MongoDB 社区版。 这些说明假定您使用的是官方 mongodb-org
包,而不是由 Ubuntu 提供的非官方 mongodb
包,并且您使用的是默认设置。
初始化系统
要运行和管理 mongod 进程,需使用操作系统内置的初始化系统。较新版本的 Linux 倾向于使用 systemd(它会使用 systemctl
命令),而较旧版本的 Linux 倾向于使用 System V init(它使用 service
命令)。
如果您不确定您的平台使用的是哪个初始化系统,请运行以下 命令:
ps --no-headers -o comm 1 |
然后根据结果选择下面合适的标签页:
-
systemd
- 选择下方的 systemd (systemctl) 标签页。 -
init
- 选择下方的 System V Init (service) 标签页。
systemd (systemctl)
System V Init (service)
1
启动 MongoDB。
您可以通过发出以下命令来启动 mongod 进程:
sudo systemctl start mongod |
如果收到类似下方的错误(在启动 mongod 时):
Failed to start mongod.service: Unit mongod.service not found.
首先运行以下命令:
sudo systemctl daemon-reload |
然后再次运行上面的启动命令。
2
验证 MongoDB 是否已成功启动。
sudo systemctl status mongod |
您可以通过选择执行以下命令,来确保 MongoDB 将在系统 重新启动后启动:
sudo systemctl enable mongod |
3
停止 MongoDB。
您可以根据需要,通过发出以下命令来停止 mongod 进程:
sudo systemctl stop mongod |
4
重启 MongoDB。
您可以通过发出以下命令来重启 mongod 进程:
sudo systemctl restart mongod |
通过观察 /var/log/mongodb/mongod.log
文件中的输出,可以跟踪错误或重要消息的进程状态。
5
开始使用 MongoDB。
在与 相同的主机上启动 会话。您可以在不使用任何命令行选项的情况下运行 mongosh,从而连接在本地主机上运行且默认端口号为 27017 的 mongod。
mongosh |
如需进一步了解使用 mongosh 进行连接(例如连接在其他主机和/或端口上运行的 mongod 实例),请参阅 mongosh 文档。
为了帮助您开始使用 MongoDB,MongoDB 提供了各种驱动程序版本的入门指南。关于驱动程序文档,请参阅 开始使用 MongoDB 开发。
卸载 MongoDB Community Edition
要从系统中完全删除 MongoDB,您必须删除 MongoDB 应用程序本身、配置文件以及任何包含 数据和日志的目录。以下部分将指导您完成所需的步骤。
警告
此过程将完全删除 MongoDB、其配置以及所有数据库。此过程不可逆,因此请确保在继续之前备份所有配置和数据。
1
停止 MongoDB。
通过发出以下命令来停止 mongod 进程:
sudo service mongod stop |
2
删除包。
删除您之前安装的所有 MongoDB 包。
sudo apt-get purge "mongodb-org*" |
3
删除数据目录。
删除 MongoDB 数据库和日志文件。
sudo rm -r /var/log/mongodb |
sudo rm -r /var/lib/mongodb |
更多信息
默认绑定本地主机
默认情况下,MongoDB 启动时会将bindIp设置为127.0.0.1
,绑定到本地主机网络接口。这意味着mongod
只能接受来自同一计算机上运行的客户端的连接。远程客户端将无法连接到mongod
,并且mongod
将无法初始化副本集,除非将此值设置为可从远程客户端访问的有效网络接口。
该值可通过以下任一方式配置:
-
在 MongoDB 配置文件中使用 bindIp,或
-
通过命令行参数 --bind_ip
警告
将实例绑定到可公开访问的 IP 地址之前,必须保护集群免遭未经授权的访问。有关安全建议的完整列表,请参阅安全检查清单。至少应考虑强化网络基础设施和启用身份验证
有关配置 bindIp 的更多信息,请参阅 IP 绑定。
MongoDB 社区版包
MongoDB Community Edition 可从其专用 存储库获取,并包含以下官方支持的包:
包名称 | 说明 | ||||||
---|---|---|---|---|---|---|---|
| 自动安装下列组件包的 | ||||||
| 自动安装下列组件包的
| ||||||
| 包含 MongoDB Shell (mongosh)。 | ||||||
| 自动安装下列组件包的
|