全部产品
Search
文档中心

云数据库 MongoDB:设置透明数据加密TDE

更新时间:Oct 14, 2026

透明数据加密TDE(Transparent Data Encryption)可对数据文件执行实时I/O加密和解密,数据在写入磁盘之前进行加密,从磁盘读入内存时进行解密。TDE不会增加数据文件的大小,您无需更改任何应用程序,即可使用TDE功能。为提高数据安全性,您可以通过控制台启用TDE功能,对实例数据进行加密。

前提条件

  • 实例的存储类型与架构需满足以下条件:

    • 本地盘实例:支持副本集和分片集群,数据库版本为4.0或4.2版本。

    • 云盘实例:支持副本集,数据库版本为4.2至8.3(全版本)。

  • 实例的存储引擎为WiredTiger。

  • 已开通KMS。

  • 云盘实例的小版本需不低于以下要求:

    大版本

    最低小版本要求

    4.2

    4.0.36

    4.4

    5.0.22

    5.0

    6.0.23

    6.0

    7.0.24

    7.0

    8.0.16

    8.0

    9.0.9

    8.3

    9.3.1

    重要

    如果您的实例小版本低于上述要求,请先升级小版本后再开通TDE。如何升级小版本,请参见变更实例配置概览。

如果您的实例不满足实例架构或存储引擎的条件,您可以通过其他方式变更,详情请参见变更实例配置概览。

影响

  • 开通TDE功能的过程中,实例会重启一次并出现连接闪断,闪断期间不会导致数据丢失,已提交的写入不受影响,建议您在业务低峰期操作并确保应用有重连机制。

  • 开通TDE功能后,会增加实例的CPU使用率。

  • 加密后的集合不再支持通过物理备份恢复至自建数据库。如果您需要将加密后的集合恢复到自建数据库,您可以通过逻辑备份恢复至自建数据库,具体请参见通过逻辑备份恢复至自建数据库。

注意事项

  • TDE功能开通后无法关闭。

  • 已开通TDE功能的实例释放后,不支持从回收站中恢复。

  • 当前TDE功能的开通粒度为实例,仅支持对集合进行加密。如果您需要对字段进行加密,请参见手动字段级加密(仅支持MongoDB 4.2版本实例)。

    说明

    如果业务上有特殊需求,您可以在创建集合时,指定该集合不被加密。如何设置,请参见设置指定的集合不被加密。

  • TDE功能开通后,仅加密新创建的集合,已有的集合不会被加密。

  • TDE功能所使用的密钥,由密钥管理服务KMS(Key Management Service)统一生成和管理,云数据库MongoDB不提供加密所需的密钥和证书。密钥管理服务KMS的更多信息,请参见什么是密钥管理服务。

  • 实例开通TDE加密后,不支持更换密钥。如需更换密钥,您可以使用DTS将数据迁移到使用新密钥的新实例上,如何迁移数据,请参见云数据库MongoDB实例间迁移。

  • 开启TDE后,由于加密密钥绑定在特定可用区,通过按备份点或按时间点恢复至新实例时,仅支持恢复到密钥所在的可用区,暂不支持跨可用区恢复。

  • 请确保TDE所使用的KMS密钥始终处于可用状态。一旦该密钥被禁用、删除或欠费,实例将被锁定并变为不可用,且已有备份也将无法用于恢复。

操作步骤

  1. 访问MongoDB副本集实例列表或MongoDB分片集群实例列表,在上方选择资源组和地域,然后单击目标实例ID。

  2. 在目标实例页面的左侧导航栏,单击数据安全性 > TDE。

  3. 打开TDE状态:右侧的开关。

  4. 在弹出的开通TDE对话框中,根据实际需要选择生成方式。

    • 使用自动生成密钥:使用系统自动生成的密钥。

    • 使用自定义密钥:根据业务需要,在下拉列表中选择密钥。如果下拉列表中不存在目标密钥,您可以先创建密钥,然后进行选择。创建方法请参见创建密钥。

  5. 单击确定。

    实例进入TDE修改中状态,当转变为运行中状态时,代表操作完成。

查看加密密钥信息

开启TDE后,如需查看实例加密密钥的信息(例如密钥所在的可用区),可调用查询MongoDB实例的某个密钥的详情接口查询,控制台暂不支持查看密钥详情。

