对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。
Docs 菜单

在 Debian 上安装 MongoDB Enterprise Edition

注意

MongoDB Atlas

MongoDB Atlas is a hosted MongoDB service option in the cloud which requires no installation overhead and offers a free cluster to get started.

使用本教程,在 Windows 上安装 MongoDB 7.0使用 APT 包经理的企业版。

MongoDB Enterprise Edition is available on select platforms and contains support for features related to security and monitoring.

本教程将安装 MongoDB 7.0 Enterprise 版。要安装其他版本的 MongoDB Enterprise,请使用此页面左上角的版本下拉菜单选择该版本的文档。

重要

从Debian 12 开始,基于 apt 的MongoDB 7.0 安装MongoDB存储库中的 Enterprise 失败,因为存储库密钥是 SHA-1,而Debian 12 拒绝使用该密钥。使用MongoDB 7.0Enterprise,请使用 .tgz tarball 安装;如果需要基于 apt 的安装,请使用Debian 11。

MongoDB 7.0 企业版支持 x _8664 架构上的以下 64位 Debian版本:

  • Debian 12 "Bookworm"

  • Debian 11 "Bullseye"

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

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

在生产环境中部署MongoDB之前,请参阅《自管理部署的生产说明》文档,了解性能注意事项和配置建议。

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

重要

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

See MongoDB Enterprise Edition Packages for the complete list of official packages.

按照以下步骤使用 APT 包经理来安装 MongoDB Enterprise Edition 。

1

从终端安装 gnupg 和 curl(如果尚未安装):

sudo apt-get install gnupg curl

要导入 MongoDB 公共 GPG 密钥,请运行以下命令:

curl -fsSL https://pgp.mongodb.com/server-7.0.asc | \
sudo gpg -o /usr/share/keyrings/mongodb-server-7.0.gpg \
--dearmor
2

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

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

echo "deb [ signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] https://repo.mongodb.com/apt/debian bookworm/mongodb-enterprise/7.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-enterprise.list
3

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

sudo apt-get update

重要

从Debian 12 开始,此命令对MongoDB 7.0 失败,因为MongoDB 7.0存储库密钥使用 SHA-1,而Debian 12 拒绝将其用于包签名。

4

要安装最新版本的MongoDB Enterprise Server,请运行以下命令:

sudo apt-get install mongodb-enterprise

注意

您还可以安装使用系统 OpenSSL 的 MongoDB Shell。在安装此版本的 MongoDB Shell 之前,必须先在系统上安装 OpenSSL。

您可以安装所有 MongoDB Enterprise 包以及使用系统 OpenSSL 的 MongoDB Shell,而无需先删除 MongoDB Shell。例如:

sudo apt-get install -y mongodb-enterprise mongodb-mongosh-shared-openssl11

以下示例会删除 MongoDB Shell,然后安装使用系统 OpenSSL 1.1 的 MongoDB Shell:

sudo apt-get remove -y mongodb-mongosh && sudo apt-get install -y
mongodb-mongosh-shared-openssl11

以下示例会删除 MongoDB Shell,然后安装使用系统 OpenSSL 3 的 MongoDB Shell:

sudo apt-get remove -y mongodb-mongosh && sudo apt-get install -y
mongodb-mongosh-shared-openssl3

您还可以选择要安装的 MongoDB 软件包。

下面的示例安装了 MongoDB Enterprise Edition和工具,以及使用系统内 OpenSSL 1.1 的 MongoDB Shell:

sudo apt-get install -y mongodb-enterprise-database
mongodb-enterprise-tools mongodb-mongosh-shared-openssl11

下面的示例安装了 MongoDB Enterprise 版和各种工具,以及使用系统 OpenSSL 3 的 MongoDB Shell:

sudo apt-get install -y mongodb-enterprise-database
mongodb-enterprise-tools mongodb-mongosh-shared-openssl3

默认情况下,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 的用户有访问这些目录的权限。

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

注意

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

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

您可以通过发出以下命令来启动 mongod 进程:

sudo systemctl start mongod

如果收到类似下方的错误(在启动 mongod 时):

Failed to start mongod.service: Unit mongod.service not found.

首先运行以下命令:

sudo systemctl daemon-reload

然后再次运行上面的启动命令。

2
sudo systemctl status mongod

您可以通过选择执行以下命令,来确保 MongoDB 将在系统 重新启动后启动:

sudo systemctl enable mongod
3

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

sudo systemctl stop mongod
4

您可以通过发出以下命令来重启 mongod 进程:

sudo systemctl restart mongod

通过观察 /var/log/mongodb/mongod.log 文件中的输出,可以跟踪错误或重要消息的进程状态。

5

Start a mongosh session on the same host machine as the mongod. You can run mongosh without any command-line options to connect to a mongod that is running on your localhost with default port 27017.

mongosh

For more information on connecting using mongosh, such as to connect to a mongod instance running on a different host and/or port, see the mongosh documentation.

To help you start using MongoDB, MongoDB provides Getting Started Guides in various driver editions. For the driver documentation, see Start Developing with MongoDB.

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

警告

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

1

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

sudo service mongod stop
2

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

sudo apt-get purge mongodb-enterprise*
3

删除 MongoDB 数据库和日志文件。

sudo rm -r /var/log/mongodb
sudo rm -r /var/lib/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.

该值可通过以下任一方式配置:

  • 在 MongoDB 配置文件中使用 bindIp,或

  • 通过命令行参数 --bind_ip

警告

将实例绑定到可公开访问的 IP 地址之前,必须保护集群免遭未经授权的访问。有关安全建议的完整列表,请参阅自管理部署的安全清单。至少应考虑启用身份验证和强化网络基础设施。

有关配置bindIp的详细信息,请参阅自托管部署中的IP绑定。

MongoDB Enterprise 版可从其专用存储库获取,并包含以下官方支持的包:

包名称
说明

mongodb-enterprise

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

mongodb-enterprise-database

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

包名称
说明

mongodb-enterprise-server

包含 mongod 守护进程以及关联的配置和初始化脚本。

mongodb-enterprise-mongos

包含 mongos 守护程序。

mongodb-enterprise-cryptd

包含 mongocryptd 二进制文件

mongodb-mongosh

Contains the MongoDB Shell (mongosh).

mongodb-shared-openssl*

Contains the MongoDB Shell that uses the OpenSSL version already installed on your computer (mongosh).

mongodb-enterprise-tools

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

包名称
说明

mongodb-database-tools

mongodb-enterprise-database-tools-extra

包含以下 MongoDB 支持工具: