OpenMediaVault(OMV) 서버에 다양한 서비스를 설치하기 전, 마지막 필수 과정으로 Nginx Proxy Manager(NPM)를 설치하려고 합니다. Nginx Proxy Manager는 가상 호스트 및 리버스 프록시 기능을 시각적으로 관리할 수 있게 해주는 도구입니다. 복잡한 콘솔 명령어나 설정 파일 수정 대신 웹 UI에서 간편하게 도커 이미지를 관리할 수 있다는 장점이 있습니다.
설치에 앞서 Nginx Proxy Manager가 하는 역할을 간단히 알아보겠습니다. 보통 도커에 웹 서비스를 설치하면 컨테이너 포트와 호스트 서버의 포트를 연결하여 접속합니다. 하지만 이 방식을 사용하면 서비스마다 공유기에서 포트 포워딩을 설정해야 하고, 접속할 때마다 도메인 뒤에 포트 번호를 붙여야 하는 번거로움이 발생합니다.
이런 불편함을 해결하기 위해 사용하는 기능이 바로 가상 호스트(Virtual Host)와 리버스 프록시(Reverse Proxy)입니다. 서브 도메인(예: webservice.pomvtest.duckdns.org)을 각 서비스에 할당함으로써, 사용자는 포트 번호 없이 도메인 주소만으로 서로 다른 서비스에 접속할 수 있습니다.
오늘 설치할 Nginx Proxy Manager는 이러한 복잡한 설정을 웹에서 마우스 클릭 몇 번으로 가능하게 해줍니다. 리눅스 콘솔 환경이 낯설거나 효율적인 관리를 원하는 분들에게 강력히 추천하는 도구입니다. 그럼 바로 설치 방법을 확인해보겠습니다.
1. Nginx Proxy Manager 설치하는 방법
먼저 Portainer에 접속하여 이미지 탭에서 “jlesage/nginx-proxy-manager”를 검색하여 다운로드합니다. 이 이미지는 데이터베이스를 내장하고 있어 별도의 DB 설정 없이도 간편하게 사용할 수 있다는 장점이 있습니다.
이미지 정보를 확인하면 8080, 8181, 4443 포트를 호스트와 연결해야 하며, 설정 파일이 저장될 config 볼륨을 지정해야 함을 알 수 있습니다. Config 볼륨에는 설정 데이터와 SSL 인증서가 저장되므로 안전한 공유 폴더에 연결해 주어야 합니다.
OMV 컨트롤 패널로 이동하여 웹 서버 데이터 저장을 위한 새로운 공유 폴더를 생성합니다. 폴더 내부에 “npm”이라는 하위 폴더를 만들어 관리하면 더욱 깔끔합니다. 공유 폴더 생성 방법이 생소하다면 아래 관련 글을 참고해 주세요.
생성된 공유 폴더의 절대 경로를 확인합니다. 나중에 도커 볼륨 연결 시 이 경로가 필요합니다. 예를 들어 경로가 /srv/dev-disk-by-label-Test/webserver라면, 여기에 /npm을 추가한 최종 경로를 사용하게 됩니다.
중요한 단계입니다. OMV의 기본 컨트롤 패널 포트(80)를 다른 번호로 변경해야 합니다. 이를 변경하지 않으면 NPM 컨테이너가 80 포트를 점유할 때 충돌이 발생합니다. 자세한 변경 방법은 아래 링크를 확인해 주세요.
이제 Portainer에서 컨테이너를 생성합니다. 이미지 필드에 아까 찾은 주소를 넣고 포트 매핑을 설정합니다. [80 -> 8080], [443 -> 4443], [81 -> 8181]로 설정하여 HTTP/HTTPS 포트와 NPM 관리 포트를 각각 연결해 줍니다.
Volumes 탭에서 “bind” 버튼을 활성화한 뒤, 컨테이너의 /config 경로를 앞서 확인한 OMV 공유 폴더의 npm 경로와 연결합니다. 이렇게 해야 컨테이너가 삭제되어도 설정 데이터가 보존됩니다.
네트워크 설정에서 미리 생성해둔 가상 네트워크를 할당하고, 재시작 정책(Restart policy)을 “Always”로 설정한 뒤 컨테이너를 배포합니다.
배포가 완료된 후 브라우저에 OMV 서버 아이피를 입력했을 때 위와 같은 기본 페이지가 뜬다면 리버스 프록시가 정상적으로 작동하기 시작한 것입니다.
이제 관리 페이지인 [서버IP:81]로 접속합니다. 초기 로그인 정보는 다음과 같으며, 보안을 위해 첫 로그인 후 즉시 변경해야 합니다.
- 아이디: admin@example.com
- 비밀번호: changeme
로그인 후 나타나는 팝업창에서 자신의 이메일 주소와 닉네임, 그리고 강력한 비밀번호로 정보를 업데이트해 줍니다.
모든 설정이 완료되면 위와 같은 메인 대시보드가 나타납니다. Proxy Host 메뉴에서는 도메인을 서비스에 연결하고, SSL Certificates 메뉴에서는 무료 보안 인증서(Let’s Encrypt)를 발급 및 관리할 수 있습니다.
이번 포스팅에서는 OMV 나스 서버 운영의 핵심인 Nginx Proxy Manager 설치법을 알아보았습니다. 다음 시간에는 이를 활용해 Nextcloud 클라우드 서비스를 설치하고, 외부에서도 안전하게 내 파일에 접근하는 방법을 다루어 보겠습니다.
함께 보면 좋은 글
이 글의 저작권은 전적으로 작성자인 P_Emblem에게 있으며, 무단 전재 및 재배포를 금합니다.