安装 `mongosh`

在此页面上

先决条件

兼容性注意事项
步骤
后续步骤

先决条件

要使用 MongoDB Shell，您必须有一个可供连接的 MongoDB 部署。

对于免费的云托管部署，您可以使用 MongoDB Atlas。
要了解如何运行本地 MongoDB 部署，请参阅安装 MongoDB。

支持的 MongoDB 版本

您可以使用 MongoDB Shell 连接 MongoDB 4.2 或更高版本。

支持的操作系统

您可以在以下操作系统上安装 MongoDB Shell 2.0.0：

操作系统	支持的版本
macOS	11+（x64 和 ARM64）
Microsoft Windows	Microsoft Windows Server 2016+ Microsoft Windows 10+
Linux	Red Hat Enterprise Linux (RHEL) 8+（x64、ARM64、ppc64le 和 s390x） Ubuntu 20.04+ (x64 and ARM64) Amazon Linux 2023 (x64 and ARM64) Amazon Linux 2 (x64 and ARM64) Debian 11+ SLES 15 Oracle Linux 8+ running the Red Hat Compatible Kernel (RHCK). MongoDB Shell does not support the Unbreakable Enterprise Kernel (UEK).

兼容性注意事项

从mongosh 2.0.0 开始：

不支持 Amazon Linux 1、Debian 9 和 macOS 10.14。
Red Hat Enterprise Linux (RHEL) 7、Amazon Linux 2、SUSE Linux Enterprise Server (SLES) 12 和 Ubuntu 18.04 支持已弃用，并且可能会在更高版本的 mongosh 中移除。
如果必须将 Node.js 16 与 mongosh 结合使用，请安装 Node.js，然后通过 npm 安装 mongosh。运行随 npm 安装的 mongosh 以及使用 Node.js 16 的功能，可能会在 mongosh 2.x 的生命周期内移除。

步骤

为您的操作系统选择适当的标签页：

注意

在 Windows 上，mongosh 首选项和配置选项存储在 %APPDATA%/mongodb/mongosh 目录中。

从 MSI 安装

打开 MongoDB Shell 下载页面。

打开“MongoDB 下载中心”。

在 Platform（平台）下拉列表中，选择 Windows 64-bit (8.1+) (MSI)（Windows 64 位 (8.1+) (MSI)）

单击 Download（保存并关闭）。

双击安装程序文件。

按照提示安装 `mongosh`。

从 `.zip` 文件安装

打开 MongoDB Shell 下载页面。

打开“MongoDB 下载中心”。

下载适用于操作系统的 `mongosh` 安装存档。

从 MongoDB 下载中心下载 mongosh。

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

打开 cmd 终端并从具有 mongosh .zip 存档的目录中运行如下命令：

tar -xf mongosh-2.3.8-win32-x64.zip

提取的存档具有一个 bin 文件夹，其中包含两个文件：mongosh.exe 和 mongosh_crypt_v1.dll。

将 `mongosh` 二进制文件添加到您的 `PATH` 环境变量中。

确保提取的 MongoDB Shell 二进制文件位于文件系统中的所需位置，然后将该位置添加到 PATH 环境变量中。

要将 MongoDB Shell 二进制文件的位置添加到 PATH 环境变量中，请执行以下操作：

打开 Control Panel。
在 System and Security 类别中，单击 System。
单击 Advanced system settings。随后会显示 System Properties（系统属性）模式。
单击 Environment Variables（连接）。
在 System variables（系统变量）部分中，选择 Path 并单击 Edit。随后会显示 Edit environment variable（编辑环境变量）模式。
单击 New，并将文件路径添加到 mongosh 二进制文件中。
单击 OK 以确认更改。在每个其他模态框中，单击 OK 以确认更改。

要确认 PATH 环境变量是否已正确配置为查找 mongosh，请打开命令提示符并输入 mongosh --help 命令。如果 PATH 配置正确，则会显示一系列有效命令。

使用 Homebrew 安装

重要

要查看 Homebrew 系统要求的完整列表，请参阅 Homebrew 网站。

Homebrew 包管理器是 macOS 上 mongosh 的推荐安装方法。要了解如何改为从存档手动安装 mongosh，请参阅从 .zip 文件安装。

