acme.sh 从HTTP-01验证切换至DNS-01验证的完整指南

背景介绍

acme.sh作为一款广泛使用的ACME客户端，支持多种域名验证方式。在实际使用中，用户经常需要根据基础设施的变化调整验证方式。本文将详细介绍如何从HTTP-01验证方式平滑过渡到DNS-01验证方式。

验证方式对比

HTTP-01验证要求服务器能够响应来自ACME服务器的HTTP请求，而DNS-01验证则需要在域名解析记录中添加特定的TXT记录。当网站架构从直接暴露Web服务器变为使用负载均衡器时，HTTP-01验证可能不再适用，此时DNS-01验证成为更优选择。

常见问题分析

许多用户在尝试切换验证方式时遇到困难，主要表现为：

1. 即使重新签发证书，系统仍尝试使用旧的HTTP-01验证
2. 配置修改后验证方式未更新
3. 对自动续期机制存在误解

解决方案

1. 强制更新验证方式

使用以下命令重新签发证书并指定DNS验证：

acme.sh --issue -d example.com --dns dns_cf

(将dns_cf替换为您实际使用的DNS API)

2. 检查当前配置

查看当前域名的配置信息：

acme.sh --info -d example.com

3. 完全重置配置

如需彻底重置，可以：

1. 备份现有证书
2. 删除域名相关配置目录
3. 重新初始化签发

注意事项

1. 切换验证方式不会影响已签发证书的有效性
2. DNS-01验证需要配置相应的DNS API凭证
3. 建议在非生产环境测试验证方式切换
4. 注意ACME服务器的请求频率限制

最佳实践

1. 在架构变更前规划好验证方式切换
2. 使用--debug 2参数调试问题
3. 保持acme.sh版本为最新
4. 记录完整的操作过程以便排查问题

通过以上步骤，用户可以顺利完成从HTTP-01到DNS-01验证方式的切换，确保证书签发和续期流程的稳定性。