连接到MongoDB

注意事项¶

• 将Compass连接到副本集时，建议不要直接连接到单个副本集成员。如果由于选举而导致您所连接的成员从主要成员切换 到次要成员， 反之亦然，则Compass可能会强行关闭连接或显示陈旧数据。

  而是，要连接到副本集，请在填写连接信息时使用副本集 SRV记录或副本集名称。

• 如果您使用Kerberos作为身份验证机制，请不要在连接表单中指定密码。

• 从MongoDB Compass 1.19开始，Compass连接到非正版MongoDB实例时会显示警告消息，因为这些实例的行为可能与官方MongoDB实例不同。例如缺少或不完整的功能，不同的功能行为等。

连接¶

当您打开Compass时，将出现一个初始连接对话框：

Compass提供了两种连接到部署的方法，一种是提供部署连接字符串，要么是在特定字段中填写部署信息。

• 粘贴连接字符串
• 填写各个字段

提供连接字符串时，Compass支持 MongoDB 支持的大多数连接字符串选项。

默认情况下，Compass的默认 socketTimeoutMS 值为60000，即60秒。如果您经常在Compass中遇到超时，请考虑在连接字符串中将此选项设置为更高的值。

有关Compass支持的连接字符串选项的完整列表，请参见 GitHub上的 Compass Connection README。

1个

粘贴您的连接字符串。¶

如果有用于部署的连接字符串，则可以将字符串直接粘贴到对话框中。您可以使用标准连接字符串格式 或DNS种子列表连接格式。

• 要获取Atlas集群的连接字符串：
  1. 导航到“ Atlas 群集”视图。
  2. 单击连接以获取所需的群集。
  3. 单击“ 使用MongoDB Compass连接”。
  4. 复制提供的连接字符串。
• 要了解如何格式化未托管在Atlas上的部署的连接字符串，请参阅“ 连接字符串URI格式”。

2

连接。¶

单击“ 连接”按钮导航到“指南针首页”。

所需的访问

连接到MongoDB部署后，您可能需要特定的用户角色 才能访问Compass的各种功能。有关Compass功能的必需角色的更多信息，请参见 必需访问。

1个

打开单个连接字段视图。¶

要手动填写单个连接字段，请单击“分别 填写连接字段”：

2

输入您的连接信息。¶

该主机名对话框包含以下连接字段选项：

选项	描述
主机名	运行部署的计算机的主机名。 如果您在本地运行部署，则此值为 localhost。如果要连接到Atlas群集，则可以从Atlas的群集详细信息视图中获取主机名。 如果不确定主机名，请与数据库管理员联系以获取信息。
港口	运行部署的端口。如果您使用SRV记录连接到MongoDB部署，则不需要。 默认情况下，独立部署在port上运行27017。如果要连接到副本集，则端口也可能是 27018或27019。有关MongoDB使用的默认端口的更多信息，请参阅Default MongoDB Port。 如果不确定部署所在的端口，请与数据库管理员联系以获取信息。
SRV记录	指示提供的主机名 是否为SRV记录。如果启用此切换，则无需指定端口。 注意 您只能使用SRV连接字符串连接到运行MongoDB 3.6及更高版本的部署。 SRV连接字符串的前缀为mongodb+srv:。如果您使用的是SRV连接字符串，则无需mongodb+srv在Hostname中包含它。 例 如果以下是用于MongoDB部署的SRV连接字符串： mongodb+srv://<username>:<password>@gettingstarted-7q2cs.mongodb.net/test 然后，在Compass中，将主机名指定 为： gettingstarted-7q2cs.mongodb.net
认证方式	如果部署需要身份验证，则使用的身份验证。Atlas群集使用 用户名/密码身份验证。 从下面的标签中选择身份验证方法，以获取具体说明： 用户名密码 SCRAM-SHA-256 的Kerberos LDAP X.509 如果部署使用MongoDB-CR或 SCRAM-SHA-1作为其身份验证机制，请选择“ 用户名/密码”。 提供Username，Password和Authentication Database 来验证用户。 注意 从MongoDB 4.0版开始，MongoDB删除了对不赞成使用的MongoDB Challenge-Response（MONGODB-CR）身份验证机制的支持。 如果部署使用 SCRAM-SHA-256作为其身份验证机制，请选择SCRAM-SHA-256（MongoDB 4.0中的新增功能）。如果选中，则必须提供Username， Password和Authentication Database 来验证用户。 有关SCRAM 认证机制的更多信息，请参见SCRAM。 重要 指南针社区版中不提供Kerberos身份验证。 如果部署使用Kerberos作为其身份验证机制，则 选择Kerberos。如果选中，则必须提供主体 和服务名称以验证用户。将“ 密码”字段留空。 您还可以通过设置相应的切换开关，使 MongoDB Compass 规范化主机名。启用此设置后，Kerberos cname在构造MongoDB Compass的主体时将使用主机名（）的规范化形式。 有关Kerberos中的主体名称规范化的更多信息，请参阅此RFC文档。 重要 LDAP认证在Compass Community Edition中不可用。 如果部署使用LDAP 作为其身份验证机制，则选择LDAP。如果选中，则必须提供用户名和 密码来验证用户。 重要 X.509身份验证在Compass Community Edition中不可用。 如果部署使用X.509作为其身份验证机制，则 选择X.509。如果选中，则必须提供用户名以对 用户进行身份验证。 注意 如果您使用的是 Atlas管理的证书 ，则您的用户名必须以“ CN =”开头RFC 2253。例如，用户名“ X509User”必须作为“ CN = X509User”提供。
最喜欢的名字	可选的。连接的名称。要将输入的当前连接保存为 收藏夹连接，请在输入中输入名称，然后单击创建收藏夹。 小费 尽管您可以使用相同的“ 收藏夹名称”保存多个连接，但建议为每个连接使用唯一的名称，以轻松找到已保存的连接。

