前言¶
给域名上 HTTPS,原本是一件要反复进出控制台的事:申请证书、等签发、下载、部署、到期再续。每一步都要人工确认,证书一多就容易漏续,直到浏览器报证书过期才发现。
这个 Skill 把这条链路交给 Agent 自动完成。下面介绍它的定位、能力边界和使用方法。
这是什么¶
「腾讯云 SSL 证书申请」是一个面向 Agent 的 Skill,坐标 @indiv-dimayip/tencentcloud-ssl-cert-apply,版本 1.0.1,来源 community,由发布者 user_4ad2836d 维护,在 SkillHub 上分类为 it-ops-security。
它解决的问题是:让 Agent 主动调用云 API Skill / TCCLI / acme.sh 帮用户完成证书申请与续期,而不是把用户引导到控制台去点按钮。
SkillHub 页面显示该 Skill 评分 100000、累计下载 2171、安装 0(截至抓取时)。
核心功能¶
根据官方简介,该 Skill 覆盖以下能力:
1、自动申请证书:Agent 通过腾讯云 API 申请免费 DV 证书,或付费的 DV / OV / EV 证书。
2、自动签发与续期:用 acme.sh 对接 DNSPod,完成证书的自动签发与到期续期。
3、证书状态查询:查询已申请证书的签发状态。
4、证书下载:下载证书文件,供部署使用。
5、HTTPS 验证:部署后验证 HTTPS 是否生效。
Skill 内置了参考资料,包括证书类型说明、证书链顺序、CAA 记录相关指引、腾讯云 API 申请指引、acme.sh 参数速查卡,并以验收标准判定每一步是否完成。
标签 requires_api_key=true,意味着使用前需要配置腾讯云 API 密钥。
安装与启用¶
需要说明的是,已抓取的官方资料中没有给出具体的安装命令。该 Skill 基于通用 SKILL.md 格式,通过 SkillHub 页面(https://www.skillhub.cn/skills/indiv-dimayip/tencentcloud-ssl-cert-apply)分发,在 Cursor、Codex CLI、Claude Code 等支持 SKILL.md 的 Agent 中的具体启用方式,以官方页面和所用 Agent 的文档为准,此处不做推测。
使用前需要准备腾讯云 API 密钥(SecretId / SecretKey)。这是 requires_api_key=true 的直接要求。密钥的注入方式以你所用 Agent 的 Skill 配置机制为准。
申请免费 DV 证书和申请付费证书走的是同一套 API 入口,区别在于证书类型参数,具体参数以 Skill 内置的 API 申请指引为准。
典型用法¶
官方简介中没有附带可复现的命令级示例,以下是按其描述的能力整理的三条典型链路。每步完成后用验收标准判定,这与 Skill 的设计一致。
申请一张免费 DV 证书
1、确认域名归属,确认该域名已在腾讯云解析。
2、Agent 调用腾讯云 API 提交 DV 证书申请。
3、等待签发,期间可能需要完成域名验证(以 Skill 内置指引为准)。
4、验收:证书状态查询结果为已签发。
用 acme.sh 对接 DNSPod 自动签发与续期
1、准备 DNSPod API 密钥,授予域名解析权限。
2、Agent 使用 acme.sh 发起签发,DNS 验证通过 DNSPod API 自动完成。
3、配置自动续期,续期周期以 acme.sh 的 cron 机制为准。
4、验收:签发成功,且续期任务已注册。
下载证书并部署到 Nginx,验证 HTTPS 生效
1、下载证书文件,注意证书链顺序(中间证书需按顺序拼接,Skill 内置了证书链顺序说明)。
2、将证书部署到 Nginx,配置监听 443 端口。
3、验证:用 curl -I https://你的域名 检查返回状态,确认 HTTPS 生效。
涉及 CAA 记录的场景,建议先按 Skill 内置的 CAA 说明配置,再发起签发。
适用场景与注意¶
适合的场景:个人站点、测试环境、小批量域名的免费 DV 证书申请与自动续期;需要 Agent 批量完成证书动作的自动化流程。
需要注意的点:
1、免费 DV 证书只验证域名控制权,不验证组织身份,对信任级别有要求的业务应选择 OV 或 EV。
2、API 密钥是敏感信息,建议使用权限最小的子账号密钥,不要使用主账号密钥。
3、acme.sh 自动续期依赖 cron 任务持续运行,服务器迁移或重装时要重新配置。
4、证书私钥和证书文件的存放权限要收紧,私钥泄露等同于证书泄露。
5、该 Skill 来源为 community,安装前建议自行审阅其 SKILL.md 内容,确认脚本与参数符合你的安全要求。
结尾¶
这个 Skill 的价值在于把证书申请、续期、下载、验证从人工操作变成 Agent 可调用的流程,附带的证书类型、证书链顺序、CAA、API 指引和 acme.sh 速查卡覆盖了这条链路上容易出错的细节。
官方地址:https://api.skillhub.cn/indiv-dimayip/tencentcloud-ssl-cert-apply
SkillHub 页面:https://www.skillhub.cn/skills/indiv-dimayip/tencentcloud-ssl-cert-apply