设置指定的集合不被加密

开启TDE加密后,所有新创建的集合都会被加密。如果业务上有特殊需求,您可以在创建集合时,指定该集合不被加密。

  1. 通过Mongo Shell连接数据库。如何连接,请参见连接副本集实例或连接分片集群实例。

  2. 执行如下命令创建集合,指定该集合不被加密。

    • 语法:

      db.createCollection("<collection_name>",{ storageEngine: { wiredTiger: { configString: "encryption=(name=none)" } } })
      说明

      命令中的collection_name为集合名。

    • 示例:

      db.createCollection("customer",{ storageEngine: { wiredTiger: { configString: "encryption=(name=none)" } } })

TDE与云盘加密如何选择

云数据库MongoDB提供TDE和云盘加密两种静态数据加密方式,均可满足三级等保对存储保密性的要求。两者防护的都是数据在存储介质上被非法获取的风险,请根据要防护的威胁场景选择。

威胁场景

云盘加密

TDE

物理介质泄漏时,数据文件

防护

防护

物理介质泄漏时,OS日志等非数据文件

防护(整盘加密)

不防护(仅加密数据文件)

物理备份文件被导出后泄漏

视存放位置(云上快照延续加密)

防护(物理备份为密文,无KMS密钥无法解密)

持数据库账号者访问数据

不防护

不防护

数据传输被窃听

不防护

不防护

静态加密不能替代访问控制和传输加密。防止合法账号越权访问,请参见MongoDB数据库账号权限管理并配合开通审计日志;防止传输链路被窃听,请参见设置SSL加密。

选型建议:

  • 要让物理备份或导出文件也保持密文,选择TDE。

  • 要让整盘(含OS日志等所有文件)都加密,选择云盘加密。

  • 若已开启云盘加密,其防护已覆盖绝大多数介质级泄露场景,通常无需再叠加TDE。

加密已有集合

开启 TDE 前已存在的集合不会被自动加密。您可以使用 encryptExistingCollection 命令将已有集合及其索引转换为加密存储。

前提条件

  • 实例已开启 TDE。

  • 实例为云盘副本集实例,数据库版本为 8.0,且小版本不低于 9.0.14。

  • 执行命令的账号拥有目标集合的 collMod 权限,例如 dbOwner 或 root 角色。

操作步骤

  1. 使用 Mongo Shell 连接实例的 Primary 节点。只需在 Primary 节点执行一次,Secondary 节点会自动同步完成加密。

  2. 切换到目标数据库,根据需要执行以下命令:

    • 加密指定集合:

      db.runCommand({ encryptExistingCollection: "<collection_name>" })
    • 加密当前数据库下的全部集合:

      db.runCommand({ encryptExistingCollection: "*" })

    返回结果中 ok 为 1 表示命令执行成功。

  3. 分别连接各节点并执行以下命令查看加密进度:

    db.serverStatus().wiredTiger.encryptionRewrite

    当所有节点返回的 pendingIdents 均为 0 时,表示已有数据已全部完成加密。

影响

  • 命令执行时会对目标集合短暂加锁,通常为毫秒级。期间该集合的读写请求会短暂等待;实例写入压力很大时,等待时间可能延长至秒级。

  • 命令返回后,已有数据在后台进行加密,不阻塞业务读写,但会增加实例的磁盘 I/O 和 CPU 使用率。影响程度与对该集合执行一次 compact 相当,耗时与集合的数据量成正比。

  • 后台加密期间,数据文件可能暂时增大。请预留不少于目标集合(含索引)当前存储空间大小的可用磁盘空间。

注意事项

  • 建议在业务低峰期执行。

  • 集合加密后无法恢复为不加密状态。

  • 使用 "*" 时,会加密当前数据库下的全部集合,包括通过 encryption=(name=none) 指定不被加密的集合。如需保留这类集合不加密,请逐个指定集合名执行。

  • 命令返回成功仅表示该集合新写入的数据开始加密,已有数据仍在后台处理。请以加密进度为准。后台加密过程中如发生节点重启或主备切换,加密会自动继续,无需重新执行。

  • 执行命令前产生的备份不会被加密。

  • 不支持对视图执行该命令,也不支持在事务中执行该命令。