在 Ubuntu 上安装 MongoDB 社区版

笔记

MongoDB atlas

MongoDB atlas 是云中托管的 MongoDB 服务选项，无需安装开销，并提供免费套餐以供入门。

概述

使用本教程使用apt包管理器在 Ubuntu Linux 的 LTS（长期支持）版本上 安装 MongoDB 7.0 Community Edition。

MongoDB 版本

本教程安装 MongoDB 7.0 Community Edition。要安装不同版本的 MongoDB Community ，请使用此页面左上角的版本下拉菜单选择该版本的文档。

注意事项

平台支持

MongoDB 7.0 社区版支持 x86_64 架构上的以下 64 位 Ubuntu LTS（长期支持）版本：

• 22.04 LTS ("Jammy")
• 20.04 LTS ("Focal")

MongoDB 仅支持这些平台的 64 位版本。

Ubuntu 上的 MongoDB 7.0 社区版还支持特定平台上的 ARM64 架构。

有关详细信息，请参阅平台支持。

制作说明

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

官方 MongoDB 包

要在您的Ubuntu系统上安装 MongoDB Community ，这些说明将使用由 MongoDB Inc 维护和支持的官方包。官方 包始终包含最新版本的 MongoDB，并且可以从其自己的专用存储库中获得。mongodb-org``mongodb-org

重要

Ubuntu提供的mongodb包不是 MongoDB Inc.维护的，与官方 mongodb-org包有冲突。如果您已经在Ubuntu系统 上安装了mongodb软件包，则必须先卸载mongodb软件包，然后才能继续执行这些说明。

看MongoDB 社区版包官方软件包的完整列表

安装 MongoDB 社区版

按照以下步骤使用apt包管理器安装 MongoDB Community Edition 。

导入包管理系统使用的公钥。

从终端发出以下命令以从中导入 MongoDB 公共 GPG 密钥 https://www.mongodb.org/static/pgp/server-7.0.asc：

wget -qO - https://www.mongodb.org/static/pgp/server-7.0.asc | sudo apt-key add -

该操作应以OK.

但是，如果您收到指示gnupg未安装的错误消息，您可以：

1. 使用以下命令安装gnupg及其所需的库：

   sudo apt-get install gnupg
   

1. 安装后，重试导入密钥：

   wget -qO - https://www.mongodb.org/static/pgp/server-7.0.asc | sudo apt-key add -
   

为 MongoDB 创建一个列表文件。

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

单击适合您的 Ubuntu 版本的选项卡。如果您不确定主机运行的是哪个 Ubuntu 版本，请在主机上打开终端或 shell 并执行lsb_release -dc.

以下说明适用于Ubuntu 22.04 (Jammy)。

/etc/apt/sources.list.d/mongodb-org-7.0.list 为 Ubuntu 22.04 (Jammy)创建 文件：

echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list

以下说明适用于Ubuntu 20.04 (Focal)。

/etc/apt/sources.list.d/mongodb-org-7.0.list 为 Ubuntu 20.04 (Focal)创建 文件：

echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list

重新加载本地包数据库。

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

sudo apt-get update

安装 MongoDB 包。

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

安装最新稳定版本的 MongoDB

要安装最新的稳定版本，请发出以下命令

sudo apt-get install -y mongodb-org

特定版本的 MongoDB

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

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

如果您只安装mongodb-org=7.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 社区版

• ulimit 注意事项

  大多数类 Unix 操作系统限制进程可能使用的系统资源。这些限制可能会对 MongoDB 操作产生负面影响，应该进行调整。有关为您的平台推荐的设置，请参阅UNIXulimit设置。笔记ulimit从 MongoDB 4.4 开始，如果打开文件数的值小于 ，则会生成启动错误 64000。

• 目录

  如果您是通过包管理器安装的，数据目录 /var/lib/mongodb和日志目录/var/log/mongodb是在安装过程中创建的。默认情况下，MongoDB 使用mongodb用户帐户运行。如果更改运行 MongoDB 进程的用户，则还必须修改对数据和日志目录的权限，以授予该用户访问这些目录的权限。

• 配置文件

  官方 MongoDB 包中包含一个配置文件( /etc/mongod.conf)。这些设置（例如数据目录和日志目录规范）在启动时生效。也就是说，如果在MongoDB实例运行时更改配置文件，必须重启实例才能使更改生效。

程序

按照以下步骤在您的系统上运行 MongoDB Community Edition。这些说明假定您使用的是官方包——而不是Ubuntu提供mongodb-org 的非官方mongodb包 ——并且使用的是默认设置。

初始化系统

要运行和管理您的mongod进程，您将使用操作系统的内置初始化系统。最新版本的 Linux 倾向于使用systemd（使用systemctl命令），而旧版本的 Linux 倾向于使用System V init（使用service命令）。

如果您不确定您的平台使用哪个 init 系统，请运行以下命令：

ps --no-headers -o comm 1

然后根据结果选择下面适当的选项卡：

• systemd- 选择下面的systemd (systemctl)选项卡。
• init- 选择下面的System V Init（服务）选项卡。

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与 mongod 在同一台主机上的会话。你可以跑mongosh 没有任何命令行选项来连接到 mongod在默认端口 27017 上运行的本地主机上。

mongosh

System V Init（服务）

1、启动 MongoDB。

发出以下命令来启动mongod：

sudo service mongod start

2、验证MongoDB是否启动成功

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

sudo service mongod status

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

3、停止 MongoDB。

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

sudo service mongod stop

4、重新启动 MongoDB

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

sudo service mongod restart

5、开始使用 MongoDB。

开始一个mongosh会话与 mongod. 你可以运行mongosh 没有任何命令行选项来连接到 mongod在本地主机上运行的默认端口 27017。

mongosh

有关使用连接的更多信息mongosh，例如连接到mongod在不同主机和/或端口上运行的实例，请参阅 mongosh文档。

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

卸载 MongoDB 社区版

要从系统中完全删除 MongoDB，您必须删除 MongoDB 应用程序本身、配置文件以及任何包含数据和日志的目录。以下部分将指导您完成必要的步骤。

警告

此过程将完全删除 MongoDB、其配置和所有 数据库。此过程不可逆，因此请确保在继续之前备份所有配置和数据。

停止 MongoDB。

mongod通过发出以下命令停止进程：

sudo service mongod stop

删除包。

删除您之前安装的所有 MongoDB 包。

sudo apt-get purge mongodb-org*

删除数据目录。

删除 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

WARNING

在绑定到非本地主机（例如可公开访问的）IP 地址之前，请确保您已保护集群免受未经授权的访问。有关安全建议的完整列表，请参阅 安全清单。至少，考虑 启用身份验证和 强化网络基础设施。

有关配置的详细信息bindIp，请参阅 IP 绑定。

MongoDB 社区版包

MongoDB Community Edition 可从其自己的专用存储库获得，并包含以下官方支持的包：

原文链接 -https://www.mongodb.com/docs/v7.0/tutorial/install-mongodb-on-ubuntu/

译者：韩鹏帅