Назад к обновлениям
New releaseSep 8, 2026

rustls v/0.23.44

Безопасная по памяти TLS-библиотека на Rust, реализующая TLS 1.2 и 1.3, с подключаемыми криптопровайдерами, клиентским/серверным режимами и аутентификацией на основе сертификатов.

Поделиться

Rustls — современная библиотека TLS, написанная на Rust.

Статус

Rustls используется в production во многих организациях и проектах. Мы стремимся поддерживать разумную стабильность 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 для криптографии. Хотя этот провайдер может быть сложнее собрать на некоторых платформах, он обеспечивает отличную производительность и полный набор возможностей (включая постквантовые алгоритмы).
  • rustls-ring — провайдер, использующий крейт ring для криптографии. Этот провайдер проще собрать на различных платформах, но он имеет более ограниченный набор возможностей (например, он не поддерживает постквантовые алгоритмы).

Команда Rustls рекомендует использовать крейт rustls-aws-lc-rs благодаря его полному набору возможностей и производительности. Подробнее об ограничениях поддержки платформ/архитектур в aws-lc-rs см. в FAQ по aws-lc-rs.

Подробности о том, как выбираются провайдеры, см. в документации для crypto::CryptoProvider.

(В версиях rustls до 0.24 оба этих провайдера поставлялись в составе крейта rustls, а для выбора предпочтительного провайдера использовались функции Cargo. Функция aws-lc-rs была включена по умолчанию.)

Сторонние провайдеры

Сообщество также разработало множество сторонних провайдеров для Rustls. К числу особо примечательных относятся:

Другие сторонние провайдеры см. в PROVIDERS.md.

Дополнительную информацию по этой теме см. в разделе Making a custom CryptoProvider документации.

Пример кода

Наш каталог examples содержит демонстрационные программы, показывающие, как обрабатывать ввод-вывод с помощью вспомогательного средства stream::Stream, а также более сложный асинхронный ввод-вывод с использованием mio. Если вы уже используете 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 распространяется под следующими тремя лицензиями:

Категории