Considerations

使用 Homebrew 安装的 mongosh 不支持客户端字段级自动加密。

步骤

要使用 Homebrew 安装mongosh ：

安装 Homebrew。

有关在 macOS 上安装 Homebrew 的步骤，请参阅 Homebrew 网站。

安装 `mongosh` 包。

从终端发出以下命令以安装mongosh包：

brew install mongosh

从 `.zip` 文件安装

要使用下载的.zip文件手动安装mongosh ：

打开 MongoDB Shell 下载页面。

打开“MongoDB 下载中心”。

下载适用于操作系统的 `mongosh` 安装存档。

下载适合您操作系统的mongosh版本。 MongoDB 提供适用于 Intel 和 ARM 架构的mongosh版本。

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

Go到包含mongosh .zip存档的目录，然后解压缩.zip文件。

如果您的计算机基于 Intel，请运行：

unzip mongosh-2.3.8-darwin-x64.zip

如果您的计算机基于 ARM（M1 或 M2），请运行：

unzip mongosh-2.3.8-darwin-arm64.zip

提取的存档具有一个 bin 文件夹，其中包含两个文件：mongosh 和 mongosh_crypt_v1.dylib。

如果您的网络浏览器在下载过程中自动提取存档文件，或者提取存档文件时未使用unzip命令，则可能需要将二进制文件设为可执行文件。

要使二进制可执行文件，请在提取存档的目录中运行以下命令：

chmod +x bin/mongosh

将下载的二进制文件添加到 `PATH` 环境变量中。

您可以执行以下任一操作：

将mongosh二进制文件复制到PATH变量中列出的目录中，例如/usr/local/bin 。从提取下载文件的目录运行以下命令：
```
sudo cp mongosh /usr/local/bin/
sudo cp mongosh_crypt_v1.so /usr/local/lib/
```
创建指向MongoDB Shell的符号链接。切换到您从.tgz存档中解压缩文件的目录。运行以下命令，创建指向PATH中已有目录的链接，例如/usr/local/bin 。
```
sudo ln -s $(pwd)/bin/* /usr/local/bin/
```

允许 macOS 运行 `mongosh`。

macOS 可能会阻止mongosh在安装后运行。如果在启动mongosh时出现安全错误，表明无法识别或验证开发者的身份，请执行以下操作：

打开“系统偏好设置” 。
选择“安全和隐私”窗格。
在常规标签页下，单击有关mongosh的消息右侧的按钮，该按钮标记为Open Anyway或Allow Anyway ，具体取决于您的 macOS 版本。

根据 Linux 发行版和所需的软件包从以下标签页中选择适当的标签页：

要在 Ubuntu 22.04 (Jammy)、Ubuntu 20.04 (Focal)、Ubuntu 18.04 (Bionic) 或 Debian 上安装.deb软件包，请单击.deb标签页。
要在 RHEL、Amazon Linux2023 或 Amazon Linux2 上安装 .rpm 软件包，请单击 .rpm 标签页。
要安装 .tgz Tarball，请单击 .tgz 标签页。

支持的平台

mongosh 可作为 PPA 用于以下平台：

Ubuntu 24.04 (Noble Numbat)
Ubuntu 22.04 (Jammy)
Ubuntu 20.04 (Focal)
Ubuntu 18.04（仿生）

步骤

导入包管理系统使用的公钥。

从终端发出以下命令，以便从 https://www.mongodb.org/static/pgp/server-8.0.asc 导入 MongoDB 公共 GPG 密钥：

wget -qO- https://www.mongodb.org/static/pgp/server-8.0.asc | sudo tee /etc/apt/trusted.gpg.d/server-8.0.asc

上一条命令将 GPG 密钥写入系统的/etc/apt/trusted.gpg.d文件夹，并将密钥打印到终端。您无需复制或保存打印到终端的密钥。

如果收到错误消息，指示未安装gnupg ，请执行以下步骤：

使用以下命令安装gnupg及其所需的库：
```
sudo apt-get install gnupg
```
重试导入密钥：
```
wget -qO- https://www.mongodb.org/static/pgp/server-8.0.asc | sudo tee /etc/apt/trusted.gpg.d/server-8.0.asc
```

