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

使用 .tgz Tarball 在 Debian 上安装 MongoDB Community Edition

在此页面上

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

Overview

使用本教程手动安装 MongoDB 8.0 MongoDB Community Edition上的DebianLinux ，使用下载的.tgz tarball。

MongoDB 版本

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

安装方法

虽然可按本文档所述方法通过下载的 .tgz Tarball 手动安装 MongoDB，但可能时仍建议在您的系统上使用 apt 包管理器来安装 MongoDB。使用包管理器会自动安装所需的全部依赖项，提供 mongod.conf 示例文件来帮助您入门，并简化未来的升级和维护任务。

➤ 有关说明，请参阅使用 apt 包经理安装MongoDB 。

Considerations

MongoDB Shell、 mongosh

使用 .tgz 包安装服务器时，您需要按照 mongosh 安装说明，单独下载和安装 mongosh。

平台支持

MongoDB 8.0 MongoDB Community Edition支持64 Debianx86 _64 架构上的以下 位 版本：

  • Debian 12 "Bookworm"

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

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

生产说明

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

安装 MongoDB Community Edition

先决条件

使用以下命令安装 MongoDB Community Edition .tgz Tarball 所需的依赖项：

sudo apt-get install libcurl4 libgssapi-krb5-2 libldap-common libwrap0 libsasl2-2 libsasl2-modules libsasl2-modules-gssapi-mit openssl liblzma5

步骤

请按照以下步骤从 .tgz 手动安装 MongoDB Community Edition。

1

下载 tarball。

安装所需的必备包后，请从以下链接下载 MongoDB Community tgz tarball：

➤ MongoDB 下载中心

  1. 在 Version 下拉列表中选择要下载的 MongoDB 版本。

  2. 在 Platform 下拉菜单中，选择您操作系统的版本和架构。

  3. 在 Package 下拉菜单中，选择 tgz。

  4. 单击 Download（连接）。

2

从下载的存档中提取文件。

例如，从系统 shell 中，您可以使用 tar 命令进行提取：

tar -zxvf mongodb-linux-*-8.0.0.tgz
3

确保二进制文件位于 PATH 环境变量中列出的目录下。

MongoDB 二进制文件位于 tarball 的 bin/ 目录中。您可以执行以下任一操作：

  • 将二进制文件复制到 PATH 变量中列出的目录中，例如 /usr/local/bin（根据需要使用您的安装目录来更新 /path/to/the/mongodb-directory/）

    sudo cp /path/to/the/mongodb-directory/bin/* /usr/local/bin/

  • 创建指向 PATH 变量中所列目录的二进制文件的符号链接，例如 /usr/local/bin（根据需要使用您的安装目录更新 /path/to/the/mongodb-directory/）：

    sudo ln -s  /path/to/the/mongodb-directory/bin/* /usr/local/bin/
4

安装 MongoDB Shell (mongosh)。

安装 mongosh 然后使用 MongoDB Shell 连接到您的部署。

从 MongoDB 下载中心下载所需 mongosh 版本的对应包，并将其解压。

运行 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 Community Edition。 这些说明假设您使用的是默认设置。

1

创建数据和日志目录。

创建 MongoDB 实例存储其数据的目录。例如：

sudo mkdir -p /var/lib/mongo

创建 MongoDB 实例用于存储日志的目录。例如：

sudo mkdir -p /var/log/mongodb

启动 MongoDB 进程的用户必须具有对这些目录的读取和写入权限。例如，如果你打算自己运行 MongoDB：

sudo chown `whoami` /var/lib/mongo     # Or substitute another user
sudo chown `whoami` /var/log/mongodb   # Or substitute another user
2

运行 MongoDB。

要运行 MongoDB，请在系统提示符下运行 mongod 进程。

mongod --dbpath /var/lib/mongo --logpath /var/log/mongodb/mongod.log --fork

有关命令行选项 --dbpath 和 --logpath 的详情，请参阅选项。

3

验证 MongoDB 是否已成功启动。

检查日志文件 /var/log/mongodb/mongod.log 中以下行的进程输出，验证 MongoDB 是否成功启动：

[initandlisten] waiting for connections on port 27017

可能会在进程输出中看到非严重警告。只要看到上述日志行，便可在 MongoDB 初次计算期间安心地忽略这些警告。

4

开始使用 MongoDB。

在与 mongod 相同的主机上启动 mongosh 会话。您可以在不使用任何命令行选项的情况下运行 mongosh，从而连接在本地主机上运行且默认端口号为 27017 的 mongod。

mongosh

如需进一步了解使用 mongosh 进行连接（例如连接在其他主机和/或端口上运行的 mongod 实例），请参阅 mongosh 文档。

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

更多信息

默认绑定本地主机

默认情况下，MongoDB 会以将 bindIp 设为 127.0.0.1 来启动，从而绑定到本地主机网络接口。这意味着 mongod 只能接受来自同一计算机上运行的客户端的连接。远程客户端无法连接到 mongod，且 mongod 无法初始化副本集，除非将此值设为有效的网络接口。

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

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

  • 通过命令行参数 --bind_ip

警告

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

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

后退

在 Debian 上安装

来年

在 SUSE 上安装