NAS 와 Linux 서버에서 Reverse Proxy 사용하기 (feat. Nginx Proxy Manager)

개요

NAS 의 기본포트를 수정하지 않고, Nginx Proxy Manager 를 이용하여 프록시 서버를 구현할 수 있다. 이를 간단하게 따라할 수 있도록 소개한다.

1. 검색을 해보면 Nginx Proxy Manager 를 이용하는 분들이 많은 것을 알게 되었다. 그리고 NAS 의 기본 포트인 80/443 을 변경하여 설정하는 것도 확인했다.

2. Linux 서버에서 프록시 서버를 구축할 경우, 80/81/443 이외의 포트로 운영할 방법이 필요할 수 있다. 또한 Nginx Proxy Manager 에서는 Container 안에서 밖으로 통신 할 수 있는 host.docker.internal 방법이 적용되지 않는다. 이슈카드가 열려있다. 그래서 docker container 의 network mode 를 host 로 열고 사용할 경우에도 기본포트를 변경해야 한다.

Nginx Proxy Manager 를 이용하면서 서비스 포트를 변경하고 싶은 경우, 아래 내용살펴보자.

Nginx Proxy Manager

Nginx Proxy Manager

This project comes as a pre-built docker image that enables you to easily forward to your websites running at home or otherwise, including free SSL, without having to know too much about Nginx or Letsencrypt.

https://nginxproxymanager.com/guide/#project-goal

• 중국에서는 80/443 포트를 사용하려면 허가를 받아야 한다.

Nginx Proxy Manager 서비스 포트 수정

프로젝트(소스) 복사

(bash)
git clone https://github.com/NginxProxyManager/nginx-proxy-manager.git

서비스 포트 정하기

1. Public HTTP Port - 80번으로 웹 프로토콜이다. 흔히 브라우저에 도메인으로 접속할때 사용된다.

2. Public HTTPS Port - 443번으로 보안인증서를 사용하는 웹 프로토콜이다. (상동)

3. Nginx Proxy Manager Admin Web Port - 원본은 81번 포트이다. 관리자 페이지 접속 포트이다.

Dockerfile 내용 변경

주의! EXPOSE 부분을 원하는 포트로 변경해주어야 한다. → 31-32 번 라인

(bash)
cd nginx-proxy-manager && cat > Dockerfile

(docker)
# This is a Dockerfile intended to be built using `docker buildx`
# for multi-arch support. Building with `docker build` may have unexpected results.

# This file assumes that the frontend has been built using ./scripts/frontend-build

FROM nginxproxymanager/nginx-full:certbot-node

ARG TARGETPLATFORM
ARG BUILD_VERSION
ARG BUILD_COMMIT
ARG BUILD_DATE

ENV SUPPRESS_NO_CONFIG_WARNING=1 \
	S6_FIX_ATTRS_HIDDEN=1 \
	S6_BEHAVIOUR_IF_STAGE2_FAILS=1 \
	NODE_ENV=production \
	NPM_BUILD_VERSION="${BUILD_VERSION}" \
	NPM_BUILD_COMMIT="${BUILD_COMMIT}" \
	NPM_BUILD_DATE="${BUILD_DATE}"

