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

在 Debian 上安装 MongoDB Community Edition

在此页面上

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

注意

MongoDB Atlas

MongoDB Atlas 是在云中托管的 MongoDB 服务选项，无需安装开销，并提供免费套餐，可以立即开始使用。

Overview

使用本教程安装 MongoDB 8.0 使用 apt 包管理器的MongoDB Community Edition 。

MongoDB 版本

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

Considerations

平台支持

MongoDB 8.0 Community Edition 支持以下基于 x86_64 架构的 64-位 Debian 版本：

  • Debian 12 "Bookworm"

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

更多信息，请参阅平台支持。

生产说明

在生产环境中部署 MongoDB 之前，请参阅自管理部署的生产注意事项文档，其中提供了有关生产环境中 MongoDB 部署的性能注意事项和配置建议。

官方 MongoDB 软件包

要在 Debian 系统上安装 MongoDB Community Edition，以下说明将使用由 MongoDB Inc. 维护和支持的官方 mongodb-org 软件包。官方 mongodb-org 软件包始终包含最新版本的 MongoDB，并且可以从其专用存储库中获取。

重要

Debian 提供的mongodb软件包不是由 MongoDB Inc. 维护的，并且与官方的mongodb-org软件包冲突。如果您已在 Debian 系统上安装了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

创建列表文件。

为Debian 12 (Bookworm) 创建列表文件：

echo "deb [ signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] http://repo.mongodb.org/apt/debian bookworm/mongodb-org/8.0 main" | 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

运行 MongoDB Community Edition

ulimit 注意事项

大多数类 Unix 操作系统都会限制进程可以使用的系统资源。 这些限制可能会对MongoDB操作产生负面影响，应该进行调整。 有关平台的建议设置，请参阅自管理部署的 UNIX ulimit设置。

注意

如果打开文件数的 ulimit 值低于 64000，MongoDB 会生成初创企业警告。

目录

默认情况下，MongoDB 实例存储：

  • 其数据文件于 /var/lib/mongodb

  • 其日志文件于 /var/log/mongodb

如果通过包管理器进行安装，则会在安装过程中创建这些默认目录。

如果您通过下载 tarball 手动安装，则可以使用 mkdir -p <directory> 或 sudo mkdir -p <directory> 创建目录，具体取决于将运行 MongoDB 的用户。（有关 mkdir 和 sudo 的信息，请参见您的 linux 手册页。）

默认情况下，MongoDB 使用 mongodb 用户账户运行。如果更改运行 MongoDB 进程的用户，还必须修改 /var/lib/mongodb 和 /var/log/mongodb 目录，以赋予该用户访问这些目录的权限。

要指定不同的日志文件目录和数据文件目录，请编辑 /etc/mongod.conf 中的 systemLog.path 和 storage.dbPath 设置。确保运行 MongoDB 的用户有访问这些目录的权限。

步骤

请按照以下步骤在系统上运行 MongoDB 社区版。 这些说明假定您使用的是官方 mongodb-org 软件包，而不是由 Debian 提供的非官方 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 脚本

后退

Ubuntu 安装故障排查

来年

使用 .tgz Tarball 进行安装