AcmeTool 1.1.0

AcmeTool 简介

AcmeTool 是一个用于通过 ACME 协议更新证书的控制台程序。

AcmeTool is a console program for update cert by acme protocol.

English

安装方法

Nuget 包

地址：[https://www.nuget.org/packages/AcmeTool] 安装命令：

dotnet tool install --global AcmeTool

二进制文件

地址：https://github.com/lchfj/AcmeTool/releases

当前包含两个版本的二进制文件

1. AcmeTool.AnyCpu.zip 跨平台通用版本，可在任何支持 dotnet 10.0 的环境中运行，需安装 dotnet 10.0 运行时。

2. AcmeTool.win-x64_native.zip 仅限 Windows x64 操作系统，Native AOT编译版本，无需 dotnet 运行时。

使用方式

工作目录

为存储Acme账户密钥及历史申请信息，请在通过启动本应用前指定固定的工作目录，最终生成的工作目录结构如下。 | 文件 | 说明 | |--|--| | setting.json | 默认的配置文件存放地址，可在启动参数中更改 | | orders | 订单信息存储目录 | | - account.key | Acme账户密钥（加密存储，同工作目录时复用，不区分CA） | | - [xxxxxxxx] | Base64Url格式的目录，不同申请配置使用不同目录以区分 | | - - [xxxxxxxx] | 时间戳格式的目录，相同配置下多次申请的订单信息、日志及备份 | | - - - order.json | 订单简易信息 | | - - - cert.log| 证书申请日志 | | - - - cert.crt | 证书备份 | | - - - cert.key | 证书密钥（加密存储） |

启动参数

Nuget包 及 win-x64_native

AcmeTool [-la] [-fu] [-ch] [-tm] [-de] [filepath]

AnyCpu

dotnet AcmeTool.dll [-la] [-fu] [-ch] [-tm] [-de] [filepath]

参数说明

配置文件

如果启动时在默认或指定的配置文件路径上没有发现文件，则将示例模板内容输出到位置上。

可配置内容可以查看输出的模板，或者查看：[https://github.com/lchfj/AcmeTool/tree/main/code/AcmeTool/Setting/SettingTemplate.json]

定时运行

应用本身不会长期运行，执行完一轮任务就会自动结束运行。所以需要以任务计划（windows）、cron（linux）或者 launchd（macOS）等设置定时任务。

建议以一个随机的时间（请避免整点或半点）为开始，每隔8小时运行一次。应用会自动判断证书是否需要更新，也可避免单次申请时网络故障造成失败。

支持的Acme协议范围

支持的挑战类型

1. HTTP-01（rfc8555）；

2. Dns-Persist-01（Dns-Persist-01）（并非所有CA均支持该挑战类型，使用前先确认支持情况）；

支持的标识符类型

1. DNS（rfc8555）；

2. IP（rfc8738）；

支持的扩展

1. Profiles Extension（Profiles Extension）；

2. ARI Extension（rfc9773）（无开关参数，在可使用时自动应用该扩展）；

许可证

本应用基于 AGPLv3 协议发布。

第三方依赖库

MailKitLite v4.7.*

MimeKitLite v4.7.*

License: MIT

Copyright (C) 2013-2026 .NET Foundation and Contributors

SourceCode : https://github.com/jstedfast/MailKit