Docs 菜单
Docs 主页
/
MongoDB Manual
/
自管理部署
/
安装
/
Community Edition
/
在 Linux 上安装

在 Ubuntu 上安装 MongoDB Community Edition

在此页面上

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

Overview

使用本教程安装 MongoDB 8.0Community Edition，方法是使用 apt 包管理器在 Ubuntu Linux 的 LTS（长期支持）版本上进行安装。

MongoDB 版本

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

Considerations

平台支持

MongoDB 8.0 Community Edition 支持以下采用 x86 _64 架构的 64 位 Ubuntu LTS（长期支持）版本：

  • 24.04 LTS ("Noble")

  • 22.04 LTS ("Jammy")

  • 20.04 LTS ("Focal")

MongoDB 仅支持这些平台的 64 位版本。要确定您的主机当前正在运行的 Ubuntu 版本，请在主机的终端上运行以下命令：

cat /etc/lsb-release

MongoDB 8.0 Community Edition（Ubuntu 上）还支持某些平台上的 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-8.0.asc | \
   sudo gpg -o /usr/share/keyrings/mongodb-server-8.0.gpg \
   --dearmor
2

创建列表文件

为您的 Ubuntu 版本创建列表文件 /etc/apt/sources.list.d/mongodb-org-8.0.list。

为 Ubuntu 24.04 (Noble) 创建列表文件：

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu noble/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list

为Ubuntu 22.04 (Jammy) 创建列表文件：

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list

为 Ubuntu 20.04 (Focal) 创建列表文件：

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
3

重新加载包数据库

发出以下命令以重新加载本地软件包数据库：

sudo apt-get update
4

安装 MongoDB Community Server

您可以安装最新稳定版本的 MongoDB 或指定版本的 MongoDB。

要安装最新的稳定版本，请执行以下命令：

sudo apt-get install -y mongodb-org

要安装特定版本，必须单独指定每个组件包以及版本号，如以下示例所示：

sudo apt-get install -y mongodb-org=8.0.0 mongodb-org-database=8.0.0 mongodb-org-server=8.0.0 mongodb-mongosh mongodb-org-mongos=8.0.0 mongodb-org-tools=8.0.0

如果您仅安装mongodb-org=8.0.0并且不包含组件包，则无论您指定哪个版本，都将安装每个 MongoDB 包的最新版本。

可选。虽然您可以指定任意可用版本的 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 Community Edition。这些说明假定您使用的是官方 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) 标签页。


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。

在与 mongod 相同的主机上启动 mongosh 会话。您可以在不使用任何命令行选项的情况下运行 mongosh，从而连接在本地主机上运行且默认端口号为 27017 的 mongod。

mongosh

如需进一步了解使用 mongosh 进行连接（例如连接在其他主机和/或端口上运行的 mongod 实例），请参阅 mongosh 文档。

为了帮助您开始使用 MongoDB，MongoDB 提供了各种驱动程序版本的入门指南。关于驱动程序文档，请参阅 开始使用 MongoDB 开发。

1

启动 MongoDB。

发出以下命令启动 mongod：

sudo service mongod start
2

验证 MongoDB 是否已成功启动

请验证 mongod 进程是否已成功启动：

sudo service mongod status

您还可以在日志文件中查看 mongod 进程的当前状态，默认情况下位于：/var/log/mongodb/mongod.log。正在运行的 mongod 实例将表明它已准备好使用以下行进行连接：

[initandlisten] waiting for connections on port 27017

3

停止 MongoDB。

您可以根据需要，通过发出以下命令来停止 mongod 进程：

sudo service mongod stop
4

重启 MongoDB。

发出以下命令重新启动 mongod：

sudo service mongod restart
5

开始使用 MongoDB。

在与 mongod 相同的主机上启动 mongosh 会话。您可以在不使用任何命令行选项的情况下运行 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-org
自动安装下列组件包的 metapackage。
mongodb-org-database

自动安装下列组件包的 metapackage。

包名称
说明
mongodb-org-server
包含 mongod 守护程序、相关的初始化脚本和配置文件 (/etc/mongod.conf)。您可以使用初始化脚本启动mongod与配置文件。有关详细信息，请参阅上面的“运行 MongoDB 社区版”部分。
mongodb-org-mongos
包含 mongos 守护程序。
mongodb-mongosh
包含 MongoDB Shell (mongosh)。
mongodb-org-tools

自动安装下列组件包的 metapackage：

包名称
说明
mongodb-database-tools
mongodb-org-database-tools-extra
包含 install_compass 脚本

后退

使用 .tgz Tarball 进行安装

来年

使用 .tgz Tarball 进行安装