Blog >> Linux >> Whitepapers.
certbot SSL 인증서 추가
먼저 인증서를 설치 할 도메인이 IP에 정확히 연결이 되어 있는지 확인한다.
– ping 커맨더 혹은 브라우저 접속으로 확인
– Apache 에 mod_ssl, mod_rewrite 모듈 확인
– 방화벽 서비스 열림 확인 80(http), 443(https), 일반적으로 zone 옵션 생략
~]# ping example.com
~]# httpd -M | grep ssl
ssl_module (shared)
~]# httpd -M | grep rewrite
rewrite_module (shared)
~]# firewall-cmd --zone=public --list-all
services: cockpit dhcpv6-client http https- ssl 설정을 수동 추가하기 위한 certbot certonly –webroot -w 로 인증서 설치.
- /etc/letsencrypt/live/ 디렉토리에 인증서 디렉터리 생성 확인.
- /etc/httpd/services.d/ config 파일 수정 및 ssl config 파일 생성
- apachectl configtest 후 웹 서비스 재 시작 apachectl graceful
- 갱신할 systemd 설정 확인.
- 갱신 시 필요한 변수 확인 /etc/sysconfig/certbot – $RENEW_HOOK 없음.
- certbot-renew.service $RENEW_HOOK 제거 오버라이드
- 데몬 리로드 systemctl daemon-reload
- 검증 30줄 정도 journalctl -u certbot-renew.service –no-pager | tail -n 30
example.com, www.example.com 두 도메인을 example.com 파일명으로 인증서 설치.
설정 파일의 수정 없이 인증서만 발급 받아 설치 후 수동으로 서비스 파일 수정할 계획.certbot certonly --webroot \
-w /host/example.com/public_html \
--cert-name example.com \
-d example.com -d www.example.com
– 먼저 로그 기록 하겠다. 이메일 등록할래? 묻고
– ACME server 에 등록해야 한다. 뭐 이렇게 뜨고 동의하면 설치를 진행 한다.
– 잘 설치 되었고, 갱신은 백그라운드에 등록해서 자동 갱신한다. 뭐 이러네요.
– 백그라운드 등록 확인, 크론 혹은 타이머 둘 중 하나에 등록 예상. 리눅스가 최신이니 타이머 아닐까?
– 타이머 확인하면 맞고, 대략 하루 두번 0시 12시 하는데, 실행 시점은 랜덤 지연 포함해서 분산 되도록 했네요.
~]# certbot certonly --webroot \
-w /host/example.com/public_html \
--cert-name example.com \
-d example.com -d www.example.com
.....중략......
These files will be updated when the certificate renews.
Certbot has set up a scheduled task to automatically renew this certificate in the background.
# 심볼릭링크 잘 걸려있나 확인.
~]# ls -la /etc/letsencrypt/live/example.com/
~]# systemctl cat certbot-renew.service
# /usr/lib/systemd/system/certbot-renew.service
[Unit]
Description=This service automatically renews any certbot certificates found
[Service]
EnvironmentFile=/etc/sysconfig/certbot
Type=oneshot
ExecStart=/usr/bin/certbot renew --noninteractive --no-random-sleep-on-renew $PRE_HOOK $POST_HOOK $RENEW_HOOK $DEPLOY_HOOK $CERTBOT_ARGS
~]# systemctl cat certbot-renew.timer
# /usr/lib/systemd/system/certbot-renew.timer
[Unit]
Description=This is the timer to set the schedule for automated renewals
[Timer]
OnCalendar=*-*-* 00/12:00:00 # 매일 00:00과 12:00에 실행 시도
RandomizedDelaySec=12hours # 00시~12시 사이, 또는 12시~24시 사이에 무작위 실행
Persistent=true # 시스템이 꺼져 있다가 켜져도 누락된 실행을 보완해서 실행
[Install]
WantedBy=timers.target직접적으로 갱신 시. – –webroot 옵션은 리뉴얼 설정 파일에 기록되어 있음.
certbot renew --deploy-hook "apachectl graceful"
# --deploy-hook: 인증서가 실제로 갱신된 경우에만 실행됨
# --deploy-hook은 --renew-hook보다 최신 방식이며, Certbot 0.22 이후 권장
# --renew-hook은 모든 renew 시도마다 실행되지만, --deploy-hook은 실제 갱신이 있을 때만 실행
# apachectl graceful: 무중단으로 Apache 설정 reload타이머로 갱신 시 자동으로 Apache 를 자동으로 리로드 해야겠죠.- systemd 서비스를 이용.
기존 certbot-renew.timer 가 systemd로 등록되어 있으니,systemctl edit certbot-renew.service 명령어를 통해 override.conf라는 덮어쓰기(오버라이드) 파일을 생성하여 설정을 변경하는 것이 일반적. 하지만 중요!!
certbot 에 아파치 재 시작 하도록 –deploy-hook 추가할 때 직접 오버라이드 작업 금지.
- 전역 적용의 문제: systemd 타이머를 오버라이드 하면 서버 내의 모든 도메인 인증서 갱신 작업에 해당 훅이 일괄(Global) 적용된다.
- 유지보수 불편: Certbot 패키지가 업데이트 될 때 시스템 서비스 파일 구조가 변경되면 충돌이 발생할 수 있으며, 나중에 설정이 어디서 실행되는지 추적하기 매우 까다로워진다.
- 그래서 /etc/letsencrypt/renewal/[도메인].conf 파일에 추가 – deploy_hook = apachectl graceful 이런 식으로.
- 그리고 /etc/sysconfig/certbot 파일 확인 해보면. 네 가지 변수를 가지고 있는데, $RENEW_HOOK 은 없음.
최신 변수 $DEPLOY_HOOK 을 써야겠지?
~]# vi /etc/letsencrypt/renewal/[도메인].conf
version = 4.2.0
archive_dir = /etc/letsencrypt/archive/*****.kr
cert = /etc/letsencrypt/live/*****.kr/cert.pem
privkey = /etc/letsencrypt/live/*****.kr/privkey.pem
chain = /etc/letsencrypt/live/*****.kr/chain.pem
fullchain = /etc/letsencrypt/live/*****.kr/fullchain.pem
# Options used in the renewal process
[renewalparams]
# Deploy Hook 으로 처리 - Renew Hook 은 구버전 삭제 예정
deploy_hook = apachectl graceful # 중요 Deploy Hook 추가
account = ***********
authenticator = webroot
webroot_path = /host/*****.kr/public_html,
server = https://acme-v02.api.letsencrypt.org/directory
key_type = ecdsa
[[webroot_map]]
www.yjco.kr = /host/*****.kr/public_html
yjco.kr = /host/*****.kr/public_html
~]# vi /etc/sysconfig/certbot
# 요렇게 네가지만 있음.
$PRE_HOOK=""
$POST_HOOK=""
$DEPLOY_HOOK=""
$CERTBOT_ARGS=""그래서 certbot-renew.service 를 오버라이드 함.
~]# systemctl edit certbot-renew.service
### Editing /etc/systemd/system/certbot-renew.service.d/override.conf
### Anything between here and the comment below will become the contents of the drop-in file
# 2026-10-06 지엘디지털 설정: 구버전 RENEW_HOOK 변수 경고 제거
[Service]
ExecStart=
ExecStart=/usr/bin/certbot renew --noninteractive --no-random-sleep-on-renew $PRE_HOOK $POST_HOOK $DEPLOY_HOOK $CERTBOT_ARGS
### Edits below this comment will be discarded
### /usr/lib/systemd/system/certbot-renew.service
# [Unit]
# Description=This service automatically renews any certbot certificates found
#
# [Service]
# EnvironmentFile=/etc/sysconfig/certbot
# Type=oneshot
# ExecStart=/usr/bin/certbot renew --noninteractive --no-random-sleep-on-renew $PRE_HOOK $POST_HOOK $RENEW_HOOK $DEPLOY_HOOK $CERTBOT_ARGS
:wq
Successfully installed edited file '/etc/systemd/system/certbot-renew.service.d/override.conf'.오버라이드 잘 적용 되었는지 확인.
데몬 리로드 하고. – systemctl edit 는 리로드 필요하지 않다고 함.
경고가 사라졌는지 아래 journalctl 명령어로 즉시 검증 – 한 30줄 정도?
수정 한 후에는 반드시 시뮬레이션으로 확인 합니다.
~]# systemctl cat certbot-renew.service
# /usr/lib/systemd/system/certbot-renew.service
[Unit]
Description=This service automatically renews any certbot certificates found
[Service]
EnvironmentFile=/etc/sysconfig/certbot
Type=oneshot
ExecStart=/usr/bin/certbot renew --noninteractive --no-random-sleep-on-renew $PRE_HOOK $POST_HOOK $RENEW_HOOK $DEPLOY_HOOK $CERTBOT_ARGS
# /etc/systemd/system/certbot-renew.service.d/override.conf
# 2026-10-06 지엘디지털 설정: 구버전 RENEW_HOOK 변수 경고 제거
[Service]
ExecStart=
ExecStart=/usr/bin/certbot renew --noninteractive --no-random-sleep-on-renew $PRE_HOOK $POST_HOOK $DEPLOY_HOOK $CERTBOT_ARGS
~]# systemctl daemon-reload
~]# journalctl -u certbot-renew.service --no-pager | tail -n 30
10월 06 19:36:50 204.gldigital certbot[1790896]: Certificate not yet due for renewal
10월 06 19:36:50 204.gldigital certbot[1790896]: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
10월 06 19:36:50 204.gldigital certbot[1790896]: The following certificates are not due for renewal yet:
10월 06 19:36:50 204.gldigital certbot[1790896]: /etc/letsencrypt/live/surfnsnow.kr/fullchain.pem expires on 2027-01-04 (skipped)
10월 06 19:36:50 204.gldigital certbot[1790896]: /etc/letsencrypt/live/tv.dhgb.co.kr/fullchain.pem expires on 2027-01-04 (skipped)
10월 06 19:36:50 204.gldigital certbot[1790896]: /etc/letsencrypt/live/yjco.kr/fullchain.pem expires on 2026-11-06 (skipped)
10월 06 19:36:50 204.gldigital certbot[1790896]: No renewals were attempted.
10월 06 19:36:50 204.gldigital certbot[1790896]: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
10월 06 19:36:50 204.gldigital systemd[1]: certbot-renew.service: Deactivated successfully.
10월 06 19:36:50 204.gldigital systemd[1]: Finished certbot-renew.service - This service automatically renews any certbot certificates found.
~]# certbot renew --dry-run이제 인증서 조회 및 목록 확인. 그리고 스크립트 제조.
~]# certbot certificates
~]# certbot certificates --cert-name tv.dhgb.co.kr
# 와일드 카드 도메인은 직접 조회
~]# openssl x509 -in /etc/letsencrypt/live/gldigital.co.kr/cert.pem -noout -dates
~]# openssl x509 -in /etc/letsencrypt/live/gldigital.co.kr/cert.pem -noout -dates -subject
~]# openssl x509 -in /etc/letsencrypt/live/gldigital.co.kr/cert.pem -noout -text | grep -A 1 "Subject Alternative Name"
~]# custom-check-cert.sh
🔐 SSL 인증서 상태 확인 도구입니다.
도메인을 입력하세요 (예: example.com): gldigital.co.kr
📅 인증서 만료일: Jan 10 02:42:57 2027 GMT
⏳ 남은 일수: 89일
✅ 인증서는 아직 유효합니다.


