ACME 客户端实现

Se på Dansk

Auf Deutsch ansehen

Ver en español

Katso suomeksi

Voir en Français

לעבור לעברית

Megtekintés magyar nyelven

Visualizza in italiano

日本語で表示する

한국어로 보기

Ver em Português (do brasil)

Просмотреть на русском

සිංහලෙන් දකින්න

Visa på svenska

Переглянути українською

阅读简体中文页面

使用正體中文閲讀本網頁。

上次更新: | 查看所有文档

Let's Encrypt 使用 ACME 协议来验证您是否控制了给定的域名,并为您颁发证书。要获得 Let's Encrypt 证书,您需要选择一个要使用的 ACME 客户端软件。

以下 ACME 客户端由第三方提供。Let's Encrypt 不控制或审核第三方客户端,无法保证其安全性或可靠性。

一些浏览器内的 ACME 客户端可用,但我们没有在此列出它们,因为它们鼓励手动续订工作流程,这会导致糟糕的用户体验并增加错过续订的风险。

推荐:Certbot

我们建议大多数人从 Certbot 客户端开始。它可以简单地为您获取证书,或者根据您的偏好帮助您安装。它易于使用,适用于许多操作系统,并拥有出色的文档。

如果 Certbot 无法满足您的需求,或者您只是想尝试其他东西,那么下面还有许多其他客户端可供选择,按它们运行的语言或环境分组。

其他客户端选项

以下所有客户端都支持 ACMEv2 API (RFC 8555)。2021 年 6 月,我们 逐步停止了对 ACMEv1 的支持。如果您已经在使用以下客户端中的一个,请确保升级到最新版本。如果您使用的客户端未列出在下面,它可能不支持 ACMEv2,在这种情况下,我们建议您联系项目维护者或切换到另一个客户端。

Bash

  • GetSSL(bash,还通过 ssh 自动化远程主机上的证书)
  • acme.sh(兼容 bash、dash 和 sh)
  • dehydrated(兼容 bash 和 zsh)
  • ght-acme.sh(批处理更新 http-01 和 dns-01 挑战可用)
  • bacme(简单但完整的证书生成脚本)
  • wdfcert.sh(仅支持 DNS-01 挑战和 ECDSA-384 位密钥,用于帐户和证书,原生 Joker DNS 支持,包括单一 TXT 记录 DNS 提供商的通配符加根域支持)

C

C++

Clojure

配置管理工具

D

Domino

  • CertMatica(适用于 HCL Domino™ 服务器的 ACME 证书安装和续订)
  • HCL Domino(适用于 HCL Domino™ 服务器的完整 ACME V2 流程集成)

Docker

Go

HAProxy

Java

Kubernetes

Lua

Microsoft Azure

nginx

Node.js

OpenShift

Perl

  • acme(简单的 json 配置,自动生成密钥,颁发证书,刷新证书,Apache/Nginx 集成)
  • Crypt::LE

PHP

Python

Ruby

Rust

Windows / IIS

服务器

  • Certera(跨平台 PKI,用于集中管理密钥和证书)

4D

C++

D

Delphi

Go

Java

.NET

Node.js

Perl

  • acme(简单的 json 配置,自动生成密钥,颁发证书,刷新证书,Apache/Nginx 集成)
  • Crypt::LE
  • Net::ACME2
  • wdfcert.sh(仅支持 DNS-01 挑战和 ECDSA-384 位密钥,用于帐户和证书,原生 Joker DNS 支持,包括单一 TXT 记录 DNS 提供商的通配符加根域支持)

PHP

Python

  • Python 的 acme 模块是 Certbot 的一部分,但也被许多其他客户端使用,并作为独立包通过 PyPIDebianUbuntuFedora 和其他发行版提供。
  • txacme(适用于 Python 2 / 3 的 Twisted 客户端)

Ruby

Rust

  • instant-acme 是一个异步的纯 Rust ACME (RFC 8555) 客户端,依赖于 Tokio
  • rustls-acme 使用 rustls 提供 TLS 证书管理和服务
  • tokio-rustls-acme 是一个易于使用的异步 ACME 客户端库,用于 rustls

与 Let's Encrypt 集成的项目

添加客户端/项目

如果您知道任何 ACME 客户端或已与 Let's Encrypt 的 ACMEv2 API 集成的项目,但上面页面中没有列出,请向我们 网站仓库 在 GitHub 上提交一个拉取请求,更新 data/clients.json 文件。

在提交拉取请求之前,请确保

  1. 客户端尊重 Let's Encrypt 商标政策
  2. 客户端不是基于浏览器的,并支持自动续订。
  3. 客户端执行 在随机时间进行例行续订,或鼓励进行此配置。
  4. 您的提交将您的客户端添加到相关部分的末尾(如果适用,请不要忘记 "acme_v2"!)。
  5. 您的提交更新了clients.json顶部lastmod日期戳。