Zurück zu den Updates
New releaseSep 8, 2026

rustls v/0.23.44

Speichersichere TLS-Bibliothek in Rust, die TLS 1.2 und 1.3 mit austauschbaren Krypto-Anbietern, Client-/Server-Modi und zertifikatsbasierter Authentifizierung implementiert.

Teilen

Rustls ist eine moderne TLS-Bibliothek, geschrieben in Rust.

Status

Rustls wird in der Produktion bei vielen Organisationen und Projekten eingesetzt. Wir streben danach, eine angemessene Stabilität der API-Oberfläche zu gewährleisten, aber die API kann sich weiterentwickeln, während wir Änderungen vornehmen, um neue Funktionen oder Leistungsverbesserungen zu ermöglichen.

Wir haben eine Roadmap für unsere zukünftigen Pläne. Wir haben außerdem Benchmarks, um Leistungsregressionen zu verhindern und Ihnen die Bewertung von rustls auf Ihrer Zielhardware zu ermöglichen.

Wenn Sie mithelfen möchten, lesen Sie bitte CONTRIBUTING.md.

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

Die Maintainer sprechen "rustls" als rustles aus (und nicht als rust-TLS), aber wir legen uns darauf nicht fest.

Changelog

Die detaillierte Liste der Änderungen in jeder Version finden Sie unter https://github.com/rustls/rustls/releases.

Dokumentation

https://docs.rs/rustls/

Ansatz

Rustls ist eine TLS-Bibliothek, die ein gutes Maß an kryptografischer Sicherheit bieten möchte, keine Konfiguration erfordert, um diese Sicherheit zu erreichen, und standardmäßig keine unsicheren Funktionen oder veraltete Kryptografie bereitstellt.

Rustls implementiert TLS1.2 und TLS1.3 sowohl für Clients als auch für Server. Siehe die vollständige Liste der Protokollfunktionen.

Plattformunterstützung

Obwohl Rustls selbst plattformunabhängig ist, erfordert es die Verwendung kryptografischer Primitive für die Implementierung der in TLS verwendeten kryptografischen Algorithmen. In Rustls repräsentiert ein crypto::CryptoProvider eine Sammlung von Implementierungen kryptografischer Primitive.

Durch die Bereitstellung einer benutzerdefinierten Instanz der Struktur crypto::CryptoProvider können Sie alle Kryptografie-Abhängigkeiten von rustls ersetzen. Dies ist ein Weg, um auf eine breitere Menge von Architekturen und Umgebungen oder Compliance-Anforderungen portierbar zu sein. Weitere Details finden Sie in der Dokumentation zu crypto::CryptoProvider.

Kryptografie-Provider

Seit Rustls 0.22 ist es möglich, den Provider der kryptografischen Primitive zu wählen, die Rustls verwendet. Dies kann attraktiv sein, wenn Sie spezifische Plattform-, Compliance- oder Funktions- anforderungen haben.

Ab 0.24 müssen Benutzer beim Erstellen von ClientConfig- oder ServerConfig-Instanzen explizit einen Krypto-Provider bereitstellen. Weitere Details finden Sie in der Dokumentation zu crypto::CryptoProvider.

First-Party-Provider

Das Rustls-Projekt pflegt derzeit zwei Kryptografie-Provider:

  • rustls-aws-lc-rs – ein Provider, der die Crate aws-lc-rs für Kryptografie verwendet. Obwohl dieser Provider auf einigen Plattformen schwieriger zu bauen sein kann, bietet er hervorragende Leistung und einen vollständigen Funktionsumfang (einschließlich Post-Quanten-Algorithmen).
  • rustls-ring – ein Provider, der die Crate ring für Kryptografie verwendet. Dieser Provider ist auf einer Vielzahl von Plattformen einfacher zu bauen, hat aber einen eingeschränkteren Funktionsumfang (zum Beispiel unterstützt er keine Post-Quanten-Algorithmen).

Das Rustls-Team empfiehlt die Verwendung der Crate rustls-aws-lc-rs wegen ihres vollständigen Funktionsumfangs und ihrer Leistung. Weitere Details zu den Plattform-/Architekturunterstützungsbeschränkungen in aws-lc-rs finden Sie in den aws-lc-rs-FAQ.

Siehe die Dokumentation für crypto::CryptoProvider für Details dazu, wie Provider ausgewählt werden.

(Für rustls-Versionen vor 0.24 wurden beide dieser Provider als Teil des rustls-Crates ausgeliefert, und Cargo-Features wurden verwendet, um den bevorzugten Provider auszuwählen. Das Feature aws-lc-rs war standardmäßig aktiviert.)

Drittanbieter-Provider

Die Community hat auch viele Drittanbieter-Provider für Rustls entwickelt. Besonders erwähnenswerte sind:

Weitere Drittanbieter-Provider finden Sie in PROVIDERS.md.

Siehe den Abschnitt Making a custom CryptoProvider der Dokumentation für weitere Informationen zu diesem Thema.

Beispielcode

Unser examples-Verzeichnis enthält Demos, die zeigen, wie man I/O mit dem stream::Stream-Helfer handhabt, sowie komplexere asynchrone I/O mit mio. Wenn Sie bereits Tokio als Async-Runtime verwenden, bevorzugen Sie möglicherweise tokio-rustls anstelle der direkten Interaktion mit rustls.

Die auf mio basierenden Beispiele sind die vollständigsten und werden im Folgenden besprochen. Nutzer, die neu bei Rustls sind, sollten sich möglicherweise zuerst die einfachen Client/Server-Beispiele ansehen, bevor sie in die komplexeren MIO-Beispiele eintauchen.

Client-Beispielprogramm

Das MIO-Client-Beispielprogramm heißt tls-client-mio.

Einige Beispielausführungen:

$ 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
(...)

Führen Sie cargo run --bin tls-client-mio -- --help aus, um weitere Optionen anzuzeigen.

Beispielprogramm für den Server

Das MIO-Beispielprogramm für den Server heißt tls-server-mio.

Hier ist ein Beispiellauf; wir starten einen TLS-Echo-Server und verbinden uns dann mit openssl und tls-client-mio damit:

Kategorien