경고가 뜬 순간, 자동 갱신이 있었는데 왜 사이트가 안 열릴까
SSL 인증서 만료 경고를 처음 보면 머릿속이 하얘집니다. 자동 갱신을 걸어 뒀는데 왜 이러지 싶고, 자동 갱신 실패인지 아예 안 돈 건지도 헷갈리죠. 저도 운영 서버에서 같은 경고를 처음 마주했을 때 제일 먼저 든 생각이 “자동화가 죽었나”였습니다. 지금은 서비스 7개를 한 서버에서 돌리는데, 그중 하나가 조용히 멈춘 적이 있었어요.
브라우저 경고는 만료됐다는 사실 하나만 말해 줍니다. Chrome에서는 보통 NET::ERR_CERT_DATE_INVALID가 뜨는데, 이 문구로는 어느 파일이 낡았는지, 갱신이 실패했는지, 웹서버가 새 파일을 읽었는지 알 수 없어요. 원인이 하나로 정해져 있지 않다는 뜻입니다. 파일이 그대로인 경우, 파일은 새것인데 웹서버가 옛 인증서를 쥐고 있는 경우, 중간 인증서가 빠진 경우, 서버 여러 대 중 한 대만 갱신된 경우가 전부 같은 경고로 보입니다.
그래서 확인 순서를 정해 뒀습니다. 먼저 디스크의 파일을 보고, 다음으로 서버가 실제로 응답하는 인증서를 보고, 마지막에 로그를 봅니다. 이 순서를 지키면 막연한 불안이 “어느 단계가 틀렸나”라는 질문으로 바뀝니다.
갱신이 됐는지 실패했는지 어떻게 판정하나
판정 기준을 로그 문구에 두면 안 됩니다. cron 로그에 에러 없이 끝난 줄이 있었는데 파일 만료일은 그대로였던 적이 있어요. certbot은 아직 갱신할 시기가 아니면 그냥 넘어가거든요. 그래서 기준을 “파일의 만료일이 실제로 바뀌었는가”로 잡았습니다.
sudo openssl x509 -enddate -noout -in /etc/letsencrypt/live/example.com/cert.pem
notAfter= 뒤에 만료 날짜가 찍힙니다. 갱신 전후로 이 값을 비교하면 파일이 바뀌었는지 바로 압니다. 서버가 실제로 쓰는 인증서는 따로 확인해야 합니다. 파일과 응답이 다를 수 있으니까요.
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -enddate -fingerprint -sha256
dry-run은 실제 인증서를 바꾸지 않고 갱신 절차가 통하는지만 확인합니다. 인증 검증 경로가 막혀 있으면 여기서 먼저 드러나요. 다만 dry-run이 통과해도 배포 훅(reload)이 성공한다는 보장은 없습니다.
sudo certbot renew --dry-run
sudo certbot renew --quiet --non-interactive; echo "exit=$?"
이 부분에서 실패를 언제 알 수 있는지도 생각해야 합니다. certbot은 만료가 가까워졌을 때만 실제로 갱신을 시도합니다. 그러니 설정이 깨진 날부터 만료 임박 상황이 올 때까지 시간 간격이 있어요. 실패를 “깨진 날” 알아채는 게 아니라, 아무 신호도 없다가 만료가 다가와서야 알아채게 됩니다. 이 간격을 줄이는 방법은 뒤에서 따로 다룹니다.
갱신은 됐는데 경고가 뜨는 대표 원인 5가지
파일과 응답을 비교하면 원인이 대부분 갈립니다. 아래 표 순서대로 확인하면 됩니다.
| 증상 | 먼저 볼 것 | 원인과 조치 |
|---|---|---|
| 파일 만료일은 새것인데 브라우저는 옛 날짜 | 서버 응답의 enddate와 파일 enddate 비교 | reload 누락. 웹서버를 다시 읽게 합니다 (systemctl reload nginx) |
| 일부 기기나 도구에서만 경고 | openssl s_client의 Verify return code | 중간 인증서 누락 (unable to verify the first certificate). cert.pem 대신 fullchain.pem을 지정 |
| 어떤 IP는 정상, 어떤 IP는 옛 날짜 | 서버마다 직접 접속해서 enddate 확인 | 여러 서버나 로드밸런서 중 일부만 교체. 배포 훅이 모든 대상에 가는지 확인 |
| www 주소에서만 경고 | 인증서의 DNS: 항목 목록 | www가 인증서 도메인에 빠짐. certbot -d example.com -d www.example.com 으로 재발급 |
| 파일은 갱신됐는데 서버는 여전히 옛 파일 | nginx -T로 ssl_certificate 경로 확인 | 설정이 옛 디렉터리나 옛 심볼릭 링크를 가리킴. 경로 수정 후 reload |
체인은 이렇게 확인합니다.
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | grep "Verify return code"
0 (ok)가 나오면 체인은 정상입니다. 중간 인증서가 빠지면 “unable to verify the first certificate” 계열 값이 찍힙니다. 제가 겪은 건 reload를 빼먹은 경우였어요. 갱신 훅이 인증서 파일만 바꾸고 웹서버는 그대로 두니 옛 인증서가 계속 응답했습니다. 파일 날짜만 보고 “갱신 됐네” 하고 넘어갔다면 한참 헤맸을 겁니다.

