SSL 갱신을 깜빡하면 서비스는 조용히 죽습니다
원클립AI에서 운영하는 서비스 중 하나가 인증서 만료로 사용자 문의를 5건 받고 나서야 알게 된 적이 있다. SSL 만료 자동 알림이 없으면 1인 운영자는 이렇게 뒤늦게 알아버린다.
1인 운영자가 SSL 만료를 늦게 아는 이유
보통 certbot을 깔고 자동 갱신을 켜두면 끝이라고 생각한다. 나도 그렇게 생각했다. 문제는 자동 갱신이 조용히 실패할 때다. 에러가 콘솔에 튀어나오는 게 아니라 로그 파일 어딘가에 쌓일 뿐이다. 그리고 로그 로테이션이 지나가면 흔적마저 사라진다.
사용자가 “사이트가 안 들어가져요”라고 연락했을 때 브라우저를 열어보면, 주소창에 빨간 자물쇠가 떠 있다. 그 순간이 처음 알게 된 시점이다. 하루 종일 서비스가 죽어있었다.
자동 갱신을 켜뒀는데 왜 실패할까
가장 흔한 원인은 DNS 전파 지연이다. Let’s Encrypt가 도메인 소유권을 검증하려고 DNS 레코드를 확인하는데, 방금 바꾼 레코드가 아직 전파되지 않았으면 검증이 실패한다. 그 외에도 80번 포트가 다른 프로세스에 점유돼 있거나, 레이트 리밋에 걸렸거나, 단순히 cron 데몬이 죽어있는 경우도 있다.
공통점은 전부 조용하다는 거다. 갱신이 실패해도 기존 인증서는 만료일까지는 살아있으니 서비스는 멀쩡하게 돌아간다. 그래서 ‘자동 갱신이 되고 있구나’라고 믿게 된다. 그러다 만료일이 지나는 순간, 한꺼번에 터진다.
SSL 만료일을 자동으로 알려주려면 어떻게 세팅하나
만료일 자체를 매일 체크하는 게 가장 확실하다. 갱신이 성공했든 실패했든, 만료일이 7일 이내로 줄어들면 무조건 알림을 받는 식이다.
만료일을 매일 체크하는 가장 가벼운 방법
openssl s_client로 만료일을 뽑아내는 셸 스크립트다. 서버 하나에 올려두고 cron으로 매일 돌린다.
#!/bin/bash
# check-ssl-expiry.sh
DOMAINS="example.com api.example.com app.example.com"
WARN_DAYS=30
SLACK_WEBHOOK="https://hooks.slack.com/services/XXX/YYY/ZZZ"
for domain in $DOMAINS; do
expiry_date=$(echo | openssl s_client -servername "$domain" -connect "$domain:443" 2>/dev/null \
| openssl x509 -noout -enddate 2>/dev/null \
| cut -d= -f2)
if [ -z "$expiry_date" ]; then
curl -s -X POST "$SLACK_WEBHOOK" \
-H 'Content-type: application/json' \
--data "{\"text\":\":warning: $domain SSL 인증서 조회 실패\"}"
continue
fi
expiry_epoch=$(date -d "$expiry_date" +%s 2>/dev/null)
now_epoch=$(date +%s)
days_left=$(( (expiry_epoch - now_epoch) / 86400 ))
if [ "$days_left" -le "$WARN_DAYS" ]; then
curl -s -X POST "$SLACK_WEBHOOK" \
-H 'Content-type: application/json' \
--data "{\"text\":\":rotating_light: $domain SSL 만료까지 ${days_left}일 남음 (만료: $expiry_date)\"}"
fi
done
나는 매일 아침 Slack에 도메인별 남은 일수가 찍히는지 확인하는 루틴을 만들었다. 알림이 안 오면 정상인지, 스크립트가 죽은 건지 구분이 안 되니까, 매일 무조건 한 번은 보는 습관이다.
UptimeRobot, Certbot, 자체 스크립트 비교
| 방식 | 세팅 난이도 | 비용 | 한계 |
|---|---|---|---|
| UptimeRobot 무료 티어 | 웹에서 클릭 몇 번 | 0원 (50개 모니터까지) | 만료 알림 간격이 고정, 스크립트 커스텀 불가 |
| certbot renew + cron | 중간 | 0원 | 갱신 자체는 자동이지만 실패 알림은 직접 만들어야 함 |
| 자체 스크립트 + Slack | 있음 | 0원 | 스크립트 유지보수 부담, 서버가 죽으면 같이 죽음 |
1인 운영자 수준에서 권장하는 세팅
나는 5개 도메인까지는 UptimeRobot으로 충분했다. 웹에서 도메인 입력하고 이메일 알림만 켜면 끝이다. 그 이상이 되니까 무료 티어 한계에 가까워졌고, 알림 간격도 내 맘대로 못 바꿔서 자체 스크립트로 넘어갔다. 지금은 위 스크립트를 cron에 넣어두고 매일 오전 9시에 돌린다.
Let’s Encrypt 자동 갱신이 실패했는지 어떻게 확인하나
이게 진짜 문제다. 만료일 체크는 사후 대응이고, 갱신 실패를 실시간으로 잡아야 한다.
certbot renew 로그가 쌓이는 위치
certbot의 로그는 /var/log/letsencrypt에 쌓인다. 갱신이 실행될 때마다 letsencrypt.log 파일이 새로 생기고, 이전 로그는 letsencrypt.log.1, letsencrypt.log.2 식으로 로테이션된다. 기본 로테이션 설정을 안 바꿨으면, 예전 로그는 결국 사라진다.
실제로 7일 연속 갱신 실패한 적이 있다. 자동 갱신은 켜둔 줄 알았는데, 로그를 보니 매일 실패하고 있었다. 원인은 DNS 전파 지연이었다. 도메인을 새로 연결하면서 레코드를 바꿨는데, Let’s Encrypt가 검증할 타이밍에 아직 전파가 안 끝난 거다. 며칠 뒤에야 전파가 완료돼서 갱신이 성공했지만, 그 사이에 내가 로그를 한 번도 안 봤으면 끝까지 몰랐을 것이다.
로그를 Slack으로 쏘는 1인 운영자용 스크립트
certbot은 갱신 후에 실행할 훅을 지원한다. /etc/letsencrypt/renewal-hooks/deploy/에 스크립트를 넣으면 갱신 성공 시 실행되고, /etc/letsencrypt/renewal-hooks/post/에 넣으면 갱신 시도 후(성공이든 실패든) 실행된다.
#!/bin/bash
# /etc/letsencrypt/renewal-hooks/post/notify-slack.sh
SLACK_WEBHOOK="https://hooks.slack.com/services/XXX/YYY/ZZZ"
if [ "$RENEWED_EXIT_CODE" = "0" ]; then
curl -s -X POST "$SLACK_WEBHOOK" \
-H 'Content-type: application/json' \
--data '{"text":":white_check_mark: SSL 갱신 성공 ('"$RENEWED_DOMAINS"')"}'
else
curl -s -X POST "$SLACK_WEBHOOK" \
-H 'Content-type: application/json' \
--data '{"text":":x: SSL 갱신 실패 (exit code: '"$RENEWED_EXIT_CODE"') /var/log/letsencrypt 확인 필요"}'
fi
이 스크립트를 만들고 chmod +x로 실행 권한을 준다. 그러면 갱신 시도가 있을 때마다 Slack에 메시지가 온다. 실패하건 성공하건 무조건 오니까, 안 오면 cron 자체가 안 돌고 있다는 신호가 된다.
DNS 전파 지연으로 인한 조용한 실패
갱신 실패의 원인이 로그에 명확히 적혀있는 경우는 의외로 많다. “DNS problem: NXDOMAIN”이나 “Connection refused” 같은 에러 메시지가 /var/log/letsencrypt/letsencrypt.log 안에 그대로 남아있다. 그런데 아무도 안 읽는다. 나도 안 읽었다.
미리 실패를 잡으려면 certbot renew --dry-run을 한 번 돌려본다. 실제 갱신이 아니라 테스트 모드라서 Let’s Encrypt의 스테이징 서버로 검증한다. 이게 실패하면 진짜 갱신도 실패할 확률이 높다.

