文档菜单
文档首页
/
MongoDB 手册
/
自管理部署
/
安装
/
社区版
/
在 Linux 上安装

在 Debian 上安装 MongoDB 社区版

本页内容

  • 概述
  • 注意事项
  • 安装 MongoDB 社区版
  • 运行 MongoDB 社区版
  • 卸载MongoDB社区版
  • 附加信息

注意

MongoDB Atlas

MongoDB Atlas 是一种云托管MongoDB服务选项，无需安装即可使用，并提供免费层以开始使用。

概述

使用本教程安装MongoDB 8.0社区版使用 apt 软件包管理器。

MongoDB 版本

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

注意事项

平台支持

MongoDB 8.0 社区版支持以下内容64位 Debian 版本在x86_64 架构上

  • Debian 12 "Bookworm"

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

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

生产笔记

在生产环境中部署 MongoDB 之前，请考虑自管理部署的生产笔记文档，该文档提供了生产 MongoDB 部署的性能考虑和建议。

官方 MongoDB 软件包

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

重要

由Debian提供的 mongodb 软件包不是由 MongoDB Inc. 维护，并且与官方 mongodb-org 软件包冲突。如果您已经在您的系统上安装了 mongodb 软件包，请按照以下步骤操作： Debian在继续以下说明之前，您必须首先卸载 mongodb 软件包。

请参阅 MongoDB 社区版软件包 获取官方软件包的完整列表。

安装 MongoDB 社区版

按照以下步骤安装 MongoDB社区使用 apt 软件包管理器。

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 社区服务器。

您可以安装最新稳定版本的 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 社区版

ulimit 考虑事项

大多数类Unix操作系统会对进程可使用的系统资源进行限制。这些限制可能会对MongoDB的操作产生负面影响，并且应该进行调整。请参阅针对自托管部署的UNIX ulimit 设置以获取您平台推荐的设置。

注意

如果打开文件数的ulimit值小于64000，MongoDB会生成启动警告。

目录

默认情况下，MongoDB实例存储

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

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

如果您通过软件包管理器安装，这些默认目录将在安装期间创建。

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

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

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

步骤

按照以下步骤运行 MongoDB社区系统版本。这些说明假设您正在使用官方的 mongodb-org 软件包--而不是由提供的不官方的 mongodb 软件包。Debian--并且使用默认设置。

初始化系统

要运行和管理您的 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 时，如果收到类似以下错误

无法启动 mongod.service：未找到单元 mongod.service。

首先运行以下命令

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会话。您可以使用默认端口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] 在端口27017上等待连接

3

停止MongoDB。

如需停止mongod进程，请执行以下命令：

sudo service mongod stop
4

重新启动MongoDB。

执行以下命令来重新启动mongod:

sudo service mongod restart
5

开始使用 MongoDB.

在与mongod相同的宿主机上启动一个mongosh会话。您可以使用默认端口27017连接到在本地主机上运行的mongod，无需任何命令行选项。

mongosh

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

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

卸载 MongoDB 社区版

要完全从系统中删除 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

附加信息

默认绑定到localhost

默认情况下，MongoDB启动时将bindIp设置为127.0.0.1，这意味着它会绑定到本地主机网络接口。这意味着mongod只能接受同一台机器上运行的客户端的连接。远程客户端无法连接到mongod，除非将此值设置为一个有效的网络接口，否则mongod将无法初始化一个副本集。

此值可以通过以下方式配置：

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

  • 通过命令行参数--bind_ip

警告

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

有关配置bindIp的更多信息，请参阅自托管部署中的IP绑定。

MongoDB社区版软件包

MongoDB社区版可以从其专用仓库中获取，并包含以下官方支持的软件包

软件包名称
描述
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 安装