grindsa/acme2certifier

acme2certifier

!GitHub release !GitHub last commit (branch) !GitHub last commit (branch) ![CII Best Practices]([***]

![Codecov main]([] ![Codecov devel]([]

![Security Rating]([] ![Maintainability Rating]([] ![Reliability Rating]([] ![Quality Gate Status]([]

acme2certifier是一个ACME协议代理开发项目。其主要目的是为尚不支持ACME协议的CA服务器提供ACME服务。它由两个库组成：

• acme_srv/*.py - 一系列基于rfc8555实现ACME服务器功能的类
• ca_handler.py - 与CA服务器的接口。该库旨在模块化设计，以便https://github.com/grindsa/acme2certifier/blob/master/docs/ca_handler.md%E5%8F%98%E5%BE%97%E7%AE%80%E5%8D%95%E3%80%82%E7%9B%AE%E5%89%8D%E5%B7%B2%E6%94%AF%E6%8C%81%E4%BB%A5%E4%B8%8B%E5%A4%84%E7%90%86%E7%A8%8B%E5%BA%8F%EF%BC%9A

有关更多最新信息和详细文档，请访问项目主页：https://github.com/grindsa/acme2certifier

Docker部署方案示例

使用Docker快速部署acme2certifier:

bash
# 从Docker Hub拉取镜像
docker pull grindsa/acme2certifier

# 或从GitHub容器仓库拉取
docker pull ghcr.io/grindsa/acme2certifier

# 运行容器
docker run -d -p 8000:8000 --name acme2certifier grindsa/acme2certifier

# 自定义配置运行
mkdir -p ./config ./data
docker run -d -p 8000:8000 -v $(pwd)/config:/app/acme_srv -v $(pwd)/data:/app/data --name acme2certifier grindsa/acme2certifier

变更日志

发布说明和变更日志可在https://github.com/grindsa/acme2certifier/releases%E6%89%BE%E5%88%B0

免责声明

以下ACME客户端用于服务器功能的常规测试：

• https://github.com/Neilpang/acme.sh
• https://github.com/cpu/acmeshell/
• https://caddyserver.com/https://github.com/grindsa/acme2certifier/blob/master/docs/automatic-https
• Certbot
• https://github.com/grindsa/acme2certifier/blob/master/docs/cert-mgr.md
• https://github.com/go-acme/lego
• traefik
• https://github.com/rmbolger/Posh-ACME
• win-acme

其他客户端将在后续测试中添加。如果您有兴趣，可以测试其他ACME客户端，并在发现问题时提交https://github.com/grindsa/acme2certifier/issues/new%E3%80%82

https://github.com/grindsa/acme2certifier/blob/master/docs/acme-clients.md

我不是专业开发人员。请在查看代码时记住这一点，如有问题请提交补丁。

功能特性

• 符合ACME v2 RFC 8555的服务器实现，包括
  • 支持RFC 8737：TLS应用层协议协商(ALPN)挑战扩展
  • 支持RFC 8738：IP地址证书
  • 支持draft-ietf-acme-ari-02和draft-ietf-acme-ari-01：续订信息(ARI)扩展
  • 支持TNAuthList标识符：ACME授权令牌的https://github.com/grindsa/acme2certifier/blob/master/docs/tnauthlist.md
  • 支持tkauth-01使用授权令牌的ACME挑战
  • https://github.com/grindsa/acme2certifier/blob/master/docs/poll.md%E5%92%8C%E6%9D%A5%E8%87%AACA%E6%9C%8D%E5%8A%A1%E5%99%A8%E7%9A%84https://github.com/grindsa/acme2certifier/blob/master/docs/trigger.md%E3%80%82%E8%BF%99%E4%BA%9B%E8%B0%83%E7%94%A8%E8%99%BD%E6%9C%AA%E6%A0%87%E5%87%86%E5%8C%96%EF%BC%8C%E4%BD%86%E5%AF%B9%E4%BA%8E%E5%B0%86acme2certifier%E4%B8%8E%E4%BC%A0%E7%BB%9F%E4%BC%81%E4%B8%9ACA%E4%B8%80%E8%B5%B7%E4%BD%BF%E7%94%A8%E9%9D%9E%E5%B8%B8%E9%87%8D%E8%A6%81

支持以下挑战类型：

• http-01
• dns-01
• tls-alpn-01
• tkauth-01

将逐步添加更多功能。如果您急需某个特定功能，请提交https://github.com/grindsa/acme2certifier/issues/new%E5%91%8A%E7%9F%A5%E3%80%82

安装

该代理可以作为普通wsgi脚本在apache或nginx上运行，也可以作为django项目运行。将acme2certifier作为django项目运行允许使用除SQLite之外的其他数据库后端。

安装acme2certifier最快、最方便的方法是使用docker容器。在https://hub.docker.com/r/grindsa/acme2certifier%E5%92%8Chttps://github.com/grindsa?tab=packages&ecosystem=container%E4%B8%8A%E6%8F%90%E4%BE%9B%E4%BA%86%E7%8E%B0%E6%88%90%E7%9A%84%E9%95%9C%E5%83%8F%EF%BC%8C%E4%BB%A5%E5%8F%8A%E6%9E%84%E5%BB%BA%E8%87%AA%E5%B7%B1%E5%AE%B9%E5%99%A8%E7%9A%84%E8%AF%B4%E6%98%8E%E3%80%82%E6%AD%A4%E5%A4%96%EF%BC%8C%E6%AF%8F%E4%B8%AA%E7%89%88%E6%9C%AC%E9%83%BD%E4%BC%9A%E6%8F%90%E4%BE%9B%E9%80%82%E7%94%A8%E4%BA%8EAlmaLinux/CentOS Stream/Redhat EL 9的rpm包和适用于Ubuntu 22.04的deb包。

• https://github.com/grindsa?tab=packages&ecosystem=container
• https://hub.docker.com/r/grindsa/acme2certifier
• https://github.com/grindsa/acme2certifier/blob/master/docs/install_rpm.md
• https://github.com/grindsa/acme2certifier/blob/master/docs/install_deb.md
• 构建自己容器的说明
• https://github.com/grindsa/acme2certifier/blob/master/docs/install_apache2_wsgi.md
• https://github.com/grindsa/acme2certifier/blob/master/docs/install_nginx_wsgi_ub22.md
• https://github.com/grindsa/acme2certifier/blob/master/docs/install_nginx_wsgi.md

软件物料清单

SBOMs将在构建过程中自动为所有容器创建，并存储在https://github.com/grindsa/sbom/tree/main/sbom/acme2certifier%E4%B8%AD

贡献指南

请阅读https://github.com/grindsa/acme2certifier/blob/master/docs/CONTRIBUTING.md%E4%BA%86%E8%A7%A3%E4%BB%A3%E7%A0%81%E8%A7%84%E8%8C%83%E5%92%8C%E6%8F%90%E4%BA%A4%E6%8B%89%E5%8F%96%E8%AF%B7%E6%B1%82%E7%9A%84%E6%B5%81%E7%A8%8B%E3%80%82%E8%AF%B7%E6%B3%A8%E6%84%8F%EF%BC%8C%E6%88%91%E9%99%A4%E4%BA%86%E7%BC%96%E7%A8%8B%E4%B9%8B%E5%A4%96%E8%BF%98%E6%9C%89%E5%85%B6%E4%BB%96%E5%B7%A5%E4%BD%9C%EF%BC%8C%E5%9B%A0%E6%AD%A4%E5%9B%9E%E5%A4%8D%E5%8F%AF%E8%83%BD%E4%BC%9A%E6%9C%89%E5%BB%B6%E8%BF%9F%E3%80%82

版本控制

我使用SemVer进行版本控制。有关可用版本，请参见本仓库的https://github.com/grindsa/dkb-robo/tags%E3%80%82

许可证

本项目采用GPLv3许可证 - 详见LICENSE文件