为 MongoDB 创建列表文件。

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

单击与您的 Ubuntu 版本对应的相应标签页。如果不确定主机运行的 Ubuntu 版本，请在主机上打开终端或 Shell 并运行lsb_release -dc 。

以下说明适用于Ubuntu24.04 (Noble Numbat)。对于其他Ubuntu版本，请单击相应的标签页。

为Ubuntu 24.04 (Noble Numbat) 创建 /etc/apt/sources.list.d/mongodb-org-8.0.list文件：

echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu noble/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list

以下说明适用于Ubuntu 22.04 (Jammy) 。对于其他 Ubuntu 版本，请单击相应的标签页。

为 Ubuntu 22.04 (Jammy) 创建 /etc/apt/sources.list.d/mongodb-org-8.0.list 文件：

echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list

以下指令适用于 Ubuntu 20.04（焦点）。对于其他 Ubuntu 版本，请单击相应的标签页。

为 Ubuntu 20.04 (Focal) 创建/etc/apt/sources.list.d/mongodb-org-8.0.list文件：

echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list

以下说明适用于 Ubuntu 18.04 (Bionic)。对于其他 Ubuntu 版本，请单击相应的标签页。

为 Ubuntu 18.04 (Bionic) 创建 /etc/apt/sources.list.d/mongodb-org-8.0.list 文件：

echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu bionic/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list

重新加载本地包数据库。

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

sudo apt-get update

安装 `mongosh` 包。

mongosh 支持 OpenSSL。您也可以将 mongosh 配置为使用系统的 OpenSSL 安装。

要安装附带 OpenSSL 库的最新稳定版本的mongosh ，请执行以下操作：

sudo apt-get install -y mongodb-mongosh

要安装带有 OpenSSL 1.1 库的mongosh ：

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

要安装带有 OpenSSL 3.0 库的mongosh ：

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

确认 `mongosh` 安装成功。

要确认mongosh已成功安装，请运行以下命令：

mongosh --version

您的终端应使用您已安装的mongosh版本进行响应。

支持的平台

mongosh 可作为 yum 包用于以下平台：

RHEL
Amazon Linux 2023
Amazon Linux 2

步骤

配置软件包管理系统 (`yum`)。

创建 /etc/yum.repos.d/mongodb-org-8.0.repo 文件，以便使用 yum 直接安装 mongosh。

RHEL 和 Amazon Linux 有 .rpm 个发行版。

选择标签页，为您的发行版选择文件。
复制标签页的内容。
将内容粘贴到 .repo 文件中。

[mongodb-org-8.0]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/8.0/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-8.0.asc

也可以直接从 MongoDB 存储库下载 .rpm 文件。下载按以下顺序排列：

Red Hat 或 CentOS 版本（例如，8）
MongoDB 版本（例如mongodb-enterprise）
MongoDB 发布版本（例如，8.0）
架构（例如，x86_64）

[mongodb-org-8.0]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/amazon/2023/mongodb-org/8.0/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-8.0.asc

注意

如果您的系统使用 Amazon Linux 2，请将 baseurl 中的 2023 替换为 2。

也可以直接从 MongoDB 存储库下载 .rpm 文件。下载按以下顺序排列：

Amazon Linux 版本（例如 2023）
MongoDB 发布版本（例如，8.0）
架构（例如，x86_64）

安装`mongosh` 。

mongosh 支持 OpenSSL。您也可以将 mongosh 配置为使用系统的 OpenSSL 安装。

要安装附带 OpenSSL 库的最新稳定版本的mongosh ，请执行以下操作：

sudo yum install -y mongodb-mongosh

要安装带有 OpenSSL 1.1 库的mongosh ：

sudo yum install -y mongodb-mongosh-shared-openssl11

要安装带有 OpenSSL 3.0 库的mongosh ：

sudo yum install -y mongodb-mongosh-shared-openssl3

步骤

打开 MongoDB Shell 下载页面。

打开“MongoDB 下载中心”。

下载 Linux 64 位 `.tgz` 软件包。

