lego 集成 Simply.com DNS Provider 签发通配符证书：配置、参数与实现原理详解

网络安全密码学【免费下载链接】legoLets Encrypt/ACME client and library written in Go项目地址https://gitcode.com/gh_mirrors/le/lego点击查看免费下载本指南以 legoLets Encrypt/ACME clientGo 语言实现内置的 Simply.com DNS 解析服务商Provider Code:simply为主线完整讲解如何通过 DNS-01 挑战为域名含通配符域名自动签发 Lets Encrypt 证书。读完本文你将掌握 Simply.com 账号凭据与全部环境变量的配置方法、通配符证书签发命令、DNS 传播等待参数的调优方式并理解 lego 在底层如何调用 Simply.com API 完成 TXT 记录的创建与清理。Simply.com Provider 简介Simply.com 是一家丹麦域名注册与 DNS 托管服务商其公开 API 允许第三方程序以编程方式管理 DNS 记录。lego 从 v4.4.0 起内置了对 Simply.com 的支持Provider 代码为simply其声明与文档模板位于 providers/dns/simply/simply.toml自动生成的官方使用文档即 docs/content/dns/zz_gen_simply.md。该 Provider 的核心用途是解决DNS-01 挑战lego 在验证域名所有权时会通过 Simply.com API 在域名所在的 DNS zone 中自动创建一个_acme-challenge子域名的 TXT 记录等待记录全球生效后由 ACME 服务器完成验证验证结束后再自动删除该记录。整个过程无需人工登录 Simply.com 控制台操作非常适合证书自动化续期场景也是签发*.example.com这类通配符证书的唯一可行方式通配符域名只能使用 DNS-01 挑战。前置准备账号与 API Key使用前需要准备两项凭据均可在 Simply.com 控制台获取凭据环境变量说明账号名Account NameSIMPLY_ACCOUNT_NAME形如S000000的 Simply.com 账号标识API KeySIMPLY_API_KEY控制台中生成的 API 密钥从源码 providers/dns/simply/simply.go 可以看到所有环境变量统一使用SIMPLY_前缀命名空间其中EnvAccountName SIMPLY_ACCOUNT_NAME、EnvAPIKey SIMPLY_API_KEY。若这两项凭据缺失NewDNSProvider会直接返回错误错误信息会明确列出缺失的变量名。快速开始签发通配符证书配置好环境变量后一条命令即可同时签发*.example.com与example.com的证书lego 会自动生成证书私钥并向 Lets Encrypt 提交订单SIMPLY_ACCOUNT_NAMExxxxxx \ SIMPLY_API_KEYyyyyyy \ lego run --dns simply -d *.example.com -d example.com参数说明--dns simply指定使用 Simply.com DNS Provider 完成 DNS-01 挑战-d *.example.com签发通配符证书注意用引号包裹星号防止 Shell 展开-d example.com同时把根域名加入同一张证书实践中常与通配符一并申请避免根域名无证书可用。证书签发成功后默认保存在当前目录的.lego目录下具体路径与证书、密钥的归档细节可参考仓库文档 docs/content/advanced/certificates.md。凭据配置详解环境变量表环境变量名描述SIMPLY_ACCOUNT_NAME账号名SIMPLY_API_KEYAPI Key使用_FILE后缀引用文件所有环境变量名都可以追加_FILE后缀改为从文件中读取值避免把密钥直接写在 Shell 历史或命令行中SIMPLY_ACCOUNT_NAME_FILE/path/to/my/account_name \ SIMPLY_API_KEY_FILE/path/to/my/api_key \ lego run --dns simply -d *.example.com -d example.com对应的文件内容只需包含纯值即可例如/path/to/my/api_key文件内容为一行 API Key 字符串。该机制是 lego 所有 DNS Provider 的通用约定完整说明见 docs/content/dns/_index.md 中的 Configuration and Credentials 章节。lego 会在启动时读取_FILE变量指向的文件内容作为对应配置值。附加配置参数环境变量名描述默认值SIMPLY_HTTP_TIMEOUTAPI 请求超时秒30SIMPLY_POLLING_INTERVALDNS 传播检查间隔秒10SIMPLY_PROPAGATION_TIMEOUTDNS 传播最大等待时间秒300SIMPLY_TTL用于 DNS 挑战的 TXT 记录 TTL秒120这些参数同样支持_FILE后缀。它们的默认值定义在 providers/dns/simply/simply.go 的NewDefaultConfig中实现细节如下SIMPLY_HTTP_TIMEOUT作用于内部 HTTP 客户端NewDefaultConfig通过env.GetOrDefaultSecond(EnvHTTPTimeout, 30*time.Second)构造http.Client{Timeout: ...}控制每一次 Simply.com API 调用的请求超时SIMPLY_POLLING_INTERVAL与SIMPLY_PROPAGATION_TIMEOUT通过DNSProvider.Timeout()方法simply.go暴露给挑战框架分别控制轮询间隔与总等待上限。需要说明的是lego 在 challenge/dns01/dns_challenge.go 中定义的全局默认值是传播超时 60 秒、轮询间隔 2 秒而 Simply.com Provider 将默认值放宽为 300 秒 / 10 秒以适应该服务商较慢的记录生效速度SIMPLY_TTL作为 TXT 记录创建请求中的ttl字段默认值与 dns01 包的DefaultTTL120 秒一致。若你的域名解析生效较快可适当缩小SIMPLY_PROPAGATION_TIMEOUT以缩短失败等待时间若经常遇到传播超时则可增大该值。底层实现挑战如何驱动 Simply.com API创建 TXT 记录PresentDNSProvider.Presentsimply.go负责写入挑战记录流程为通过dns01.GetChallengeInfo计算挑战所需的完整 FQDN 与 TXT 值使用 lego 的FindZoneByFqdn在 DNS 中定位权威 zone并剥离末尾点号用ExtractSubDomain从完整挑战域名中抽出子域名例如_acme-challenge.example.com中的_acme-challenge构造internal.Record{Name: subDomain, Data: 挑战值, Type: TXT, TTL: 配置值}调用AddRecord写入记录将返回的record_id以挑战 token 为键缓存到recordIDsmap 中使用互斥锁保护见 simply.go供后续清理使用。从 internal/client.go 可以看到新增记录实际发送的是POST请求到https://api.simply.com/2/my/products/{zone}/dns/records/端点请求体格式可由测试夹具 internal/fixtures/add_record-request.json 印证{ name: _acme-challenge, data: ADw2sEd82DUgXcQ9hNBZThJs7zVJkR5v9JeSbAb9mZY, type: TXT, ttl: 120 }删除 TXT 记录CleanUp验证完成后DNSProvider.CleanUpsimply.go根据之前缓存的record_id调用DeleteRecord发送DELETE请求到.../dns/records/{id}/端点删除记录随后将记录 ID 从 map 中移除。若找不到对应记录 ID会返回明确错误。这种先记 ID、后删 ID的设计确保只清理本次挑战创建的记录不会误删用户原有的 DNS 记录。API 客户端与鉴权内部客户端 internal/client.go 还提供了GetRecords列出 zone 全部记录与EditRecord编辑记录两个方法。所有请求均通过req.SetBasicAuth(c.accountName, c.apiKey)使用 HTTP Basic Auth 鉴权且要求 JSON 请求/响应格式Accept: application/json、Content-Type: application/json。完整 API 交互测试见 internal/client_test.go其中覆盖了增删改查以及各类错误响应。常见错误与排查以下错误信息来自源码与测试夹具可直接用于排错错误信息触发场景对应依据simply: some credentials information are missing: SIMPLY_ACCOUNT_NAME未设置账号名simply_test.gosimply: some credentials information are missing: SIMPLY_API_KEY未设置 API Key同上Invalid account authorization账号名或 API Key 错误internal/fixtures/bad_auth_error.jsonUnknown or invalid product referencezone 域名与账号下托管的域名不匹配internal/fixtures/bad_zone_error.jsonUnknown DNS record删除/编辑的记录 ID 不存在internal/fixtures/invalid_record_id_error.json排错建议先确认SIMPLY_ACCOUNT_NAME与SIMPLY_API_KEY拼写无误且该账号在 Simply.com 上确实托管了你要签发证书的域名 zone若 API 返回鉴权错误请到控制台重新生成 API Key。测试与验证仓库为 Simply.com Provider 提供了完整的单元测试与可选的在线测试providers/dns/simply/simply_test.go验证凭据缺失时的错误分支、Present/CleanUp的请求路由与响应处理以及带SIMPLY_DOMAIN环境变量时运行的 live 测试TestLivePresent/TestLiveCleanUpproviders/dns/simply/internal/client_test.go基于 mock 服务器验证四个 API 方法及其错误路径。若需在本地运行这些测试可在仓库根目录执行go test ./providers/dns/simply/...总结Simply.com DNS Provider 是 lego 生态中接入成本最低的解析商之一只需SIMPLY_ACCOUNT_NAME与SIMPLY_API_KEY两个环境变量配合--dns simply即可自动完成 DNS-01 挑战记录的全生命周期管理天然支持通配符证书签发与到期自动续期。通过SIMPLY_TTL、SIMPLY_PROPAGATION_TIMEOUT等附加参数你还可以针对 Simply.com 的记录生效速度对签发流程做精细调优而源码中的Present/CleanUp实现与 API 测试夹具则为你排查认证、zone 归属、记录 ID 等各类异常提供了清晰依据。赞分享网络安全密码学【免费下载链接】legoLets Encrypt/ACME client and library written in Go项目地址https://gitcode.com/gh_mirrors/le/lego点击查看免费下载相关推荐Hindsight 集成指南为 OpenAI Codex CLI 注入持久化记忆Auto-Recall / Auto-Retain 实战Hindsight 集成指南为 OpenAI Codex CLI 注入持久化记忆Auto Recall / Auto Retain 实战 本文档基于仓库网络安全密码学lego 使用 Beget.com DNS Provider 签发通配符证书配置详解与源码原理lego 使用 Beget.com DNS Provider 签发通配符证书配置详解与源码原理 本指南聚焦 legoLets Encrypt/ACME c网络安全密码学使用 lego Namesilo 签发通配符证书DNS-01 挑战配置、参数详解与实现原理使用 lego Namesilo 签发通配符证书DNS 01 挑战配置、参数详解与实现原理 本指南围绕 legoLets Encrypt/ACME 客网络安全密码学上一篇Baichuan2-7B-Base代码实现详解从tokenizer到NormHead的完整流程下一篇GitHub_Trending/mu/MusicBot数据库连接管理最佳实践与常见问题创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考