엔진엑스(Nginx)

쉬운 설명

AI가 VPS 배포 방법을 알려 주면서 “Nginx 설정을 추가하세요”라고 할 수 있어요. Nginx가 직접 HTML·이미지 같은 파일을 보내기도 하고, 요청을 Node.js 같은 앱으로 전달하기도 해요. 뒤쪽 앱으로 전달하는 역할을 리버스 프록시라고 해요. Nginx를 설치하는 것과 내 앱의 연결 설정을 마치는 것은 별개예요.

이런 상황에서 만나요

서버 안에서 실행되는 스터디 앱을 도메인으로 연결하려고 Nginx 설정을 받았다고 해 볼게요. 아래는 HTTP 요청을 같은 환경의 3000번 포트로 전달하는 설정 일부예요.

server {
  listen 80;
  server_name study.example.com;
  location / {
    proxy_pass http://127.0.0.1:3000;
  }
}

nginx -t

server_name은 받을 도메인, proxy_pass는 요청을 전달할 대상이에요. 설정을 바꾼 뒤에는 문법과 참조 파일을 검사하고 정상일 때 다시 불러와요. 검사 통과 후에도 도메인 접속과 앱의 실제 응답은 별도로 확인해야 해요.

헷갈리기 쉬운 점

Nginx를 켰는데 기본 환영 화면만 보여요. 앱도 배포된 건가요?

기본 화면이 열린다는 사실만으로 앱 연결이 끝난 것은 아니에요. 내 도메인을 처리할 설정이 적용됐는지, 기본 사이트 설정과 겹치지 않는지, 전달할 앱이 실행 중인지 확인해요.

아래는 HTTP 설정 일부라 HTTPS 인증서 설정까지 포함하지 않아요. 설정 파일 위치와 다시 불러오는 명령은 설치 방식이나 컨테이너 사용 여부에 따라 달라요.

왜 알아야 할까요?

환영 화면, 502 오류, 앱 자체 오류를 같은 문제로 취급하지 않고 확인할 수 있어요. AI가 작성한 설정에서도 도메인과 전달 대상을 찾아 내 환경에 맞는지 대조할 수 있어요.

참고 자료

• NGINX · 입문 가이드
• NGINX · 명령줄 옵션