在 Debian 上安装 MongoDB Community Edition
在此页面上
Overview
使用本教程安装 MongoDB 5.0 使用 apt 包管理器的MongoDB Community Edition 。
MongoDB 版本
本教程将安装 MongoDB 5.0 MongoDB Community Edition。要安装不同版本的 MongoDB Community，请使用此页面左上角的版本下拉菜单选择该版本的文档。
Considerations
平台支持
MongoDB 5.0 Community Edition 支持以下基于 x86_64 架构的 64-位 Debian 版本：
Debian 11 "Bullseye" (5.0.8+)
Debian 10 "Buster"
Debian 9 "Stretch"
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。
创建列表文件。
为您的Debian版本创建列表文件/etc/apt/sources.list.d/mongodb-org-5.0.list。
为Debian 12 (Bookworm) 创建列表文件：
echo "deb [ signed-by=/usr/share/keyrings/mongodb-server-5.0.gpg ] http://repo.mongodb.org/apt/debian bookworm/mongodb-org/5.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-5.0.list
为Debian 11 (Bullseye) 创建列表文件：
echo "deb [ signed-by=/usr/share/keyrings/mongodb-server-5.0.gpg ] http://repo.mongodb.org/apt/debian bullseye/mongodb-org/5.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-5.0.list
为Debian 10 (Stretch) 创建列表文件：
echo "deb [ signed-by=/usr/share/keyrings/mongodb-server-5.0.gpg ] http://repo.mongodb.org/apt/debian stretch/mongodb-org/5.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-5.0.list
安装MongoDB Community Server。
您可以安装最新稳定版本的 MongoDB 或指定版本的 MongoDB。
要安装最新的稳定版本，请执行以下命令：
sudo apt-get install -y mongodb-org
要安装特定版本，必须单独指定每个组件包以及版本号，如以下示例所示：
sudo apt-get install -y mongodb-org=5.0.29 mongodb-org-database=5.0.29 mongodb-org-server=5.0.29 mongodb-org-shell=5.0.29 mongodb-org-mongos=5.0.29 mongodb-org-tools=5.0.29
如果您仅安装mongodb-org=5.0.29并且不包含组件包，则无论您指定哪个版本，都将安装每个 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
mkdir -p <directory>或sudo mkdir -p <directory>创建目录，具体取决于将运行 MongoDB 的用户。（有关mkdir和sudo的信息，请参阅 Linux 手册页。）默认情况下，MongoDB 使用mongodb用户帐户运行。 如果更改运行 MongoDB 进程的用户，还 必须 修改/var/lib/mongodb和/var/log/mongodb目录的权限，为该用户授予这些目录的访问权限。要指定不同的日志文件目录和数据文件目录，请编辑 中的systemLog.path和storage.dbPath/etc/mongod.conf设置。确保运行 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) 标签页。
启动 MongoDB。
您可以通过发出以下命令来启动 mongod 进程：
sudo systemctl start mongod
如果收到类似下方的错误（在启动 mongod 时）：
Failed to start mongod.service: Unit mongod.service not found.
首先运行以下命令：
sudo systemctl daemon-reload
然后再次运行上面的启动命令。
停止 MongoDB。
您可以根据需要，通过发出以下命令来停止 mongod 进程：
sudo systemctl stop mongod
重启 MongoDB。
您可以通过发出以下命令来重启 mongod 进程：
sudo systemctl restart mongod
通过观察 /var/log/mongodb/mongod.log 文件中的输出，可以跟踪错误或重要消息的进程状态。
开始使用 MongoDB。
在与 mongod 相同的主机上启动 mongosh 会话。您可以在不使用任何命令行选项的情况下运行 mongosh，从而连接在本地主机上运行且默认端口号为 27017 的 mongod。
mongosh
如需进一步了解使用 mongosh 进行连接（例如连接在其他主机和/或端口上运行的 mongod 实例），请参阅 mongosh 文档。
为了帮助您开始使用 MongoDB，MongoDB 提供了各种驱动程序版本的入门指南。关于驱动程序文档，请参阅 开始使用 MongoDB 开发。
启动 MongoDB。
发出以下命令启动 mongod：
sudo service mongod start
停止 MongoDB。
您可以根据需要，通过发出以下命令来停止 mongod 进程：
sudo service mongod stop
重启 MongoDB。
发出以下命令重新启动 mongod：
sudo service mongod restart
开始使用 MongoDB。
在与 mongod 相同的主机上启动 mongosh 会话。您可以在不使用任何命令行选项的情况下运行 mongosh，从而连接在本地主机上运行且默认端口号为 27017 的 mongod。
mongosh
如需进一步了解使用 mongosh 进行连接（例如连接在其他主机和/或端口上运行的 mongod 实例），请参阅 mongosh 文档。
为了帮助您开始使用 MongoDB，MongoDB 提供了各种驱动程序版本的入门指南。关于驱动程序文档，请参阅 开始使用 MongoDB 开发。
卸载 MongoDB Community Edition
要从系统中完全删除 MongoDB，您必须删除 MongoDB 应用程序本身、配置文件以及任何包含 数据和日志的目录。以下部分将指导您完成所需的步骤。
警告
此过程将完全删除 MongoDB、其配置以及所有数据库。此过程不可逆，因此请确保在继续之前备份所有配置和数据。
停止 MongoDB。
通过发出以下命令来停止 mongod 进程：
sudo service mongod stop
更多信息
默认绑定本地主机
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.
该值可通过以下任一方式配置：
警告
在绑定到非本地主机（例如 可公开访问的） IP解决，确保已保护集群免遭未经授权的访问权限。 有关安全建议的完整列表，请参阅自托管部署的安全检查清单。 至少应考虑启用身份验证并强化网络基础架构。
有关配置bindIp的详细信息，请参阅自托管部署中的IP绑定。
MongoDB 社区版包
MongoDB Community Edition 可从其专用 存储库获取，并包含以下官方支持的包：
包名称 | 说明 | ||||||
|---|---|---|---|---|---|---|---|
mongodb-org | 自动安装下列组件包的 metapackage。 | ||||||
mongodb-org-database | |||||||
mongodb-mongosh | 包含 MongoDB Shell ( mongosh)。 | ||||||
mongodb-org-tools | 自动安装下列组件包的
|