cron에서만 실패할 때: 환경 차이를 나눠 보고 터미널에서 재현하기
터미널에서는 잘 되는데 cron에서만 실패하면 제일 답답합니다. cron은 로그인 셸이 아니라서 환경이 훨씬 빈약해요. 서버에는 cron이 70개 돌고 있어서 이런 차이가 한 번씩 튀어나옵니다. 차이를 다섯 가지로 나눠 보면 대부분 짚입니다.
- PATH: 터미널에 있던 경로가 cron에는 없습니다. certbot이 /usr/local/bin에 있으면 cron에서 못 찾아요.
- 환경변수: 셸 설정 파일에서 export한 토큰이나 값이 cron에는 전달되지 않습니다.
- 작업 디렉터리: cron은 보통 홈이나 루트에서 시작합니다. 상대 경로로 쓴 배포 훅 스크립트가 여기서 깨집니다. 제가 한 번 헤맸던 원인이 이거였어요.
- stdin: certbot이 질문을 던지면 cron은 입력할 곳이 없어서 멈춥니다. –non-interactive를 붙이거나 명시적으로 입력을 막아야 합니다.
- 권한: 사용자 crontab에서 돌리면 포트 바인딩이나 인증서 디렉터리 쓰기가 막힐 수 있습니다. 인증서 작업은 root crontab에 두는 쪽이 단순했어요.
재현은 환경을 비운 채로 같은 명령을 돌리는 방식입니다.
env -i HOME=$HOME PATH=/usr/bin:/bin SHELL=/bin/sh /bin/sh -c 'cd / && /usr/bin/certbot renew --dry-run < /dev/null'
이렇게 돌렸을 때 실패하면 터미널의 PATH나 환경변수 때문에 생긴 문제입니다. 여기서도 안 되면 실제 cron 환경을 직접 봐야 합니다. 임시로 crontab에 env 출력 줄을 넣고 결과를 파일로 받아 보면 됩니다. 확인이 끝나면 꼭 지우세요. 로그가 쌓입니다.
0 3 * * * /usr/bin/certbot renew --quiet --non-interactive --deploy-hook "/usr/bin/systemctl reload nginx" >> /var/log/certbot-renew.log 2>&1
절대 경로, stdin 차단, 로그 리다이렉션을 한 줄에 다 넣었습니다. 2>&1을 빼면 실패 메시지가 어디에도 안 남아서 나중에 원인을 못 찾아요. 배포 훅은 실제로 인증서가 갱신된 경우에만 실행된다는 점도 기억해 두세요. 갱신 자체가 안 됐으면 reload도 안 돕니다.
아직 못 푼 게 하나 있습니다. DNS-01 방식으로 수동 TXT 기록을 넣는 훅은 cron에서 돌릴 수 없어서, 이 경우는 여전히 사람이 직접 발급합니다.

갱신 실패 알림과 만료 임박 알림은 따로 만든다
두 알림은 목적이 다릅니다. 갱신 실패 알림은 cron이 에러를 내는 순간 울려야 하고, 만료 임박 알림은 갱신이 조용히 멈춰 있어도 날짜로 잡아내야 합니다. 저는 만료 D-30, D-14, D-7 세 단계를 기준으로 잡았습니다. 어디까지나 제가 정한 단계이고, 날짜가 가까워질수록 알림 강도를 올리는 식입니다.
#!/bin/sh
# 사용법: check-cert.sh example.com
DOMAIN="$1"
END=$(echo | /usr/bin/openssl s_client -connect "$DOMAIN:443" -servername "$DOMAIN" 2>/dev/null \
| /usr/bin/openssl x509 -noout -enddate | cut -d= -f2)
if [ -z "$END" ]; then
echo "$DOMAIN: 인증서를 읽지 못함"
exit 2
fi
LEFT=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
if [ "$LEFT" -le 30 ]; then
echo "$DOMAIN: 만료까지 ${LEFT}일"
exit 1
fi
exit 0
이 스크립트는 응답하는 인증서를 기준으로 봅니다. 파일을 보지 않으니 reload 누락도 잡혀요. 단계별 중복 방지는 단계 번호를 파일에 적어 두고, 이미 보낸 단계면 건너뛰는 방식이면 충분합니다. 같은 알림이 하루에 여러 번 와서 무시하게 되는 게 제일 나쁩니다.
문제는 이 스크립트도 로컬 cron에서 돈다는 겁니다. 서버 전체가 멈추면 알림도 같이 멈춰요. 실제로 그런 적이 있어서, 바깥에서 같은 도메인을 감시하는 외부 만료 모니터링을 하나 더 붙였습니다. 메일이나 메신저 웹훅 중 평소에 실제로 보는 채널 하나로 묶는 것이 좋습니다. 여러 채널에 흩어 두면 확인하지 않게 됩니다.

