文档中心

文档数据库 MongoDB 版

数据安全

使用 MongoDB shell 通过 SSL 加密连接数据库

文档数据库 MongoDB 版提供了 SSL（Secure Sockets Layer）加密服务，您可以提前开启 SSL 加密功能，在使用 MongoDB shell 连接数据库时，通过设置 SSL 加密来提高数据链路的安全性。本文介绍如何使用 MongoDB shell 通过 SSL 加密连接来访问数据库。

前提条件

实例已开启 SSL 加密功能，详情请参见设置 SSL 加密。

如需使用 ECS 访问 MongoDB 实例，需确保已购 ECS 服务器与 MongoDB 实例在同一 VPC 下。ECS 服务器的购买方法，请参见购买云服务器。

已将本地服务器或 ECS 实例的 IP 地址加入到 MongoDB 实例的白名单中。详细操作步骤，请参见设置白名单。

已在本地或 ECS 实例上安装正确版本的 MongoDB shell 工具：

MongoDB 4.x：具体安装步骤，请参见 mongo shell。

MongoDB 5.0 及以上：具体安装步骤，请参见 mongosh。

注意事项

通过私网访问 MongoDB 实例相对较安全，一般无需对数据链路加密。使用 SSL 加密连接会增加 MongoDB 实例的 CPU 使用率，建议仅在有加密需求（例如通过公网连接数据库）时启用 SSL 加密。

操作步骤

本文以 Linux 操作系统（安装在 ECS 实例上）为例，介绍使用 SSL 加密功能来连接数据库的详细操作步骤。

下载 SSL CA 证书，详情请参见设置 SSL 加密。

将解压后的证书文件上传至安装有 MongoDB shell 的本地服务器或 ECS 实例中。

本文示例中，将 .pem 证书文件上传至 ECS 的 root/mongodbsslca 目录中。

在安装了 MongoDB shell 的本地服务器或 ECS 实例中，执行以下命令连接 MongoDB 数据库。

# 若使用的 MongoDB shell 版本小于 4.2，可以使用如下命令：
mongo --host <host> -u <username> -p --authenticationDatabase <database> --ssl --sslCAFile <sslCAFile_path> --sslAllowInvalidHostnames
# 若使用的 MongoDB shell 版本大于或等于 4.2，可以使用如下命令：
mongo --host <host> -u <username> -p --authenticationDatabase <database> --tls --tlsCAFile <sslCAFile_path> --tlsAllowInvalidHostnames

代码中相关参数的说明如下表所示。

参数	说明	示例
<host>	单个节点的连接地址，包括域名和端口号。支持使用如下节点的连接地址：副本集实例：实例中的每个节点。分片集群实例每个 Mongos 节点。单个 Shard 分片中的每个节点。每个 ConfigServer 节点。说明 MongoDB 分片集群实例默认仅提供了 Mongos 节点的私网地址，如需使用 Shard 分片节点或和 ConfigServer 节点的私网地址，请单独申请。申请方法，请参见申请私网地址。如需通过公网地址连接数据库，需要先申请公网连接地址，详情请参见申请公网连接地址。	副本集实例单节点的私网连接地址 mongoreplicae9d7d321**0.mongodb.ivolces.com:3717 单节点的公网连接地址 mongoreplicae9d7d3210.mongodb.volces.com:3717 分片集群实例单 Mongos 节点的公网连接地址 mongoshard75fef3010.mongodb.volces.com:3717 Shard 分片中单节点的公网连接地址 mongoshard75fef301s00.mongodb.volces.com:3717 单 ConfigServer 节点的私网连接地址 mongoshard75fef301**config0.ivolces.com:3717
<username>	需要连接的数据库账号。 MongoDB 的默认账号为 root。不建议在生产环境中直接使用 root 账号连接数据库。您可以根据业务需求创建账号并分配权限，详情请参见创建账号和账号权限。	root
<database>	账号所属的数据库。说明当数据库账号为 root 时，对应的数据库必须为 admin。	admin
<sslCAFile_path>	SSL CA 证书文件的路径。	/root/mongodbsslca/mongoshellshard.pem

如下示例中以分片集群实例中某 Mongos 节点的公网地址为例，使用 SSL 加密连接来访问数据库。

mongo --host mongoshard75fef3010****01.mongodb.volces.com:3717 -u root -p --authenticationDatabase admin --tls --tlsCAFile /root/mongodbsslca/mongoshellshard.pem --tlsAllowInvalidHostnames

当命令行提示 Enter password: 时，输入数据库账号对应的密码并按回车键确认即可。

若忘记了 root 账号的密码，您可以在 MongoDB 控制台上重置密码。具体操作步骤，请参见重置密码。

最近更新时间：2026.09.14 16:01:33

这个页面对您有帮助吗？

有用

无用