🚀 Nginx Proxy Manager로 역방향 프록시 마스터하기! 🚀

🌟 Nginx Proxy Manager란?

Nginx Proxy Manager(NPM)는 웹 서버 Nginx 기반의 오픈소스 역방향 프록시 관리 도구입니다. 복잡한 Nginx 설정 파일 대신 직관적인 웹 UI로 도메인, SSL 인증서, 리다이렉션 등을 관리할 수 있어 DevOps 초보자도 쉽게 사용 가능합니다!

🛠 필수 준비 사항

1. Docker & Docker Compose 설치

   # Ubuntu 예시
   sudo apt update && sudo apt install docker.io docker-compose

2. 도메인 소유 (Let’s Encrypt SSL 적용 시 필수)
3. 80/443 포트 개방 (HTTP/HTTPS 트래픽 허용)

🐳 Docker Compose 파일 작성

docker-compose.yml 파일을 생성하고 다음 내용을 추가합니다:

version: '3.8'
services:
  app:
    image: 'jc21/nginx-proxy-manager:latest'
    container_name: npm
    restart: unless-stopped
    ports:
      - '80:80'      # HTTP
      - '443:443'    # HTTPS
      - '81:81'      # 관리자 UI 포트
    volumes:
      - ./data:/data    # 설정 데이터
      - ./letsencrypt:/etc/letsencrypt  # SSL 인증서
    environment:
      DB_SQLITE_FILE: "/data/database.sqlite"  # DB 저장 경로
      DISABLE_IPV6: 'true'  # IPv6 비활성화 (선택)

🔍 설정 설명

• volumes:
  • ./data: NPM 설정/DB 저장 경로 (호스트의 현재 디렉토리에 생성)
  • ./letsencrypt: Let’s Encrypt 인증서 자동 저장 위치
• ports:
  • 81: 관리자 웹 UI (http://서버IP:81)
  • 80/443: 실제 트래픽 처리 포트

🚀 서비스 실행 및 초기 설정

1. 컨테이너 실행

   docker-compose up -d

2. 웹 UI 접속
   브라우저에서 http://:81 열기
   → 초기 계정: admin@example.com / 비밀번호: changeme
   

3. 비밀번호 변경
   첫 로그인 시 반드시 변경! (Settings → Users)

🔧 역방향 프록시 설정 예시

가정: 워드프레스 사이트(wordpress:80)를 blog.mydomain.com으로 노출

1. Proxy Hosts 추가
   • Hosts → Proxy Hosts → Add Proxy Host 클릭
2. 도메인 & 타겟 설정

   💡 Details 탭  
    - Domain Names: blog.mydomain.com  
    - Scheme: http  
    - Forward Hostname/IP: wordpress (컨테이너명)  
    - Port: 80  

3. SSL 인증서 적용

   💡 SSL 탭  
    - SSL Certificate: Request a new SSL Certificate  
    - Email: 본인 이메일  
    - Force SSL ☑️  

   → Let’s Encrypt가 자동으로 인증서 발급!

⚙️ 고급 기능 활용법

1. 접근 제어 (Access Lists)

• IP 화이트리스트/블랙리스트 설정 가능
• Access → Access Lists에서 생성 후 Proxy Host에 연결

2. 리다이렉션

• http://mydomain.com → https://www.mydomain.com 자동 전환

  💡 Redirection Hosts 추가  
   - Source: mydomain.com  
   - Target: https://www.mydomain.com  

3. 스트리밍 지원 (WebSocket 등)

   # Advanced 탭에 추가
   location / {
      proxy_set_header Upgrade $http_upgrade;
      proxy_set_header Connection "upgrade";
   }

🚨 트러블슈팅

• 403 Forbidden:
  → 타겟 서비스의 방화벽에서 NPM 컨테이너 IP 허용 확인
• SSL 발급 실패:
  → 도메인 DNS가 서버 IP로 올바르게 연결되었는지 확인
  → ./letsencrypt 볼륨 권한 체크 (chmod 755 letsencrypt)
• DB 오류:

  # 데이터 재생성
  docker-compose down
  rm -rf data
  docker-compose up -d

✅ NPM의 장점 정리

🎯 마치며

Nginx Proxy Manager는 복잡한 Nginx 설정을 GUI로 단순화한 혁신적인 도구입니다. Docker Compose로 5분 만에 구축 가능하고, 무료 SSL 자동 갱신까지 지원하니 웹 서비스 운영에 필수템이죠! 지금 바로 도커 컴포즈 파일을 작성해 역방향 프록시의 세계를 열어보세요 ✨

> 📚 공식 문서: nginxproxymanager.com
> 💬 문제 발생 시: GitHub Issues 또는 커뮤니티 활용 추천! D