자동화를 맡기면 안 되는 경우
자동 갱신이 모든 상황에 맞지는 않습니다. 와일드카드 인증서는 DNS 제공자의 API 토큰이 필요해서, 토큰 권한이나 API 정책이 바뀌면 조용히 실패합니다. 공유 호스팅처럼 웹서버를 reload할 권한이 없는 환경에서는 갱신 파일이 생겨도 적용을 못 합니다. 이런 경우는 자동화에 기대기보다 만료 알림을 강하게 걸고 손으로 발급하는 편이 빠릅니다.
저의 기준은 단순합니다. 만료 D-7 이내인데 갱신 실패 기록이 남아 있으면 자동화를 멈추고 수동 발급으로 돌아갑니다. 자동화 스크립트를 고치는 동안 인증서가 먼저 만료되면 이득이 하나도 없어요. 자동화는 평소에 편하게 해 주는 도구이지, 마감 직전 장애를 막아 주는 도구가 아닙니다.
요약: 오늘 할 일 다섯 가지
- 인증서 파일의 만료일을 확인하고, 갱신 명령 전후 값을 비교합니다.
- 서버가 실제로 응답하는 인증서의 enddate와 체인 검증 결과를 확인합니다.
- certbot renew --dry-run을 돌리고, 실제 cron과 같은 줄에 로그 리다이렉션과 --non-interactive가 있는지 확인합니다.
- env -i로 cron 환경을 재현해서 실패하면 PATH, 환경변수, 작업 디렉터리 중 어디인지 나눕니다.
- 만료 임박 알림(D-30, D-14, D-7)과 외부 감시를 따로 붙입니다.
저는 주 단위로 cron 로그의 마지막 줄을 한 번 보는 습관을 유지하고 있습니다. 거창한 점검은 아니고 에러 문구가 남아 있는지 훑는 정도입니다. 이 습관만으로 모든 실패를 막지는 못하지만, 최소한 "만료가 코앞이었는데 몰랐다"는 상황은 줄었습니다.
아일리고입니다. 자동화를 만들고 굴리며 겪은 일을 여기에 적습니다. 숏폼 영상은 ClipSquare 를 씁니다.
자주 나오는 질문
SSL 인증서 자동 갱신을 걸어 뒀는데 만료 경고가 뜨는 이유는 뭔가요?
대부분은 갱신이 실패했거나, 파일은 새로 받았는데 웹서버가 옛 인증서를 계속 들고 있는 경우입니다. 먼저 파일의 만료일(openssl x509 -enddate)을 보고, 실제 응답 인증서와 비교해 보세요. 둘이 다르면 reload 누락부터 의심하면 됩니다.
인증서 파일 만료일은 바뀌었는데 브라우저에서는 여전히 경고가 뜨면 어떻게 하나요?
웹서버가 새 파일을 아직 읽지 않았을 가능성이 큽니다. openssl s_client로 서버가 응답하는 인증서의 enddate를 확인하고, 다르면 systemctl reload nginx로 다시 읽게 하세요. 서버가 여러 대라면 각 IP에 직접 접속해서 따로 봐야 합니다.
certbot renew --dry-run이 통과하면 자동 갱신은 안전한 건가요?
dry-run은 실제 인증서를 바꾸지 않고 검증 경로가 막혀 있지 않은지만 확인합니다. 그래서 통과해도 배포 훅의 reload가 성공한다는 보장은 없어요. 갱신 후 파일 만료일과 실제 응답 만료일을 한 번 더 비교하는 게 확실합니다.
일부 기기나 도구에서만 SSL 경고가 뜨는 건 왜 그런가요?
중간 인증서(체인)가 빠져 있을 때 자주 생깁니다. 브라우저는 체인을 알아서 채우는 경우가 많지만, 일부 기기와 도구는 그러지 못해서 경고를 냅니다. cert.pem 대신 fullchain.pem을 지정하고 Verify return code가 0인지 확인해 보세요.
cron에서만 certbot 갱신이 실패하고 터미널에서는 잘 되면 어디부터 봐야 하나요?
cron은 로그인 셸과 환경변수가 달라서 PATH나 권한 차이 때문에 결과가 다를 수 있습니다. 명령에 절대경로를 쓰고 출력을 로그 파일로 남겨서 exit 코드부터 확인하세요. 원인이 안 잡히면 같은 사용자 권한으로 터미널에서 재현하는 쪽이 빠릅니다.
인증서 만료 경고를 미리 알아채려면 어떻게 해야 하나요?
certbot은 만료가 가까워질 때만 갱신을 시도하기 때문에, 설정이 깨져도 만료 직전까지 아무 신호가 없을 수 있습니다. 그래서 실제 응답 인증서의 만료일을 주기적으로 확인하는 스크립트를 따로 두는 편이 안전합니다. 만료 30일 전쯤 알림이 오도록 임계값을 잡아 두면 여유가 생깁니다.