RUN echo "fs.file-max = 65535" > /etc/sysctl.conf \
	&& apt-get update \
	&& apt-get install -y --no-install-recommends jq logrotate \
	&& apt-get clean \
	&& rm -rf /var/lib/apt/lists/*

# s6 overlay
COPY scripts/install-s6 /tmp/install-s6
RUN /tmp/install-s6 "${TARGETPLATFORM}" && rm -f /tmp/install-s6

# [주의!] 원하는 포트로 변경해야 한다.
EXPOSE 8080 4443 8181

COPY backend       /app
COPY frontend/dist /app/frontend
COPY global        /app/global

WORKDIR /app
RUN yarn install

# add late to limit cache-busting by modifications
COPY docker/rootfs /

# Remove frontend service not required for prod, dev nginx config as well
RUN rm -rf /etc/services.d/frontend /etc/nginx/conf.d/dev.conf

# Change permission of logrotate config file
RUN chmod 644 /etc/logrotate.d/nginx-proxy-manager

# fix for pip installs
# https://github.com/NginxProxyManager/nginx-proxy-manager/issues/1769
RUN pip uninstall --yes setuptools \
	&& pip install "setuptools==58.0.0"

VOLUME [ "/data", "/etc/letsencrypt" ]
ENTRYPOINT [ "/init" ]

LABEL org.label-schema.schema-version="1.0" \
	org.label-schema.license="MIT" \
	org.label-schema.name="nginx-proxy-manager" \
	org.label-schema.description="Docker container for managing Nginx proxy hosts with a simple, powerful interface " \
	org.label-schema.url="https://github.com/jc21/nginx-proxy-manager" \
	org.label-schema.vcs-url="https://github.com/jc21/nginx-proxy-manager.git" \
	org.label-schema.cmd="docker run --rm -ti jc21/nginx-proxy-manager:latest"

file-patch 파일 작성

file-patch : 파일 내용을 간단하게 수정하도록 도와주는 쉘 스크립트이다.

(bash)
cat > file-patch.sh

(shell)
#!/bin/sh

usage() {
    echo "usage: $(basename "$0") [SED_OPT...] SED_EXPRESSION FILE
sed with a patch-like behavior.
This helper returns:
  - A success when running the sed expression SED_EXPRESSION results in changes
    applied to file FILE.
  - An error when running the sed expression SED_EXPRESSION results in no change
    to file FILE.
NOTE: sed option '-i' is already supplied by this script.
"
}

eval FILE=\${$#}

if [ "$#" -lt 2 ]; then
    echo "ERROR: Not enough arguments."
    exit 1
fi

sed -i.bak "$@"
RC="$?"
if [ "$RC" -eq 0 ]; then
    diff "$FILE" "$FILE".bak > /dev/null 2>&1
    case $? in
        0)
            # Files are the same.
            echo "ERROR: No modification applied to $FILE."
            RC=1
            ;;
        1)
            # Files differ.
            RC=0
            ;;
        *)
            ;;
    esac
fi

rm -f "$FILE".bak
exit $RC

서비스 포트 변경을 위한 Nginx 파일 수정

(bash)
# Change the management interface port to the unprivileged port 8181.
sh ./file-patch.sh 's|81 default|8181 default|' ./rootfs/etc/nginx/conf.d/production.conf

# Change the HTTP port 80 to the unprivileged port 8080.
sh ./file-patch.sh 's|80;|8080;|' ./rootfs/etc/nginx/conf.d/default.conf && \
sh ./file-patch.sh 's|"80";|"8080";|' ./rootfs/etc/nginx/conf.d/default.conf && \
sh ./file-patch.sh 's|listen 80;|listen 8080;|' ../backend/templates/letsencrypt-request.conf && \
sh ./file-patch.sh 's|:80;|:8080;|' ../backend/templates/letsencrypt-request.conf && \
sh ./file-patch.sh 's|listen 80;|listen 8080;|' ../backend/templates/_listen.conf && \
sh ./file-patch.sh 's|:80;|:8080;|' ../backend/templates/_listen.conf && \
sh ./file-patch.sh 's|80 default;|8080 default;|' ../backend/templates/default.conf

# Change the HTTPs port 443 to the unprivileged port 4443.
sh ./file-patch.sh 's|443 |4443 |' ./rootfs/etc/nginx/conf.d/default.conf && \
sh ./file-patch.sh 's|"443";|"4443";|' ./rootfs/etc/nginx/conf.d/default.conf && \
sh ./file-patch.sh 's|listen 443 |listen 4443 |' ../backend/templates/_listen.conf && \
sh ./file-patch.sh 's|:443 |:4443 |' ../backend/templates/_listen.conf && \
sh ./file-patch.sh 's|:443;|:4443;|' ../backend/templates/_listen.conf

Nginx Proxy Manager Admin Frontend Web 빌드

Nginx Proxy Manager 의 관리자 페이지를 사용을 위해 빌드한다.

(bash)
sh ./file-patch.sh 's|/app/frontend|./|' ../frontend/webpack.config.js

(bash)
cd ../frontend && yarn && yarn build

Nginx Proxy Manager 의 Container 이미지 빌드

Nginx Proxy Manager 는 기본적으로 Docker 를 이용한다.

Get Docker

Update to the Docker Desktop terms Commercial use of Docker Desktop in larger enterprises (more than 250 employees OR more than $10 million USD in annual revenue) now requires a paid subscription. Docker is an open platform for developing, shipping, and running applications.

https://docs.docker.com/get-docker/

수정한 내용으로 우리가 사용할 새로운 이미지를 만든다.

(bash)
cd ../ && docker build -t custom-nginx-proxy-manager:v0.0.1 -f ./docker/Dockerfile .

Nginx Proxy Manager Container 관리를 위한 docker-compose 작성

Docker 의 컨테이너를 편하게 관리하기 위해서 docker-compose 를 사용하는 것이다.

Install Docker Compose

On this page you can find a summary of the available options for installing Docker Compose. Docker Compose requires Docker Engine. Docker Compose plugin requires Docker CLI. You can run Compose on macOS, Windows, and 64-bit Linux. Check what installation scenario fits your needs. Are you looking to:

https://docs.docker.com/compose/install/

docker-compose 파일을 작성한다.

(bash)
cd ../ && mkdir -p docker-containers/nginx-proxy && cd docker-containers/nginx-proxy && mkdir data && mkdir letsencrypt && cat > docker-compose.yaml

(yaml)
version: '3'
services:
  nginx-proxy:
    image: 'custom-nginx-proxy-manager:v0.0.1'
    container_name: 'nginx-proxy'
    restart: unless-stopped
    network_mode: 'host'
    volumes:
      - ./data:/data
      - ./letsencrypt:/etc/letsencrypt
    environment:
      - TZ=Asia/Seoul

Nginx Proxy Manager 실행

(bash)
docker-compose up -d

(bash)
# 컨테이너 종료 & 삭제
docker-compose down

# 컨테이너 실행 & 재 실행
docker-compose up -d

관리자 페이지 접속 및 초기 사용자 정보

[서버IP]:8181 로 접속하면, 관리자 페이지를 볼 수 있다.

• 초기 사용자 정보

admin@example.com

changeme

만약, 접속이 되지 않는다면?

1. Listen 포트 확인

(bash)
sudo lsof -i TCP -p | grep LISTEN

2. ufw 확인

(bash)
sudo ufw status verbose

→ ufw 포트 추가

(bash)
sudo ufw allow 8080/tcp && \
sudo ufw allow 4443/tcp && \
sudo ufw allow 8181/tcp

호스트 추가할 때, 팁!

결론