여러 도메인의 SSL 만료를 한 번에 모니터링하려면
원클립AI에서 AI 자동화 서비스를 늘리면서 도메인 수가 계속 늘었다. 처음엔 UptimeRobot 하나면 됐는데, 도메인이 10개를 넘어가니까 무료 티어 모니터가 부족해졌다.
도메인 10개 이상일 때의 툴 선택
| 방식 | 적정 도메인 수 | 비용 | 특징 |
|---|---|---|---|
| UptimeRobot 무료 | ~20개 | 0원 | 설정이 쉽지만 알림 커스텀 제한 |
| 자체 스크립트 + Slack | 제한 없음 | 0원 | 도메인 리스트만 스크립트에 추가하면 됨 |
| CSV + 구글 캘린더 | 제한 없음 | 0원 | 만료일을 캘린더에 자동 등록, 사전 알림을 캘린더가 해줌 |
만료일 캘린더를 자동으로 갱신하는 워크플로우
내가 쓰는 흐름은 이렇다. 도메인 리스트를 CSV로 두고, 스크립트가 매일 만료일을 체크한 다음 30일 이내인 것만 구글 캘린더에 이벤트로 만든다. 구글 캘린더가 자체적으로 30일 전, 7일 전 알림을 준다. Slack 알림과 캘린더 알림, 두 라인으로 받는 셈이다.
구글 캘린더 API를 쓰면 되는데, 인증 세팅이 은근 까다롭다. 서비스 계정을 만들고, 캘린더를 하나 새로 파서 그 캘린더에 서비스 계정을 초대해야 한다. 처음 세팅에 시간이 좀 들지만, 한 번 해두면 도메인이 늘어나도 스크립트에 한 줄 추가하면 끝이다.

