NGINX HTTPS SSL 지시자 경고 확인 및 해결 방법

NGINX에서 발생한 HTTPS SSL 관련 경고 로그 발생 원인과 해결 방법에 대해 알아봅니다.

최근 CentOS 6에서 CentOS 7로 서버 업그레이드 중 NGINX 웹 서버의 버전이 바뀌면서 해당 설정을 더 이상 사용하지 않기 때문에 발생하는 경고였습니다.

NGINX 설정 파일을 그대로 복사해서 적용햇으며, 웹 서비스를 정상적으로 시작되었으며, 경고 로그를 확인할 수 있었습니다.

 

NGINX HTTPS SSL 경고 로그 원인 확인하기

경로 로그 내용과 같이 NGINX 1.15.0 버전부터 ssl 지시문은 더 이상 사용되지 않기 때문에 발생한 로그입니다.

 

• NGINX 공식 문서 : Module ngx_http_ssl_module

 

This directive was made obsolete in version 1.15.0. The ssl parameter of the listen directive should be used instead

 

systemctl 명령을 사용해서 서비스 상태를 확인합니다.

systemctl status nginx

 

[root@runit.cloud]# systemctl status nginx
● nginx.service - The nginx HTTP and reverse proxy server
   Loaded: loaded (/usr/lib/systemd/system/nginx.service; enabled; vendor preset: disabled)
   Active: active (running) since Wed 2021-03-10 11:43:02 KST; 2s ago
  Process: 2790 ExecStart=/usr/sbin/nginx (code=exited, status=0/SUCCESS)
  Process: 2787 ExecStartPre=/usr/sbin/nginx -t (code=exited, status=0/SUCCESS)
  Process: 2785 ExecStartPre=/usr/bin/rm -f /run/nginx.pid (code=exited, status=0/SUCCESS)
 Main PID: 2792 (nginx)
   CGroup: /system.slice/nginx.service
           ├─2792 nginx: master process /usr/sbin/nginx
           └─2793 nginx: worker process

Mar 10 11:43:02 kpcs0711ddv systemd[1]: Stopped The nginx HTTP and reverse proxy server.
Mar 10 11:43:02 kpcs0711ddv systemd[1]: Starting The nginx HTTP and reverse proxy server...
Mar 10 11:43:02 kpcs0711ddv nginx[2787]: nginx: [warn] the "ssl" directive is deprecated, use the "listen ... ssl" directive instead in /etc/nginx/ssl.conf:1
Mar 10 11:43:02 kpcs0711ddv nginx[2787]: nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
Mar 10 11:43:02 kpcs0711ddv nginx[2787]: nginx: configuration file /etc/nginx/nginx.conf test is successful
Mar 10 11:43:02 kpcs0711ddv nginx[2790]: nginx: [warn] the "ssl" directive is deprecated, use the "listen ... ssl" directive instead in /etc/nginx/ssl.conf:1
Mar 10 11:43:02 kpcs0711ddv systemd[1]: Started The nginx HTTP and reverse proxy server.

 

NGINX HTTPS SSL 경고 로그 원인 해결하기

해당 ssl 지시문을 삭제하고, listen 구문에 ssl 지시자를 추가합니다.

• 경고가 발생한 /etc/nginx/ssl.conf 파일의 ssl on; 구문을 삭제합니다.
• NGINX 설정 파일의 listen 구문에 ssl 지시자 추가하기

server {
    listen      80;
    listen      443 ssl;

 

마무리

NGINX 버전 업데이트 시 발생하는 ssl 경고 로그의 원인을 확인하고, 해결하는 방법에 대해 알아보았습니다.

 

 

출처 : https://www.runit.cloud/2021/03/nginx-warn-ssl-directive-is-deprecated.html