# 在 证书过期 前数天收到提醒。

> 在 SSL 证书或域名到期前收到推送通知。每天用 openssl 或 whois 检查一次，提前几天提醒你的手机，在服务中断前留出足够的续期时间。

<!-- source: https://pocketalert.app/zh/use-cases/ssl-expiration-alerts -->

最后更新：2026-08-11

每日通过 openssl 和 whois 检查，标记剩余天数少于 N 天的证书或域名。在到期前 30、14 和 3 天，主机名和确切日期会以推送通知的形式发送到你的手机，让你有充足的续期时间。

## 三步设置过期提醒

1. **获取 CLI 或 URL** — 安装 Pocket Alert CLI，或获取你的 Webhook URL，用于基于 curl 的检查。
2. **设置检查计划** — 添加每日的 openssl 或 whois 检查，在截止日期临近时触发。
3. **及时续期** — 提醒会在到期前 30、14 和 3 天发出。你能在一切失效前很久就完成续期。

## 在过期前续期

证书过期是自己造成的故障。每日检查能为你争取数天的预警时间。

- **SSL 与域名** — openssl 负责证书，whois 负责域名。一个每日脚本同时监控两者。
- **每日检查一次** — 一个简短的 cron 任务即可完成，无需付费监控服务。
- **哪个证书，哪天到期** — 消息中包含主机名和确切的过期日期，你能知道哪个证书即将到期。
- **分批提醒** — 在到期前 30、14 和 3 天分批提醒。自动续期失败后，仍有时间手动处理。
- **避免服务中断** — 证书过期会引发浏览器警告，并损害信任。这项检查能提前数天发现。
- **随处运行** — 可通过 cron、systemd 或定时的 GitHub Action 运行。

## 监控 SSL 与域名过期

### 1. 安装 CLI 并完成认证

下载 `pocketalert` 二进制文件，放到 PATH 路径中，然后用你的 API 密钥完成一次认证。

```
sudo mv pocketalert /usr/local/bin/ && chmod +x /usr/local/bin/pocketalert
pocketalert auth YOUR_API_KEY
```

### 2. SSL 证书（每日 cron）

用 `openssl` 读取证书过期日期，计算剩余天数，当剩余不足 14 天时推送通知。

```
HOST=example.com
END=$(echo | openssl s_client -connect "${HOST}:443" -servername "$HOST" 2>/dev/null \
  | openssl x509 -noout -enddate | cut -d= -f2)
DAYS=$(( ($(date -d "$END" +%s) - $(date +%s)) / 86400 ))
[ "$DAYS" -lt 14 ] && pocketalert send \
  -t "SSL expiring: $HOST" -m "${DAYS} days left (expires $END)"
```

### 3. 域名过期

用 `whois` 读取注册商的过期日期，并以同样方式转发。

```
EXP=$(whois example.com | awk -F': ' '/Expir/{print $2; exit}')
pocketalert send -t "Domain expiry: example.com" -m "Registered until $EXP"
```

### 4. 设置定时任务

通过 cron 每天运行一次检查。

```
0 8 * * * /usr/local/bin/check-ssl.sh
```

没有 CLI？将 `pocketalert send` 替换为对消息 API 的 `curl` POST 请求。

```
curl -X POST 'https://api.pocketalert.app/v1/messages' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"title":"SSL expiring: example.com","message":"13 days left","level":"critical"}'
```

其余内容请参阅[文档](https://info.pocketalert.app/getting-started.html)。

## 常见问题

### 如何获取 SSL 过期提醒？

每日检查会读取证书的过期日期，当剩余天数少于 N 天时，通过 POST 请求发送到 Pocket Alert。你能在还有续期时间时收到提醒，而不是等到午夜证书已经失效。

### 除了 SSL，也能检查域名吗？

可以。openssl 读取证书过期时间，whois 读取域名过期时间。一个简短脚本会将其中任一项与阈值比较，并在临近截止日期时发出提醒。

### 能看到是哪个证书、什么时候过期吗？

在消息中包含主机名和确切的过期日期。你能清楚知道是哪个证书即将失效，以及还剩多少天可以续期。

### 在哪里运行检查？

cron、systemd 定时器或 GitHub Actions 定时任务都可以。任何能每天运行一条命令并发出 HTTP 请求的环境都行。

### 应该提前多久提醒？

在到期前 30、14 和 3 天提醒。如果自动续期失败，最后这段时间仍够你手动续期，赶在证书失效前完成。

### 最后的过期提醒能突破勿扰模式吗？

可以，设置提醒级别即可。30 天的预先提醒使用 level=silent，让它只留在历史记录中而不发出声音；较紧迫的提醒标记为 level=critical：Android 会通过绕过勿扰模式的通道发送这些通知，iPhone 则会将其显示为时效性通知，穿透专注模式。