3

（可选）指定副本集和安全连接选项。¶

“ 更多选项”连接屏幕允许您指定以下连接选项：

选项	描述
副本集名称	如果您的MongoDB部署是副本集，请指定副本集名称。如果将副本集“ 主机名”指定为SRV记录，则不需要。
阅读偏好	指定指南针如何引导读取操作。选项有： Primary， Primary Preferred， Secondary， Secondary Preferred和 Nearest。 要了解有关阅读首选项的更多信息，请参阅 阅读首选项。

如果要使用TLS / SSL或SSH隧道连接到部署，请参阅以下选项卡以获取特定说明：

• 使用TLS / SSL连接
• 使用SSH连接

此选项指示Compass通过TLS / SSL连接到您的MongoDB部署。您可以选择以下SSL选项之一：

选项	描述
系统CA /地图集部署	连接到 MongoDB Atlas。
服务器验证	指南针验证部署的身份。如果选中，则必须提供： 证书颁发机构 来自受信任的证书颁发机构的一个或多个证书文件，以验证部署提供的证书。
服务器和客户端验证	部署从其客户端执行证书验证，而Compass验证部署的身份。如果选中，则必须提供： 证书颁发机构文件 来自受信任的证书颁发机构的一个或多个证书文件，以验证部署提供的证书。 客户证书 mongod用来验证Compass客户端身份的TLS / SSL证书 。证书的典型文件扩展名是.crt或.pem。 客户私钥 TLS / SSL密钥文件，mongod用于验证Compass客户端的身份。私钥的典型文件扩展名是 .key或.pem。 客户端密钥密码 如果客户端专用密钥受密码/密码保护，则必须提供密码/密码。
未验证（不安全）	无需任何身份验证即可使用TLS / SSL。

小费

对于生产用途，您的MongoDB部署应使用由单个证书颁发机构生成和签名的有效证书。您或您的组织可以生成和维护独立的证书颁发机构，也可以使用第三方TLS / SSL供应商生成的证书。

此选项指示Compass通过SSH隧道连接到您的MongoDB部署。隧道在您连接到MongoDB时自动启动，在断开连接时自动停止。

在“ SSH隧道”下拉列表中，选择密码或身份文件以提供身份验证。选择识别方法后，请指定以下选项：

SSH主机名	输入堡垒（跳跃盒）主机名。这是要访问的机器的唯一标识符（完全合格域名，或FQDN）。
SSH隧道端口	提供用于SSH连接的端口。默认为22（SSH的标准端口）。
SSH用户名	要登录到远程系统的配置文件的用户名。这将是您要为其建立SSH连接的用户。
SSH身份文件	选择从中读取用于SSH公钥身份验证的标识（私钥）的文件。 Unix或OS X：如果使用OpenSSH，则在~/.ssh目录中找到身份文件。默认情况下，私钥文件具有以下文件名之一： id_dsa id_ecdsa id_ed25519 id_rsa 在Windows上，标识文件的位置取决于您选择的SSH客户端（例如PuTTY）。
SSH密码	如果您的私钥已加密，请提供用于解密私钥的密码（存储在指定的身份文件中）。密码短语为SSH连接提供了额外的安全性。
SSH密码	用于保护SSH连接的密码。如果您不使用身份文件，则这是必需的。

要通过堡垒主机使用SSH隧道，堡垒主机上的SSH配置必须允许TCP端口转发。即，文件中的AllowTcpForwarding伪指令/etc/ssh/sshd_config设置为yes。如果 AllowTcpForwarding未设置为yes，请设置为，yes 然后重新启动SSH守护进程（）。sudo service sshd restart

除了通过Compass UI创建SSH隧道外，您还可以从命令行手动创建隧道：

复制

ssh -L <local_port>:<mongodb_hostname>:<mongodb_port> \
   <user>@<bastion_hostname> -fN

例

如果您hostname-a.com在端口27017上运行了部署 ，并且堡垒主机hostname-b.com使用用户名 ec2-user，则可以通过以下方式构建隧道

复制

ssh -L 27000:hostname-a.com:27017 ec2-user@hostname-b.com -fN

使用此SSH隧道，您现在可以连接Compass（或mongoshell）localhost:27000以连接到上运行的部署 hostname-a.com。

注意

您无法通过SSH隧道连接到副本集。Compass无法通过同一SSH隧道建立与多台服务器的连接。

4

连接。¶

单击“ 连接”按钮导航到“指南针首页”。

所需的访问

连接到MongoDB部署后，您可能需要特定的用户角色 才能访问Compass的各种功能。有关Compass功能的必需角色的更多信息，请参见 必需访问。

断开¶

2

从下拉菜单中选择断开连接。¶

与MongoDB实例断开连接会关闭与活动实例的Compass连接，并将Compass视图返回到初始连接对话框。