기본 명령어

Nginx 기본 명령어

개요

Nginx는 systemctl 명령어로 서비스를 관리하고, nginx 명령어로 설정 테스트 및 제어 신호를 보낼 수 있다.

Nginx를 설치했으면 이제 제어할 줄 알아야겠죠? 자동차를 샀으면 운전하는 법을 배워야 하는 것처럼요! Nginx 제어는 크게 두 가지 방법이 있어요:

systemctl — 리눅스 서비스 관리 도구 (시작, 중지, 재시작 등)

nginx — Nginx 자체 명령어 (설정 테스트, 시그널 전송 등)

둘 다 알아두면 좋지만, 실무에서는 systemctl을 더 많이 사용해요!

Nginx 서비스 라이프사이클

mermaid

systemctl 명령어 (서비스 관리)

명령어	동작	연결 끊김	사용 시점
sudo systemctl start nginx	Nginx 시작	-	최초 시작, stop 후 재시작
sudo systemctl stop nginx	Nginx 중지	모든 연결 끊김	서버 점검, Nginx 제거 시
sudo systemctl restart nginx	중지 후 재시작	순간 끊김	SSL 인증서 교체, 큰 설정 변경
sudo systemctl reload nginx	설정만 재적용	끊김 없음	설정 변경 후 적용 (가장 추천!)
sudo systemctl status nginx	상태 확인	-	문제 진단, 상태 모니터링
sudo systemctl enable nginx	부팅 시 자동 시작	-	최초 설정 시 1회
sudo systemctl disable nginx	자동 시작 해제	-	자동 시작 불필요 시

reload vs restart 차이

graph TD
    subgraph "restart (재시작)"
        A1[Nginx 중지 🔴] --> A2[설정 파일 다시 읽기] --> A3[Nginx 시작 🟢]
        A4["⚠️ 순간적으로 서비스 중단"]
    end

    subgraph "reload (재적용)"
        B1[새 워커 프로세스 생성 🟢] --> B2[새 설정 적용]
        B3[기존 워커는 현재 요청<br/>처리 후 종료 🟡]
        B4["✅ 서비스 중단 없음!"]
    end
Mermaid
복사

설정을 변경한 후에는 reload를 사용하세요! restart는 모든 연결을 끊었다가 다시 시작하는 거라, 실서비스에서는 reload가 훨씬 안전해요. 현재 처리 중인 요청을 끝까지 처리한 다음에 새 설정을 적용하거든요.

nginx 명령어 (직접 제어)

명령어	동작	설명
sudo nginx	Nginx 시작	systemctl start와 유사
sudo nginx -s stop	즉시 중지	강제 종료 (SIGTERM)
sudo nginx -s quit	정상 종료	현재 요청 처리 후 종료 (SIGQUIT)
sudo nginx -s reload	설정 재적용	systemctl reload와 동일
sudo nginx -s reopen	로그 파일 재열기	로그 로테이션 후 사용
sudo nginx -t	설정 테스트	문법 오류 검사 (필수!)
sudo nginx -T	설정 출력 + 테스트	전체 설정을 화면에 출력
nginx -v	버전 확인	간단한 버전 정보
nginx -V	상세 정보	컴파일 옵션, 모듈 목록 등

가장 중요한 명령어: 설정 테스트

# 설정 파일 문법 검사
sudo nginx -t
Bash
복사

성공 시:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
Plain Text
복사

실패 시:

nginx: [emerg] unknown directive "sevrer" in /etc/nginx/sites-enabled/default:2
nginx: configuration file /etc/nginx/nginx.conf test failed
Plain Text
복사

설정을 변경한 후 reload/restart 하기 전에 반드시 nginx -t를 실행하세요! 문법 오류가 있는 상태에서 reload하면 Nginx가 죽을 수 있어요. 이 한 줄이 서비스 장애를 예방해줍니다!

실무 워크플로우

flowchart TD
    A[📝 설정 파일 수정] --> B["🧪 sudo nginx -t<br/>(설정 테스트)"]
    B -->|✅ 성공| C["🔄 sudo systemctl reload nginx<br/>(무중단 적용)"]
    B -->|❌ 실패| D["🔍 에러 메시지 확인<br/>설정 파일 수정"]
    D --> A
    C --> E["✅ 적용 완료!<br/>curl로 확인"]

    style B fill:#FFD700
    style C fill:#90EE90
    style D fill:#FFB3B3
Mermaid
복사

이 순서를 꼭 기억하세요: 수정 → 테스트 → 적용. 이 세 단계를 습관으로 만들면 절대 설정 실수로 서비스가 죽는 일이 없어요!

# 1. 설정 파일 작성
sudo nano /etc/nginx/sites-available/mysite

# 2. 심볼릭 링크 생성 (최초 1회)
sudo ln -s /etc/nginx/sites-available/mysite /etc/nginx/sites-enabled/

# 3. 설정 검사
sudo nginx -t

# 4. 적용
sudo systemctl reload nginx
Bash
복사

프로세스 구조 확인

graph TD
    A["Master Process<br/>(root 권한)<br/>PID 1234"] --> B["Worker Process 1<br/>(www-data)"]
    A --> C["Worker Process 2<br/>(www-data)"]
    A --> D["Worker Process 3<br/>(www-data)"]
    A --> E["Worker Process 4<br/>(www-data)"]

    style A fill:#FFD700
    style B fill:#90EE90
    style C fill:#90EE90
    style D fill:#90EE90
    style E fill:#90EE90
Mermaid
복사

# Nginx 프로세스 확인
ps aux | grep nginx

# 출력 예시:
# root      1234  ...  nginx: master process /usr/sbin/nginx
# www-data  1235  ...  nginx: worker process
# www-data  1236  ...  nginx: worker process
Bash
복사

프로세스	권한	역할
Master	root	설정 읽기, 워커 관리, 포트 바인딩
Worker	www-data	실제 클라이언트 요청 처리

Master 프로세스가 관리자 역할이고, Worker 프로세스가 실제로 일하는 직원이에요. reload 하면 Master가 새로운 Worker를 만들고, 기존 Worker는 하던 일을 마치고 퇴근해요!

핵심 정리

서비스 관리: systemctl start|stop|restart|reload|status nginx

설정 변경 후: 반드시 sudo nginx -t → sudo systemctl reload nginx

reload = 무중단 설정 적용 (실서비스에서 필수!)

restart = 완전 중지 후 재시작 (순간 서비스 중단)

nginx -t = 가장 중요한 명령어! 설정 테스트 필수!