返回更新列表
新发布Sep 8, 2026

rustls v/0.23.44

基于 Rust 的内存安全 TLS 库,实现 TLS 1.2 和 1.3,配备可插拔加密提供程序,支持客户端/服务器模式和基于证书的身份验证。

分享

Rustls 是一个用 Rust 编写的现代 TLS 库。

状态

Rustls 已在许多组织和项目的生产环境中使用。我们力求保持合理的 API 表面稳定性,但随着我们为适应新功能或性能改进而做出更改,API 可能会演进。

我们有一份关于未来计划的路线图。我们还有基准测试,用于防止性能回归,并让你在目标硬件上评估 rustls。

如果你想提供帮助,请参阅 CONTRIBUTING.md。

Build Status Coverage Status (codecov.io) Documentation Chat OpenSSF Best Practices

维护者将 "rustls" 读作 rustles(而不是 rust-TLS),但我们对此并不十分在意。

变更日志

每个版本的详细变更列表可在 https://github.com/rustls/rustls/releases 找到。

文档

https://docs.rs/rustls/

方法

Rustls 是一个 TLS 库,旨在提供良好级别的密码学安全性,无需任何配置即可实现该安全性,并且默认不提供任何不安全特性或过时的密码学。

Rustls 为客户端和服务器实现了 TLS1.2 和 TLS1.3。请参阅完整的协议特性列表。

平台支持

虽然 Rustls 本身是平台无关的,但它需要使用密码学原语来实现 TLS 中使用的密码学算法。在 Rustls 中,crypto::CryptoProvider 表示一组密码学原语实现。

通过提供 crypto::CryptoProvider 结构体的自定义实例,你可以替换 rustls 的所有密码学依赖。这是一条通往更广泛架构和环境可移植性,或满足合规要求的途径。更多详情请参阅 crypto::CryptoProvider 文档。

密码学提供者

自 Rustls 0.22 起,已经可以选择 Rustls 所使用的密码学原语的提供者。如果你有特定的平台、合规或功能要求,这可能很有吸引力。

从 0.24 起,用户在构造 ClientConfig 或 ServerConfig 实例时必须显式提供密码学提供者。更多详情请参阅 crypto::CryptoProvider 文档。

一方提供者

Rustls 项目目前维护两个密码学提供者:

  • rustls-aws-lc-rs - 一个使用 aws-lc-rs crate 进行密码学的提供者。 虽然此提供者在某些平台上可能更难构建,但它提供了出色的性能和完整的功能集(包括后量子算法)。
  • rustls-ring - 一个使用 ring crate 进行密码学的提供者。此提供者在各种平台上更易于构建,但功能集较为有限(例如,它不支持后量子算法)。

Rustls 团队建议使用 rustls-aws-lc-rs crate,因为它具有完整的功能集和性能。有关 aws-lc-rs 中平台/架构支持约束的更多详情,请参阅 aws-lc-rs FAQ。

有关提供程序如何选择的详细信息,请参阅 crypto::CryptoProvider 的文档。

(对于 0.24 之前的 rustls 版本,这两个提供程序都作为 rustls crate 的一部分提供,并使用 Cargo 特性来选择首选提供程序。aws-lc-rs 特性默认启用。)

第三方提供程序

社区还为 Rustls 开发了许多第三方提供程序。其中特别值得注意的包括:

有关更多第三方提供程序,请参阅 PROVIDERS.md。

有关此主题的更多信息,请参阅文档中的 Making a custom CryptoProvider 部分。

示例代码

我们的 examples 目录包含演示,展示了如何使用 stream::Stream 辅助工具处理 I/O,以及使用 mio 进行更复杂的异步 I/O。如果你已经使用 Tokio 作为异步运行时,你可能更愿意使用 tokio-rustls,而不是直接与 rustls 交互。

基于 mio 的示例最为完整,并在下文讨论。刚接触 Rustls 的用户可能更愿意先查看简单的客户端/服务器示例,然后再深入研究更复杂的 MIO 示例。

客户端示例程序

MIO 客户端示例程序名为 tls-client-mio。

一些示例运行:

$ cargo run --bin tls-client-mio -- --http jbp.io
HTTP/1.1 200 OK
Date: Tue, 23 Jun 2026 16:13:40 GMT
Content-Type: text/html; charset=utf-8
Connection: close
(...)

运行 cargo run --bin tls-client-mio -- --help 查看更多选项。

服务器示例程序

MIO 服务器示例程序名为 tls-server-mio。

以下是一次示例运行;我们先启动一个 TLS 回显服务器,然后使用 openssl 和 tls-client-mio 连接到它:

$ cargo run --bin tls-server-mio -- --certs test-ca/rsa-2048/end.fullchain --key test-ca/rsa-2048/end.key -p 8443 echo &
$ echo hello world | openssl s_client -ign_eof -quiet -connect localhost:8443
depth=2 CN = ponytown RSA CA
verify error:num=19:self signed certificate in certificate chain
hello world
^C
$ echo hello world | cargo run --bin tls-client-mio -- --cafile test-ca/rsa-2048/ca.cert --port 8443 localhost
hello world
^C

运行 cargo run --bin tls-server-mio -- --help 查看更多选项。

许可证

Rustls 依据以下三种许可证分发:

  • Apache License 2.0 版。
  • MIT 许可证。
  • ISC 许可证。

这些许可证分别以 LICENSE-APACHE、LICENSE-MIT 和 LICENSE-ISC 文件包含在内。您可自行选择依据上述任一许可证的条款使用本软件。

项目成员

  • Joe Birr-Pixton(@ctz,项目创始人 - 全职,由 Prossimo 资助)
  • Dirkjan Ochtman(@djc,共同维护者)
  • Daniel McCarney(@cpu,共同维护者)
  • Josh Aas(@bdaehlie,项目管理)

行为准则

本项目采用 Rust 行为准则。 请发送邮件至 [email protected] 举报任何不当行为,或就行为准则提出任何意见或问题。

分类