4-08. Nginx 관련

• 스프링부트를 80 포트로 서비스하기
• Nginx를 사용하여 80 포트로 서비스하기
  • Nginx 설치
  • Nginx 설정
  • Nginx 실행
  • SBB 작동 확인하기

---

4-08. Nginx

---

점프 투 스프링부트 - WikiDocs

---

SBB 서비스는 현재 8080번 포트로 서비스를 하고 있다. 하지만 대부분의 인터넷 서비스는 8080번 포트 대신 80번 포트로 서비스를 한다. 80번 포트를 사용하면 고정아이피:80과 같이 사용해도 되고 고정아이피 처럼 80번 포트를 생략하여 사용할 수 있다. 왜냐하면 80번 포트가 HTTP 프로토콜의 기본(Default) 포트이기 때문이다.

이번 장에서는 SBB 서비스를 80번 포트로 사용할 수 있는 방법에 대해서 알아보자.

---

스프링부트를 80 포트로 서비스하기

스프링부트 서비스를 시작할때 -Dserver.port=80와 같은 옵션을 추가하여 스프링부트를 시작하면 80번 포트로 서비스가 가능하다. 단, 80번 포트로 서비스하기 위해서는 루트 권한으로 스프링부트를 시작해야 한다.

즉, 다음과 같이 실행하면 80번 포트로 서비스가 가능하다.

sudo java -Dserver.port=80 -jar sbb-0.0.2.jar

하지만 위와 같이 스프링부트에서 직접 80 포트를 지정하여 사용하는 방법은 추천하지 않는다. 왜냐하면 루트 권한으로 실행해야 한다는 단점 외에도 무엇보다도 SSL을 적용하여 https 서비스를 운영하기가 쉽지 않기 때문이다. SSL을 적용하려면 Nginx나 Apache와 같은 웹서버가 필요하다.

SSL을 적용하기 위해서는 도메인이 필요하므로 SSL을 적용하는 방법은 조금 후에 알아보자.

---

Nginx를 사용하여 80 포트로 서비스하기

Nginx는 높은 성능을 위해서 개발된 웹 서버로 설정이 무척 간단하여 쉽게 사용할수 있다. 이번에는 Nginx와 스프링부트를 연동하여 80번 포트로 서비스하는 방법에 대해서 알아보자.

Nginx 설치

다음과 같이 루트 권한으로 Nginx를 설치하자.

sudo apt install nginx

대략 10초 내외로 설치가 될 것이다.

Nginx 설정

그리고 다음처럼 /etc/nginx/sites-available 디렉터리로 이동하자.

cd /etc/nginx/sites-available/

./etc/nginx/sites-available 디렉터리는 Nginx의 설정 파일들이 위치한 디렉터리이다. 최초 설치시에는 deafult라는 설정 파일만 존재한다.

SBB 서비스에 대한 Nginx의 설정파일을 다음과 같이 관리자 권한으로 작성하자.

sudo nano sbb

그리고 sbb 파일의 내용은 다음과 같이 작성하자.

파일명: /etc/nginx/sites-available/sbb

server {
        listen 80;
        server_name localhost;

        location / {
                proxy_pass http://localhost:8080;
                proxy_set_header X-Real-IP $remote_addr;
                proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
                proxy_set_header Host $http_host;
        }
}

listen 80 은 웹 서버를 80 포트로 서비스 한다는 의미이다. HTTP 프로토콜의 기본포트는 80이다. 따라서 이제 http://3.37.58.70:8080 대신 포트를 생략하여 http://3.37.58.70 처럼 웹 브라우저에서 접속 할 수 있다.

server_name에는 localhost를 입력한다. 만약 ip와 연결된 도메인을 구입하였다면 localhost 대신 해당 도메인명을 적어주면 된다.location / { ... }은 /에 해당되는 URL, 즉 모든 요청에 대한 설정을 담당하는 영역이다. 세부 설정은 다음과 같다.

• proxy_pass - Nginx 웹서버의 모든 요청을 http://localhost:8080 로 리다이렉트한다.
• proxy_set_header - localhost:8080로 실행된 스프링부트 서버에 특정 헤더값을 전달하기 위해서 proxy_set_header를 사용한다. (Nginx를 통해서 스프링부트의 톰캣서버로 요청이 전달되기 때문에 "Remote IP" 헤더값이 실제 값이 아닌 127.0.0.1 처럼 잘못 전달되는 것을 방지하기 위해 사용한다.) 이제 작성한 sbb 파일을 Nginx가 환경 파일로 읽을 수 있도록 설정해야 한다.

다음처럼 /etc/nginx/sites-enabled 디렉터리로 이동하자.

cd /etc/nginx/sites-enabled/

.sites-enabled 디렉터리는 site-available 디렉터리에 있는 설정 파일 중에서 활성화하고 싶은 것을 링크로 관리하는 디렉터리이다.

ls 명령을 수행하면 현재 default 설정 파일만 링크됨을 확인할 수 있다.

ls
#
# default

이제 default 링크는 삭제하고 sbb 파일을 링크하도록 변경해야 한다.

먼저 다음처럼 default 링크를 삭제하자.

sudo rm default

그리고 다음처럼 sbb 파일을 링크하자.

sudo ln -s /etc/nginx/sites-available/sbb

ls 명령을 수행하면 default는 사라지고 sbb 링크만 남은 것을 확인할 수 있다.

ls
#
# sbb

Nginx 실행

Nginx는 설치할 때 자동으로 실행되므로 앞에서 작성한 Nginx 설정을 적용하려면 Nginx를 다음처럼 다시 시작해야 한다.

sudo systemctl restart nginx

혹시 Nginx 설정 파일에 오류가 발생했다면?

Nginx의 설정 파일에 오류가 있는지 확인하는 방법은 다음과 같다.

sudo nginx -t
#
# nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
# nginx: configuration file /etc/nginx/nginx.conf test is successful

nginx -t 명령 수행 시 오류가 발생한다면 설정이 올바르지 않은 경우이므로 Nginx서버가 정상적으로 실행되지 않을 것이다.

Nginx를 중지하는 명령은 다음과 같다.

sudo systemctl stop nginx

Nginx를 시작하는 명령은 다음과 같다.

sudo systemctl start nginx

SBB 작동 확인하기

Nginx를 적용했으니 웹 브라우저로 다음 URL에 접속해 보자.

http://3.37.58.70/ (여러분의 고정아이피를 사용하도록 하자.)

웹서버(Nginx)를 사용하기 때문에 이전과 달리 :8080과 같은 포트번호를 사용할 필요가 없어졌다. Nginx를 사용하면 HTTP 기본 포트인 80 포트를 사용할 수 있기 때문이다. 80 포트를 사용할 경우에는 http://3.37.58.70:80 처럼 사용해도 되지만 :80 을 생략할 수 있다.

다음처럼 완벽하게 실행되는 SBB를 확인할 수 있을 것이다.

만약 80 포트로 접속시 다음과 같이 502 오류가 발생한다면 이는 Nginx는 실행이 되었는데 스프링부트가 실행되지 않은 경우이므로 start.sh을 실행하여 스프링부트 서버를 실행하자.

---

이찬희 (MarkiiimarK)

Never Stop Learning.