Nginx

Nginx의 설치 및 환경 구성( 기본적인 명령어 및 파일구성 / 무중단 배포를 위한 재시작 명령어 )

_Jin_ 2026. 5. 8.

Nginx 설치 및 사용하기(feat. Docker)

Nginx를 설치하고 사용하는 방법에 대해서 간단히 알아보자.

먼저 현재 Window OS 기반의 컴퓨터를 사용하기 때문에 도커를 사용하여 Nginx를 설치하고 실행한다.

 

Docker 실행 명령어 입력하기

< 명령어 >

docker run --name my-nginx -d -p 80:80 nginx

 

 

Nginx 실행파일에 접근 및 분석

 

아래와 같은 명렁어 과정을 통해 도커를 띄운 Nginx 실행 파일에 접근한다. 

 

 

Nginx 실행 파일 목록

 

설치된 Nginx 실행 파일 목록에는 위와 같은 파일들이 있으며

파일 목록 중에서 nginx.conf 파일은 메인 설정 파일로 가장 중추적인 역할을 담당하는 파일이다. 

Nginx의 모든 설정이 해당 파일에서 시작되는 것이기 때문이다. 

 

그리고 var/log/nginx 경로로 이동하면 log 파일이 존재한다.

말 그대로 클라이언트의 접속 로그가 존재하는 파일로 문제가 발생하면, 디버깅에 접근하여 살펴봐야할 파일인 것이다. 

 

한편 정적 파일들을 관리하는 경로에 접근해 살펴보자.

웹 파일(정적 파일) 위치는 /var/www/html 또는 /usr/share/nginx/html에 존재한다. 

 

 

 

Nginx 실행 및 중단, 재시작하기

 

Nginx 실행

Nginx를 실행하는 방법에는 nginx 명령어를 통해 바로 실행할 수 있다.

 

Nginx 명령어를 통해 실행하니 이미 Nginx가 실행 중이라고 로그가 발생한다.

실행 중임을 확인해보니 아래의 이미지처럼 master와 worker 프로세스가 실행 중이다. 

 

( 아래의 명령어가 실행되지 않는다면 아래의 명령어를 통해 필요한 도구를 설치하자 )

apt update
apt install procps -y

 

 

 

Nginx 중단

반면, Nginx를 중지하는 방법은 크게 두 가지 명령어가 있다.

nginx -s stop
nginx -s quit

 

 

nginx -s quit 명령어 실행 후에 실행 상태를 살펴보니 

프로세스가 종료중에 있는 아래와 같은 모습을 확인할 수 있었다.

 

그리고 곧 컨테이너가 내려갔다.

 

 

Nginx 재시작( for 무중단 배포 )

다음으로는 Nginx를 다시 실행하는 방법에 대해서 알아보자.

명렁어는 아래와 같다.

nginx -s reload

 

해당 명령어는 Nginx를 재시작하지 않고도 설정 변경을 적용할 수 있는 명령어이다.

만약 무중단 서비스를 운영한다면 해당 경우에 있어 Nginx의 설정을 변경하는 경우 중요한 명령어가 될 것이다.

 

이 과정을 좀 더 심도깊게 이해하자면, 아래와 같은 모식도를 따라 이뤄진다.

 

 

해당 명령어를 실행하면, Master Process는 새로운 Worker Process를 생성한다. 

그리고 기존에 들어온 명령어는 기존 Worker를 통해 실행하고, 명령어를 실행시킨 이후의 요청은 받지않는다.

대신 새롭게 생성한 Worker를 통해서 명령어 이후로 들어온 요청을 처리하여 무중단 상태에서 새로운 버젼의 설정파일을 실행시킬 수 있게된다.  

 

 

Nginx 문법 검사 (Nginx.conf 파일)

Nginx를 사용하면서 대부분의 경우 앞서 말했듯 conf파일을 건드리게 된다.

따라서 해당 파일을 수정한 뒤 문법적 오류가 있는지 확인이 필요할 때는 아래의 명령어를 통해 검사할 수 있다. 

nginx -t

 

 

명령어를 실행한 뒤에는 검사를 무사히 통과하였는 지 ok , successful을 통해 확인 가능하다.

 

댓글