连接 mongosh
集群的 Connect 对话框提供了通过 MongoDB shell mongosh 连接到集群的详细信息。
先决条件
TLS
客户端必须支持 TLS 才能连接到 Atlas 集群。
客户端必须支持SNI TLS 扩展，才能连接到AtlasM0 免费集群或M2/M5 共享集群。MongoDB40MongoDB.shell 及更高版本的Shell支持 SNI TLS 扩展。
IP 访问列表
要访问集群，您必须从 Atlas 项目的 IP 访问列表上的 IP 地址进行连接。如需在 IP 访问列表中添加 IP 地址，您可以在 Connect 对话框中执行此操作。您也可以通过 网络访问标签页添加 IP 地址。
数据库用户
要访问集群，您必须创建一个有权访问 Atlas 集群上的所需数据库的数据库用户。数据库用户不同于 Atlas 用户。数据库用户可访问 MongoDB 数据库，而 Atlas 用户可访问 Atlas 应用程序本身。
您可以在 Connect 对话框中创建数据库用户来访问 Atlas 集群。您还可以从集群视图添加数据库用户。
连接集群
AtlasGoClusters在Atlas中，Go项目的 页面。
如果尚未显示，请从导航栏上的 Organizations 菜单中选择包含所需项目的组织。
如果尚未显示，请从导航栏的Projects菜单中选择所需的项目。
如果尚未出现，请单击侧边栏中的 Clusters（部署）。
会显示集群页面。
选择连接安全性。
Choose Connection Type 。
将此连接类型用于允许的公共 IP 地址。
如果已启用对等互连，请使用此连接类型：
适用于 Google Cloud 或 Azure 并通过对等互连网络与 {{connChoice}} 连接，或
对于 AWS，并且通过使用自定义 DNS 服务的对等网络与 {{connChoice}} 连接。
如果这些都不适用，请将您的 IP 地址添加到 IP 访问列表中，并使用标准连接字符串。如果您通过办公室或家庭网络直接连接到 Atlas，这可能是首选选项。
注意
对等互连必须可用
除非对等互连被标记为 AVAILABLE，否则您无法选择此选项。要检查对等互连的状态，请执行以下操作：
在 Atlas 中，进入项目的 Network Access 页面。
如果尚未显示，请从导航栏上的 Organizations 菜单中选择包含项目的组织。
如果尚未显示，请从导航栏的 Projects 菜单中选择您的项目。
在侧边栏中，单击 Security 标题下的 Network Access。
显示网络访问页面。
如果您通过私有端点连接与 {{connChoice}} 建立连接，请使用相应接口端点的连接字符串，原因是 {{connChoice}}：
在云提供商网络内运行，或
具有对云提供商网络的可传递网络访问权限。
您想使用优化的连接字符串。
如果这些都不适用，请将您的 IP 地址添加到 IP 访问列表中，并使用 Standard Connection 字符串。如果您通过办公室或家庭网络直接连接到 Atlas，这可能是首选选项。
注意
除非已配置的 PrivateLink 连接已准备就绪，否则无法选择此选项。要查看 AWS PrivateLink 的状态：
在 Atlas 中，进入项目的 Network Access 页面。
如果尚未显示，请从导航栏上的 Organizations 菜单中选择包含项目的组织。
如果尚未显示，请从导航栏的 Projects 菜单中选择您的项目。
在侧边栏中，单击 Security 标题下的 Network Access。
显示网络访问页面。
选择您希望如何限制与集群的连接。
Add a Connection IP Address
重要
如果 Atlas 在 Setup connection security 步骤中指示您已经在集群中配置了 IP 访问列表条目，请跳过此步骤。要管理 IP 访问列表，请参阅向访问列表添加条目。
Atlas 支持标准客户端从项目的 IP 访问列表中的条目连接到集群。项目 IP 访问列表与 API 访问列表不同，后者将 API 访问权限限制为特定的 IP 或 CIDR 地址。
如果 IP 访问列表为空，Atlas 会提示您将 IP 地址添加到项目的 IP 访问列表中。您可以执行以下任一操作：
单击 Add Your Current IP Address 以允许从当前 IP 地址进行访问。
单击 Add an IP Address 添加单个 IP 地址或带有 CIDR 标记的地址范围。
为新添加的 IP 地址或 CIDR 范围提供可选描述。单击 Add IP Address 将地址添加到 IP 访问列表。
Add a Connection IP Address
重要
如果 Atlas 在 Setup connection security 步骤中指示您已经在集群中配置了 IP 访问列表条目，请跳过此步骤。要管理 IP 访问列表，请参阅向 IP 访问列表添加条目。
Atlas 支持标准客户端从项目的 IP 访问列表中的条目连接到集群。项目 IP 访问列表与 API 访问列表不同，后者将 API 访问权限限制为特定的 IP 或 CIDR 地址。
如果 IP 访问列表为空，Atlas 会提示您将 IP 地址添加到项目的 IP 访问列表中。单击 Add a Different IP Address 添加单个 IP 地址或带有 CIDR 标记的地址范围。
为新添加的 IP 地址或 CIDR 范围提供可选描述。单击 Add IP Address 将地址添加到 IP 访问列表。
在 Choose Connection Type 下，选择 Private Endpoint 。
如果看到 Private Link Type 选项，请选择以下选项之一：
Optimized SRV Connection 用于负载均衡连接。
Legacy SRV Connection 用于非负载均衡连接。
要了解更多信息，请参阅提高私有端点后分片集群的连接性能。
在 Choose Private Endpoint 下，选择要使用的端点。
创建数据库用户。
重要
如果 Atlas 在 Setup connection security（设置连接安全）步骤中指示项目中至少已配置一个数据库用户，请跳过此步骤。如要管理现有数据库用户，请参阅配置数据库用户。
要访问集群，您需要一个可以访问项目集群所需数据库的 MongoDB 用户。如果您的项目没有 MongoDB 用户，Atlas 会提示您创建一个具有 Atlas Admin 角色的新用户。
输入新用户的 Username（用户名）。
输入此新用户的 Password（密码）或单击 Autogenerate Secure Password（自动生成安全密码）。
单击 Create Database User（创建数据库用户）以保存此用户。
在以下步骤中，使用此用户连接集群。
将 IP 地址添加到 IP 访问列表并添加数据库用户后，单击 Choose Your Connection Method（选择连接方法）。
使用 连接到您的Atlasmongosh 集群。
选择 Shell 。
下一个屏幕根据您是否已经在系统上安装了 mongosh 为您提供继续操作的选项。
从下拉菜单中选择您的操作系统。
使用以下选项之一进行下载：
单击 Download mongosh 开始下载。
单击 Copy download URL 将下载 URL 复制到剪贴板，然后执行以下任一操作：
使用
curl从 URL 获取安装文件，或者在浏览器窗口中粘贴 URL。
从 MongoDB Shell 页面下载安装程序。
从下载的存档中提取文件。
将
mongosh二进制文件添加到PATH环境变量中。确保提取的 MongoDB Shell 二进制文件位于文件系统中的所需位置，然后将该位置添加到
PATH环境变量中。打开 Control Panel。
在 System and Security 类别中，单击 System。
单击 Advanced system settings（添加 OAuth 作用域）。会显示 System Properties（创建应用）模式。
单击 Environment Variables（连接）。
选择 Path，然后单击 Edit。
点击 New，将文件路径添加到
mongosh二进制文件中。Atlas 模态的第 3 步显示可复制的连接字符串。此字符串包含可以通过集群进行身份验证的 MongoDB 用户的名称。复制此字符串。要以不同的 MongoDB 用户身份连接，请更改 --username 选项。
使用提供的 Homebrew 命令。
从 Atlas 用户界面窗口复制 Homebrew 命令并在终端中运行。
Atlas 模态的第 3 步显示可复制的连接字符串。此字符串包含可以通过集群进行身份验证的 MongoDB 用户的名称。复制此字符串。要以不同的 MongoDB 用户身份连接，请更改 --username 选项。
使用以下选项之一下载安装程序：
单击 Download mongosh 开始下载。
单击 Copy download URL 将下载 URL 复制到剪贴板，然后执行以下任一操作：
使用
curl从 URL 获取安装文件，或者在浏览器窗口中粘贴 URL。
从 MongoDB Shell 页面下载安装程序。
安装
mongosh包。Atlas 模态的第 3 步显示可复制的连接字符串。此字符串包含可以通过集群进行身份验证的 MongoDB 用户的名称。复制此字符串。要以不同的 MongoDB 用户身份连接，请更改
--username选项。将
mongosh命令和连接字符串粘贴到终端中。运行命令。shell 会提示您输入密码。
故障排除
如果在连接到集群时遇到问题，请参阅解决连接问题。