# https证书时间检测 **Repository Path**: zxfsc/https-cert-check ## Basic Information - **Project Name**: https证书时间检测 - **Description**: “HTTPS证书监控有效期”做成了一个可直接运行的巡检工具,不用安装任何依赖。 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 1 - **Created**: 2026-11-05 - **Last Updated**: 2026-11-05 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # HTTPS 证书有效期检测工具 读取网站服务器证书的**生效时间 / 到期时间 / 剩余天数**,按阈值标色,既能双击看界面,也能用命令行给巡检平台出 XML。 单个 exe 拷走即用,不需要安装 .NET SDK、不需要管理员权限、不依赖外网。 ## 文件说明 | 文件 | 用途 | | --- | --- | | `HttpsCertExpiry.exe` | 图形界面版,双击打开,无控制台黑窗 | | `CertCheck.exe` | 命令行版,stdout 和退出码正常,适合脚本 / 巡检平台调用 | | `HttpsCertExpiry.cs` | 全部源码(单文件,约 2000 行,C# 5 / .NET Framework 4.x) | | `urls.txt` | 网址列表与阈值配置,程序同目录 | | `build_exe.bat` | 用 Windows 自带的 `csc.exe` 一键编译出上面两个 exe | | `app.manifest` | DPI 感知与系统版本声明,编译时嵌入 | 两个 exe 是同一份源码编译的,功能完全一致,只是入口不同。 ## 快速开始 把 `HttpsCertExpiry.exe` 放到任意目录,双击。第一次运行如果同目录没有 `urls.txt`,会自动生成一份默认配置: ``` # 每行一个 https 地址,# 开头是注释 # warn=30 crit=14 timeout=8 https://www.baidu.com ``` 要监控自己的地址,点右下角「网址列表 / 阈值」,一行一个地址粘进去,点「保存列表」;也可以直接在顶部输入框填一个地址回车,它会作为额外的一项参与本轮检测。 界面各列:**网址 / 生效时间 / 到期时间 / 剩余天数 / 状态 / 方式 / 说明**。剩余天数低于 `warn` 阈值整行淡黄、低于 `crit` 阈值整行淡红,状态为「检测失败」同样标红;「方式」记录这次是靠哪条路拿到证书的(`.NET` / `openssl` / `curl`),「说明」写剩余天数不足的原因或失败原因,鼠标悬停可看全文。 ## 命令行用法 ``` CertCheck.exe 读 urls.txt,输出可读文本 CertCheck.exe --xml 输出巡检平台要的 XML CertCheck.exe --xml --out report.xml 把 XML 写进文件 CertCheck.exe --csv report.csv 额外导出 CSV CertCheck.exe --url https://example.com 临时加检一个地址 CertCheck.exe --urls other_list.txt 改用其它网址列表 CertCheck.exe --warn 30 --crit 14 --timeout 8 临时调整阈值与超时 CertCheck.exe --strict 有预警返回 1,有严重/过期/失败返回 2 CertCheck.exe --tlsinfo --url 地址 --out diag.txt 环境诊断 ``` XML 输出固定四个字段加一个可选说明,方便平台直接落库: ```xml https://www.baidu.com 2026-07-09 10:32:55 2027-01-24 10:32:55 82 ``` **退出码默认恒为 0**,避免巡检平台把「证书快到期」当成「脚本执行错误」;确实需要非零退出码时加 `--strict`。 ## 检测方式与兜底 按顺序尝试,任何一条拿到证书就停止: 1. .NET `SslStream`(系统 Schannel),优先用系统默认协议,失败再逐个尝试 TLS 1.2 / 1.1 / 1.0 / 1.3; 2. `openssl.exe s_client`,解析 `-startdate` / `-enddate`; 3. `curl.exe -w %{certs}`。 `CertCheck.exe` / `HttpsCertExpiry.exe` 里已经内嵌了 openssl 及其依赖 DLL,需要时自动释放到 `%TEMP%\certcheck_openssl` 再调用,所以目标机器上不用装任何东西。如果你想用机器上已有的 openssl,把 `openssl.exe` 放在程序同目录(或 `openssl\`、`bin\` 子目录)会优先使用它。 时间统一按服务器证书里的 UTC 换算成本地时间输出,剩余天数按「到期时间 − 当前时间」向下取整,已过期为负数。 ## 环境要求 Windows 7 SP1 及以上,装有 .NET Framework 4.x(Win10 / Win11 自带)。界面在 100% / 125% / 150% 缩放下都按 DPI 自适应。 Win7 上如果系统 TLS 注册表被关掉、或缺少现代加密套件,.NET 直连会握手失败,这时会自动走内嵌的 openssl 兜底;实在拿不到就用 `--tlsinfo` 看具体原因。 ## 自己编译 ``` build_exe.bat ``` 调用的是 `%WINDIR%\Microsoft.NET\Framework64\v4.0.30319\csc.exe`,不需要 Visual Studio 和联网。 如果当前目录下存在 `openssl\`(含 `openssl.exe`、`libcrypto-3-x64.dll`、`libssl-3-x64.dll`、`zlib1.dll`),会把它们作为资源内嵌进 exe;没有这个目录也能编译成功,只是运行时改用系统 .NET / curl 或外部 openssl。 ## 排障 界面上点「TLS 诊断」,或命令行跑: ``` CertCheck.exe --tlsinfo --url https://www.baidu.com --out diag.txt ``` `diag.txt` 里会写:操作系统版本与补丁、CLR 版本、.NET 4.x Release、系统 TLS 客户端注册表开关(`SCHANNEL\Protocols`)、openssl / curl 是否可用及版本、以及逐个协议握手的成功或失败原因。地址连不上时先看这一份,基本能定位是 DNS、防火墙、TLS 版本还是证书链的问题。 ## 说明 仓库里的默认网址列表只有一个公网示例地址,源码和 exe 内都不含任何内部系统地址;要监控的地址请写到你自己机器上的 `urls.txt` 里。