Nginx에 SSL 인증서를 설치했더니 체인 오류가 나요. fullchain은 어떻게 만드나요?

Nginx에 SSL 인증서를 설치하는 방법을 fullchain 만들기, server 블록 설정, nginx -t 검사와 reload 순서로 정리했어요. 체인 오류 해결법도 알려드려요.

Nginx에는 서버 인증서와 중간인증서를 한 파일(fullchain)로 이어 붙여 ssl_certificate에 연결하면 돼요. 순서는 서버 인증서가 먼저, 중간인증서가 그다음이에요. 브라우저에서는 열리는데 curl이나 앱에서 체인 오류가 난다면 중간인증서가 빠졌을 가능성이 커요.

Nginx 인증서 설치 3단계: fullchain 파일 만들기, server 블록에 경로 연결, nginx -t 검사 후 reload

먼저 파일 3가지를 확인하세요

파일예시 이름설명
서버 인증서example.com.crt내 도메인용 인증서예요.
중간인증서(체인)intermediate.crt 또는 ca-bundle.crtCA가 함께 보내 준 파일이에요. 여러 장이면 서버 인증서를 발급한 중간인증서부터 위쪽 순서로 이어 붙여요.
개인키example.com.keyCSR을 만들 때 함께 생성한 키예요. 외부에 보내지 마세요.

파일은 모두 PEM 형식(-----BEGIN CERTIFICATE-----로 시작하는 텍스트)이어야 해요. PFX나 JKS 파일이라면 먼저 PEM으로 바꿔야 해요.

1단계: fullchain 파일 만들기

(cat example.com.crt; echo; cat intermediate.crt) > fullchain.crt
  • 순서: 서버 인증서가 맨 위, 중간인증서가 그 아래예요. 순서가 바뀌면 일부 클라이언트에서 오류가 나요.
  • 줄바꿈: 파일 끝에 줄바꿈이 없으면 END CERTIFICATE-----와 다음 BEGIN이 붙어 버려요. 위 명령은 사이에 빈 줄(echo)을 넣어 이를 막아요. 합친 뒤 파일을 열어 인증서마다 BEGIN·END 줄이 따로 있는지 확인하세요.
  • 루트 인증서: 브라우저와 운영체제가 이미 가지고 있어서 보통 넣지 않아도 돼요. CA가 안내한 번들이 있다면 그 안내를 따르세요.

2단계: server 블록에 연결하기

server {
    listen 443 ssl;
    server_name example.com www.example.com;

    ssl_certificate     /etc/nginx/ssl/fullchain.crt;
    ssl_certificate_key /etc/nginx/ssl/example.com.key;
    ssl_protocols       TLSv1.2 TLSv1.3;

    # 이하 root, location 등 기존 설정
}

경로는 내 서버에 맞게 바꾸세요. 개인키 파일은 소유자만 읽도록 chmod 600을 권장해요.

3단계: 검사하고 적용하기

sudo nginx -t
sudo nginx -s reload

nginx -t가 syntax is ok와 test is successful을 보여 주면 reload로 적용해요(systemd를 쓴다면 sudo systemctl reload nginx도 같아요). 오류가 나면 reload하지 말고 메시지가 가리키는 파일과 줄부터 고치세요. 적용 뒤에는 체인이 제대로 내려가는지 아래 명령으로 볼 수 있어요.

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null

출력에 인증서가 2개 이상(서버 인증서와 중간인증서) 보이고 마지막에 Verify return code: 0 (ok)가 나오면 정상이에요. 20 (unable to get local issuer certificate)나 21 (unable to verify the first certificate)가 나오면 중간인증서가 빠졌거나 순서가 틀린 경우가 많아요.

자주 나는 오류와 확인할 곳

증상가능한 원인확인할 것
key values mismatch 오류인증서와 개인키가 서로 짝이 아니에요아래 명령으로 두 값이 같은지 비교해요.
no start line 오류PEM이 아닌 형식이거나 파일 일부가 잘렸어요파일 맨 위·아래의 BEGIN/END 줄과 형식(PEM·DER·PFX)을 확인해요.
브라우저는 열리는데 curl·앱에서 체인 오류중간인증서가 빠졌어요fullchain에 중간인증서를 이어 붙였는지 확인해요.
시작할 때 비밀번호(PEM pass phrase)를 물어봐요개인키에 비밀번호가 걸려 있어요reload가 멈추거나 실패할 수 있어요. 비밀번호를 푼 키 파일을 쓰거나 ssl_password_file 설정을 확인해요.
https 접속이 안 돼요443 포트가 열려 있지 않아요listen 443 ssl 설정과 방화벽·보안그룹을 확인해요.

인증서와 개인키가 짝인지는 이렇게 비교해요. 두 결과가 같아야 해요.

openssl x509 -noout -pubkey -in example.com.crt | openssl md5
openssl pkey -pubout -in example.com.key | openssl md5

마지막 점검 목록

  • 서버 인증서·중간인증서·개인키 3개가 모두 있어요.
  • fullchain에서 서버 인증서가 맨 위에 있어요.
  • 인증서와 개인키 해시가 서로 같아요.
  • nginx -t를 통과한 뒤에 reload했어요.
  • https 접속과 체인 확인을 한 번 더 했어요.

코리아SSL과 함께 인증서를 관리하세요

인증서 선택부터 설치까지 궁금한 점은 코리아SSL에서 확인할 수 있어요. 인증서 상품은 SSL 인증서 안내에서 살펴보고, 설치나 발급 중 막히는 부분은 1:1 문의로 남겨 주세요.

댓글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다