SSL 만료 알림을 슬랙이나 이메일로 받으려면
Slack Webhook으로 만료 알림 쏘기
Slack 워크스페이스 설정에서 Incoming Webhook을 하나 만든다. URL이 하나 나오는데, 그걸 스크립트의 SLACK_WEBHOOK 변수에 넣으면 끝이다. 채널은 #alerts 같은 곳으로 고정하는 게 낫다.
알림을 받아도 놓치지 않는 세팅
이게 진짜 중요한 부분이다. 알림을 받고도 놓친 적이 있다. 이메일로 받았는데 다른 메일에 파묻혀서 안 봤고, Slack 알림도 채널이 많으니까 스크롤하다가 지나갔다. 그래서 알림이 오면 무조건 확인하는 채널을 하나로 좁혔다. 지금은 Slack의 #alerts 채널 하나만 알림 채널로 쓰고, 그 채널은 모바일 푸시 알림을 켜두었다.
이메일 알림은 보조 수단이다. UptimeRobot이 보내는 이메일을 전부 같은 라벨로 묶어두고, 라벨이 있으면 자동으로 별표를 치게 해놨다. 그래야 밀려있는 메일 속에서 눈에 띈다.

SSL 만료로 서비스가 죽기 전에 어떻게 예방하나
만료 30일/7일/당일 대응 우선순위
| 남은 일수 | 상황 | 대응 |
|---|---|---|
| 30일 전 | 정상 | certbot renew --dry-run으로 미리 테스트. 여기서 실패하면 원인을 잡고 넘어간다 |
| 7일 전 | 경고 | 강제 갱신 시도 (certbot renew --force-renewal). DNS, 포트 점유 여부 재확인 |
| 당일 | 긴급 | 수동 갱신. 안 되면 임시 인증서로 교체하거나 Cloudflare를 앞단에 둬서 HTTPS를 우회 |
1인 운영자가 세팅하면 안 되는 것
이 스크립트는 단일 VPS 기준이다. 나는 멀티 리전에서는 이걸 그대로 못 썼다. 서버가 여러 대면 각 서버에서 인증서를 관리하는 게 아니라 로드밸런서나 CDN 뒤로 묶어서 인증서를 한 곳에서 관리하는 게 맞다. Cloudflare나 AWS Certificate Manager 같은 걸 쓰면 만료 걱정 자체가 없어진다. 단일 서버에서 Let’s Encrypt를 직접 굴릴 때만 이 글의 세팅이 의미가 있다.
정리: 1인 운영자가 오늘 세팅해야 할 것
- 만료일 체크 스크립트를 서버에 올리고 cron에 등록한다. 도메인 리스트를 스크립트 안에 적는다.
- Slack Webhook URL을 발급받아서 스크립트에 넣는다. 매일 오전에 한 번씩 돌게 한다.
- certbot renew 훅에 Slack 알림 스크립트를 넣어서 갱신 성공/실패를 실시간으로 받는다.
세팅이 끝나면 그 다음엔 이걸 Pipedeck 같은 자동화 파이프라인에 붙여서, 만료일이 임박하면 자동으로 갱신 트리거까지 날리는 걸 고민하면 된다. 내가 운영하는 자동화 서비스나 포트폴리오는 https://wallenstein.dev 에 정리해뒀다.
아일리고입니다. 자동화를 만들고 굴리며 겪은 일을 여기에 적습니다. 숏폼 영상은 ClipSquare 를 씁니다.
궁금해할 만한 것들
SSL 만료 자동 알림이 없을 때 가장 큰 문제는 무엇인가요?
인증서 만료 후에도 서비스가 멀쩡하게 돌아가는 것처럼 보이다가, 만료일이 지나는 순간 한꺼번에 서비스가 죽어버립니다. 결국 사용자 문의를 받고 나서야 하루 종일 서비스가 죽어있었다는 사실을 뒤늦게 알게 됩니다.
certbot 자동 갱신을 켜뒀는데도 SSL 갱신이 실패하는 이유는 무엇인가요?
DNS 전파 지연, 80번 포트 점유, 레이트 리밋, 혹은 cron 데몬이 죽어있는 경우 등 다양한 원인이 있습니다. 공통점은 에러가 로그 파일에 조용히 쌓이기만 할 뿐 따로 알림이 없어 성공했다고 착각하게 만든다는 것입니다.
SSL 만료일을 매일 자동으로 체크하는 가장 가벼운 방법은 무엇인가요?
openssl s_client로 만료일을 뽑아내는 셸 스크립트를 작성해 cron으로 매일 실행하는 방법이 있습니다. 만료일이 7일 이내로 줄어들면 Slack이나 이메일로 무조건 알림을 받도록 설정하여 사전에 대응할 수 있습니다.
Let’s Encrypt 자동 갱신 실패 로그는 어디서 확인할 수 있나요?
certbot의 로그는 /var/log/letsencrypt 디렉토리에 쌓입니다. 갱신이 실행될 때마다 letsencrypt.log 파일이 새로 생기고 이전 로그는 letsencrypt.log.1 형식으로 로테이션되므로 이 경로를 확인하면 됩니다.
UptimeRobot과 자체 스크립트 중 어떤 방식으로 SSL 만료를 모니터링해야 하나요?
5개 도메인 이내라면 UptimeRobot 무료 티어로 웹에서 클릭 몇 번만으로 세팅하는 것이 가장 편합니다. 도메인이 많아지거나 알림 간격을 자유롭게 커스텀해야 한다면 Slack 연동 자체 스크립트를 cron에 넣어 운영하는 것이 낫습니다.
자체 스크립트로 SSL 만료를 체크할 때 서버가 죽으면 어떻게 하나요?
서버가 죽으면 스크립트도 함께 죽기 때문에 알림이 오지 않는 치명적인 문제가 발생합니다. 그래서 매일 아침 알림이 정상적으로 오는지 습관적으로 확인하는 루틴을 만들거나, 외부 모니터링 도구와 병행하는 것이 안전합니다.
