通过 Compass 连接
集群的 Connect 对话框提供了使用 Compass 连接到集群的详细信息。
先决条件
TLS
使用 MongoDB Compass 1.5 或更高版本连接到 Atlas 集群。这些版本支持所需的 SNI TLS 扩展。
MongoDB Compass
若要完成此过程，请执行下列操作之一：
安装 MongoDB Compass。请参阅 Compass 安装。
通过从 Atlas Connect（连接）对话框中的链接下载 MongoDB Compass，从而升级到最新版本的 MongoDB Compass。要访问这些链接，请单击要连接的集群的对应 Connect（连接），然后单击 Compass。
IP 访问列表
要访问集群，您必须从 Atlas 项目的 IP 访问列表上的 IP 地址进行连接。如需在 IP 访问列表中添加 IP 地址，您可以在 Connect 对话框中执行此操作。您也可以通过 网络访问标签页添加 IP 地址。
数据库用户
要访问集群，您必须创建一个有权访问 Atlas 集群上的所需数据库的数据库用户。数据库用户不同于 Atlas 用户。数据库用户可访问 MongoDB 数据库，而 Atlas 用户可访问 Atlas 应用程序本身。
您可以在 Connect 对话框中创建数据库用户来访问 Atlas 集群。您还可以从集群视图添加数据库用户。
连接集群
使用以下过程将 MongoDB Compass 1.8 或更高版本连接到 Atlas 集群。
在Atlas中，转到项目的Clusters 页面。
如果尚未显示，请从导航栏上的 Organizations 菜单中选择包含所需项目的组织。
如果尚未显示，请从导航栏的Projects菜单中选择所需的项目。
如果尚未显示，请单击侧边栏中的Clusters 。
会显示集群页面。
选择连接安全性。
Choose Connection Type 。
将此连接类型用于允许的公共 IP 地址。
如果已启用对等互连，请使用此连接类型：
适用于 Google Cloud 或 Azure 并通过对等互连网络与 Compass 连接，或
对于 AWS，并且通过使用自定义 DNS 服务的对等网络与 Compass 连接。
如果这些都不适用，请将您的 IP 地址添加到 IP 访问列表中，并使用标准连接字符串。如果您通过办公室或家庭网络直接连接到 Atlas，这可能是首选选项。
注意
对等互连必须可用
除非对等互连被标记为 AVAILABLE，否则您无法选择此选项。要检查对等互连的状态，请执行以下操作：
在 Atlas 中，进入项目的 Network Access 页面。
如果尚未显示，请从导航栏上的 Organizations 菜单中选择包含项目的组织。
如果尚未显示，请从导航栏的 Projects 菜单中选择您的项目。
在侧边栏中，单击 Security 标题下的 Network Access。
显示网络访问页面。
如果您通过私有端点连接与 Compass 进行连接，请使用相应接口端点的连接字符串，因为 Compass：
在云提供商网络内运行，或
具有对云提供商网络的可传递网络访问权限。
您想使用优化的连接字符串。
如果这些都不适用，请将您的 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（选择连接方法）。
打开 MongoDB Compass 并连接到 Atlas。
如果您的部署使用单个云提供商或不使用 SSL、身份验证证书或 SSH 隧道，请使用复制的连接字符串连接到 MongoDB Compass。
单击 New Connection，然后将连接字符串粘贴到 Paste your connection string 字段中。
(可选）要保存此连接以供将来使用，请单击 Create Favorite 并为此连接添加一个名称。您可以在 MongoDB Compass Connect 窗口左侧窗格中的 Favorites 下找到已保存的收藏连接。
单击 Connect（连接）。
如果您的部署跨多个云提供商或者使用 SSL、身份验证证书或 SSH 隧道之一，请单独填写连接字段。
单击 Fill in Connection Fields Individually（连接）。
在 hostname 标签页下，输入主机名和端口，然后从下拉列表中选择身份验证机制。
在 More options 选项卡下，配置以下内容：
如果您的部署使用 SSL 或 SSH 隧道，请指定 SSL 或 SSH 隧道选项。
如果您的部署跨越多个云提供商，请指定读取偏好选项。
如果您的部署使用 X.509 证书，请添加自管理 X.509 证书或由 Atlas 管理的自动生成 X.509 证书。
要了解更多信息，请参阅 MongoDB Compass 文档中的连接到 MongoDB。
(可选）要保存此连接以供将来使用，请单击 Create Favorite 并为此连接添加一个名称。您可以在 MongoDB Compass Connect 窗口左侧窗格中的 Favorites 下找到已保存的收藏连接。
单击 Connect（连接）。
对于 MongoDB Compass 1.7 或更早版本，您可以在 Compass 中手动创建新连接。
要设置从 MongoDB Compass 到您的 Atlas 集群的 New Connection，请在 MongoDB Compass 中输入以下信息，然后单击 Connect：
字段名称 | 说明 |
|---|---|
Hostname | 副本集主节点的主机名或分片集群 要在 Atlas UI 中查找副本集主节点的主机名：
要在 Atlas 用户界面中查找分片集群的主机名，请执行以下操作： 记下主节点或 |
Port | 副本集主节点 (primary node in the replica set)节点的端口或分分片集群 mongos的端口。 |
Authentication | 选择 Username / Password 。 |
Username | MongoDB 用户。Atlas 连接字符串显示为集群设置的 MongoDB 管理用户。您可以使用其他 MongoDB 用户进行连接。 |
Password | 与指定的 MongoDB 用户相关联的密码。 |
Authentication Database | 指定 "admin" 。 |
Replica Set Name | Atlas 集群副本集的名称。 要检索副本集设置名称：
|
Read Preference | 指定 MongoDB Compass 如何引导读取操作。选项包括 Primary、Primary Preferred、Secondary、Secondary Preferred 和 Nearest。请参阅/core/read-preference。 |
SSL | 选择 "Use System CA / Atlas Deployment" |
SSH Tunnel | 选择 "Off" |
Favorite Name | 如果您想将连接保存为收藏夹，请输入一个名称。 |
故障排除
如果在连接到集群时遇到问题，请参阅解决连接问题。