下载适合您操作系统的mongosh版本。 MongoDB 还提供使用系统 OpenSSL 安装的mongosh版本。

请参阅 MongoDB 下载中心。

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

转到包含.tgz存档的目录，然后解压缩存档。

.tgz软件包的名称因您下载的版本而异。将以下命令中的.tgz包名称替换为您下载的包名称，然后运行该命令。

tar -zxvf mongosh-2.3.8-linux-x64.tgz

提取的存档具有一个 bin 文件夹，其中包含两个文件：mongosh 和 mongosh_crypt_v1.so。

如果您的网络浏览器在下载过程中自动提取存档文件，或者提取存档文件时未使用tar命令，则可能需要将二进制文件设为可执行文件。

要使二进制可执行文件，请在提取存档的目录中运行以下命令：

chmod +x bin/mongosh

将下载的二进制文件添加到 `PATH` 环境变量中。

您可以执行以下任一操作：

将mongosh二进制文件复制到PATH变量中列出的目录中，例如/usr/local/bin 。从提取下载文件的目录运行以下命令：
```
sudo cp mongosh /usr/local/bin/
sudo cp mongosh_crypt_v1.so /usr/local/lib/
```
创建指向MongoDB Shell的符号链接。切换到您从.tgz存档中解压缩文件的目录。运行以下命令，创建指向PATH中已有目录的链接，例如/usr/local/bin 。
```
sudo ln -s $(pwd)/bin/* /usr/local/bin/
```

后续步骤

成功安装 mongosh 后，学习如何连接到 MongoDB 部署。

MongoDB 提供了可通过程序访问的 mongosh下载列表，可通过应用程序进行访问。

后退

欢迎使用 MongoDB Shell (mongosh)

来年

验证包的完整性

先决条件

支持的 MongoDB 版本

支持的操作系统

兼容性注意事项

步骤

注意

从 MSI 安装

打开 MongoDB Shell 下载页面。

在 .css-h15tq0{font-style:normal;font-weight:700;}Platform（平台）下拉列表中，选择 Windows 64-bit (8.1+) (MSI)（Windows 64 位 (8.1+) (MSI)）

单击 Download（保存并关闭）。

双击安装程序文件。

按照提示安装 mongosh。

从 .zip 文件安装

打开 MongoDB Shell 下载页面。

下载适用于操作系统的 mongosh 安装存档。

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

将 mongosh 二进制文件添加到您的 PATH 环境变量中。

使用 Homebrew 安装

重要

Considerations

步骤

安装 Homebrew。

安装 mongosh 包。

从 .zip 文件安装

打开 MongoDB Shell 下载页面。

下载适用于操作系统的 mongosh 安装存档。

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

将下载的二进制文件添加到 PATH 环境变量中。

允许 macOS 运行 mongosh。

支持的平台

步骤

导入包管理系统使用的公钥。

为 MongoDB 创建列表文件。

重新加载本地包数据库。

安装 mongosh 包。

确认 mongosh 安装成功。

支持的平台

步骤

配置软件包管理系统 (yum)。

注意

安装mongosh 。

步骤

打开 MongoDB Shell 下载页面。

下载 Linux 64 位 .tgz 软件包。

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

将下载的二进制文件添加到 PATH 环境变量中。

后续步骤

在 Platform（平台）下拉列表中，选择 Windows 64-bit (8.1+) (MSI)（Windows 64 位 (8.1+) (MSI)）

按照提示安装 `mongosh`。

从 `.zip` 文件安装

下载适用于操作系统的 `mongosh` 安装存档。

将 `mongosh` 二进制文件添加到您的 `PATH` 环境变量中。

安装 `mongosh` 包。

从 `.zip` 文件安装

下载适用于操作系统的 `mongosh` 安装存档。

将下载的二进制文件添加到 `PATH` 环境变量中。

允许 macOS 运行 `mongosh`。

安装 `mongosh` 包。

确认 `mongosh` 安装成功。

配置软件包管理系统 (`yum`)。

安装`mongosh` 。

下载 Linux 64 位 `.tgz` 软件包。

将下载的二进制文件添加到 `PATH` 环境变量中。