
rustls v/0.23.44
基于 Rust 的内存安全 TLS 库,实现 TLS 1.2 和 1.3,配备可插拔加密提供程序,支持客户端/服务器模式和基于证书的身份验证。
Rustls 是一个用 Rust 编写的现代 TLS 库。
状态
Rustls 已在许多组织和项目的生产环境中使用。我们力求保持合理的 API 表面稳定性,但随着我们为适应新功能或性能改进而做出更改,API 可能会演进。
我们有一份关于未来计划的路线图。我们还有基准测试,用于防止性能回归,并让你在目标硬件上评估 rustls。
如果你想提供帮助,请参阅 CONTRIBUTING.md。
维护者将 "rustls" 读作 rustles(而不是 rust-TLS),但我们对此并不十分在意。
变更日志
每个版本的详细变更列表可在 https://github.com/rustls/rustls/releases 找到。
文档
方法
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-rscrate 进行密码学的提供者。 虽然此提供者在某些平台上可能更难构建,但它提供了出色的性能和完整的功能集(包括后量子算法)。rustls-ring- 一个使用ringcrate 进行密码学的提供者。此提供者在各种平台上更易于构建,但功能集较为有限(例如,它不支持后量子算法)。
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 开发了许多第三方提供程序。其中特别值得注意的包括:
rustls-graviola- 一个使用graviola进行加密的提供程序。rustls-symcrypt- 一个使用 Microsoft 的 SymCrypt 库的提供程序。
有关更多第三方提供程序,请参阅 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] 举报任何不当行为,或就行为准则提出任何意见或问题。