文档菜单
文档首页
/
MongoDB Shell

安装mongosh

本页面

  • 先决条件
  • 兼容性考虑
  • 步骤
  • 下一步

先决条件

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

  • 对于免费云托管部署，您可以使用MongoDB Atlas.

  • 要了解如何运行本地 MongoDB 部署，请参阅 安装 MongoDB。

支持的 MongoDB 版本

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

支持的操作系统

您可以在这些操作系统上安装 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 和 ARM64)
Amazon Linux 2023 (x64 和 ARM64)
Amazon Linux 2 (x64 和 ARM64)
Debian 11+
SLES 15
Oracle Linux 8+ 运行 Red Hat 兼容内核 (RHCK)。MongoDB Shell 不支持不可破坏的企业内核 (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。在 mongosh 2.x 的生命周期内，可能移除使用通过 npm 安装的 mongosh 和使用 Node.js 16 的能力。

步骤

选择适合您的操作系统的相应选项卡

注意

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

从MSI安装

1

打开MongoDB Shell下载页面。

打开MongoDB下载中心。

2

在平台下拉菜单中，选择Windows 64位（8.1+）（MSI）

3

点击 下载。

4

双击安装文件。

5

按照提示安装 mongosh。

从 .zip 文件安装

1

打开MongoDB Shell下载页面。

打开MongoDB下载中心。

2

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

从MongoDB下载中心下载mongosh。

3

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

打开一个cmd终端，并从包含mongosh .zip存档的目录中运行以下命令

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

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

4

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

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

要将MongoDB Shell二进制文件的位置添加到您的 PATH 环境变量中

  1. 打开 控制面板。

  2. 在 系统和安全类别中，单击 系统。

  3. 单击 高级系统设置。显示 系统属性 对话框。

  4. 单击 环境变量。

  5. 在 系统变量 部分，选择 Path 并单击 编辑。显示 编辑环境变量 对话框。

  6. 单击 新建 并添加您的 mongosh 二进制文件的文件路径。

  7. 单击 确定 以确认更改。在其他每个对话框中，单击 确定 以确认更改。

为了确认您的 PATH 环境变量是否正确配置以查找 mongosh，请打开命令提示符并输入 mongosh --help 命令。如果您的 PATH 已正确配置，将显示有效命令列表。

使用 Homebrew 安装

重要

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

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

考虑事项

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

程序

使用 Homebrew 安装 mongosh

1
安装Homebrew.

请参考Homebrew网站查看在macOS上安装Homebrew的步骤。

2
安装mongosh包。

在终端中运行以下命令以安装mongosh包

brew install mongosh

从 .zip 文件安装

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

1

打开 MongoDB Shell 下载页面。

打开MongoDB下载中心。

2

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

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

3

从下载的压缩文件中提取文件。

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

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

unzip mongosh-2.3.2-darwin-x64.zip

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

unzip mongosh-2.3.2-darwin-arm64.zip

提取的压缩文件中有一个 bin 文件夹，其中包含两个文件，mongosh 和 mongosh_crypt_v1.dylib。

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

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

chmod +x bin/mongosh
4

将下载的二进制文件添加到您的 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/
5

允许 macOS 运行 mongosh。

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

  1. 打开 系统偏好设置。

  2. 选择 安全和隐私 选项卡。

  3. 在 常规 选项卡下，点击有关 mongosh 的消息右侧的按钮，按钮标签为“任何方式打开”或“任何方式允许”，具体取决于您的 macOS 版本。

根据您的 Linux 发行版和所需的软件包，从下面的选项卡中选择相应的选项卡

  • 要在 Ubuntu 22.04 (Jammy)、Ubuntu 20.04 (Focal)、Ubuntu 18.04 (Bionic) 或 Debian 上安装 .deb 软件包，请点击 .deb 选项卡。

  • 要在以下系统上安装 .rpm 软件包RHEL、Amazon Linux 2023 或 Amazon Linux 2，请点击 .rpm 选项卡。

  • 要安装 .tgz tarball，请点击 .tgz 选项卡。

支持的平台

mongosh 以下平台可用作为 PPA

  • Ubuntu 22.04 (Jammy)

  • Ubuntu 20.04 (Focal)

  • Ubuntu 18.04 (Bionic)

步骤

1

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

在终端中，执行以下命令以从 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 未安装，请执行以下步骤

  1. 使用以下命令安装 gnupg 及其所需库

    sudo apt-get install gnupg

  2. 重试导入密钥

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

为MongoDB创建一个列表文件。

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

点击适用于您Ubuntu版本的相应标签。如果您不确定主机正在运行哪个Ubuntu版本，请在主机上打开终端或shell，并运行 lsb_release -dc。

以下说明适用于 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 (Focal)。对于其他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
3

重新加载本地软件包数据库。

运行以下命令以重新加载本地软件包数据库

sudo apt-get update
4

安装 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
5

确认 mongosh 安装成功。

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

mongosh --version

您的终端应该显示您已安装的 mongosh 版本。

支持的平台

mongosh 以下平台可用为 yum 软件包

  • RHEL

  • Amazon Linux 2023

  • Amazon Linux 2

操作步骤

1

配置软件包管理系统（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 文件。下载按照以下顺序组织

  1. Red Hat 或 CentOS 版本（例如，8）

  2. MongoDB 版本（例如，mongodb-enterprise）

  3. MongoDB 发布版本（例如，8.0）

  4. 架构（例如，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文件。下载按以下顺序组织

  1. Amazon Linux版本（例如，2023）

  2. MongoDB 发布版本（例如，8.0）

  3. 架构（例如，x86_64）

2

安装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

步骤

1

打开MongoDB Shell下载页面。

打开MongoDB下载中心。

2

下载Linux 64位的.tgz包。

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

请参阅MongoDB 下载中心。

3

从下载的压缩包中提取文件。

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

根据您下载的版本，.tgz包的名称可能会有所不同。将以下命令中的.tgz包名称替换为您下载的包名称，并运行该命令。

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

提取的压缩包中有一个bin文件夹，其中包含两个文件，mongosh和mongosh_crypt_v1.so。

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

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

chmod +x bin/mongosh
4

将下载的二进制文件添加到您的 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)

下一步

验证包完整性