Docs 菜单
Docs 主页
/
数据库手册
/
自管理部署
/
安装
/
Community Edition
/
在 Linux 上安装
/
在 Debian 上安装

使用 .tgz Tarball 在 Debian 上安装 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.10.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 上安装

在此页面上