跳到主要内容
ecdsa.com

用于 README 的 TLS 证书徽章

适用于任意域名的五种实时 SVG 徽章:签名健康总评级、证书到期倒计时、协商出的 TLS 版本、证书密钥,以及后量子就绪程度。选择一种,设置样式,再复制代码片段(Markdown、HTML 或 reStructuredText)。无需账号、无需令牌、无需构建步骤。

样式
试试:

选择徽章

下方每个预览都是实时端点此刻为你的域名渲染的结果。

复制到你的 README

在上方输入域名后,代码片段会显示在这里。

全部五种徽章

signature health | Acert expires | in 34 daystls | 1.3cert key | ECDSA P-256post-quantum | not yet

“全部复制为 Markdown”会使用每个徽章自己的默认标签和上方选定的样式——共五行,可直接粘贴成一排。

为什么要放徽章

它会自动保持准确

徽章是根据最新扫描结果渲染的 SVG,缓存一小时,而不是你一次性粘贴的快照。续期证书、切换到 ECDSA、启用 TLS 1.3——徽章会在一小时内跟着更新,无需 CI 任务,也无需令牌。

别人也能重复这项检测

每个徽章都链接到 ecdsa.com/health/<你的域名> 上的完整报告,读者可以确切看到检测了什么(证书链、算法、协议版本、有效期),而不必盲目相信徽章的颜色。

它能及早发现最平常的故障

你自己 README 中的到期徽章一旦变成琥珀色,就是一个低成本、常驻的提醒:证书需要续期了,免得它在周末让网站宕机。

端点的工作方式

每个徽章都是对 https://ecdsa.com/api/badge/<domain> 加上类型后缀(/expiry、/tls、/key、/pqc)发起的普通 GET 请求,响应为 SVG。有两个可选查询参数:?style=for-the-badge 用于较高的大写样式,?label=Your%20text 用于替换左侧的说明文字。

结果会缓存一小时,因此即使 README 访问量很大,你的服务器每小时也只需承受一次握手,而不是每位访问者一次。无法访问的域名会显示灰色的 unreachable 徽章,而不是损坏的图片——徽章绝不会让你的 README 变成满页缺失的图片。

想先了解评级背后的依据?在域名签名健康检查中运行完整检测,或阅读 ECDSA 与 RSA 对比,了解密钥徽章为何显示这样的结果。