☰
↵ 이동 · Esc 닫기 ·
sezzang
글로 남겨보자
🔍
📦
전체 글 보기
📱
앱 검사기
Categories
📄
이력서
▶
📁
교육
📁
산특6기
▶
📁
공부
📁
네트워크
📁
리눅스
📁
윈도우
📁
잡도리
📁
활동
📁
학교수업
⚙
홈
›
공부
›
잡도리
›
NPM 리버스 프록시 구축
기록
NPM 리버스 프록시 구축
작성일: 2026-08-07
📑 목차
## 한눈에 보기 본 문서는 우분투 서버(192.168.0.99)에 Docker 기반의 Nginx Proxy Manager를 설치하여, 내부 웹서버(192.168.0.174)의 HTTP 요청을 HTTPS로 처리하고 라우팅하는 구축 절차입니다. - **프록시 서버**: 192.168.0.99 - **실제 웹서버**: 192.168.0.174 (Apache 가상호스트 구성 완료) ## 전체 구조 ``` 사용자 (브라우저) │ https://도메인 ▼ [공유기 포트포워딩: 80/443 → 99번] ▼ 99번 서버 (Nginx Proxy Manager, Docker 컨테이너) - HTTPS 처리 (Let's Encrypt 인증서) - 도메인별 라우팅 │ http (내부망, 별도 포트포워딩 불필요) ▼ 174번 서버 (Apache, 계정별 가상호스트) ``` --- ## 🚀 단계별 실행 절차 ### 1단계. Docker 설치 ```bash #방법 A: Docker 공식 스크립트 (간단) curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh ``` ```bash #방법 B: 저장소 직접 추가 sudo apt update sudo apt install -y ca-certificates curl gnupg sudo install -m 0755 -d /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg sudo chmod a+r /etc/apt/keyrings/docker.gpg echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \ sudo tee /etc/apt/sources.list.d/docker.list > /dev/null sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin ``` ```bash docker --version docker compose version ``` ### 2단계. 작업 폴더 생성 ```bash mkdir -p /home/docker/nginx-proxy-manager cd /home/docker/nginx-proxy-manager ``` ### 3단계. docker-compose.yml 작성 ```yaml services: app: image: 'jc21/nginx-proxy-manager:latest' restart: unless-stopped ports: - '80:80' - '443:443' - '81:81' volumes: - ./data:/data - ./letsencrypt:/etc/letsencrypt ``` ⚠️ 이 부분에서 실수 있었음 → 실수노트 1번 참고 ```bash docker compose up -d docker ps ``` ### 4단계. 관리자 페이지 설정 접속: `http://192.168.0.99:81` 초기 로그인: `admin@example.com` / `changeme` ⚠️ 이 부분에서 실수 있었음 → 실수노트 2, 3번 참고 ### 5단계. 공유기 포트포워딩 외부 포트 80, 443 → 내부 IP 192.168.0.99 (내부 포트 80, 443) ⚠️ 이 부분에서 실수 있었음 → 실수노트 4번 참고 ### 6단계. Proxy Host 생성 - **Details 탭**: Domain, Scheme: http, Forward Host: 192.168.0.174, Port: 80 - **SSL 탭**: Request a new Certificate, Force SSL 체크 ### 7단계. 인증서 오류 트러블슈팅 **1) 로그 먼저 확인** ```bash cd /home/docker/nginx-proxy-manager docker compose logs --tail=100 app ``` "Some challenges have failed"만 뜨고 어떤 도메인인지는 안 나오는 경우가 많음. 상세 원인은 아래로 확인: ```bash sudo docker compose exec app grep -B 2 "status.*invalid\|Detail" /data/logs/letsencrypt.log | tail -100 ``` 여기 나오는 `Detail:` 문구로 원인 구분 → 실수노트 5, 6, 7번 참고 **2) 도메인별 IP 일괄 확인 (로컬 관점)** ```bash for domain in 도메인1.kr 도메인2.kr 도메인3.kr; do echo -n "$domain => " nslookup $domain | grep "Address" | tail -1 done ``` **3) AAAA(IPv6) 레코드 확인 — 놓치기 쉬움** ```bash nslookup -type=AAAA 도메인.kr ``` **4) 외부 공용 DNS(8.8.8.8)로 대조 조회 — 로컬 확인만으론 부족** ```bash nslookup -type=NS 도메인.kr 8.8.8.8 ``` --- ## ⚠️ 실수노트 1. **데이터 백업 누락 가능성** - 문제: `./data`, `./letsencrypt` 폴더 미백업 시 설정 및 인증서 유실 위험 - 원인: 컨테이너 외부 볼륨 매핑 영역을 인지하지 못함 - 해결: 기존 백업 크론에 해당 경로 추가 2. **관리자 이메일 설정 미흡** - 문제: Let's Encrypt 인증서 발급 실패 (`invalid email address`) - 원인: 초기 계정 이메일(`admin@example.com`)은 가짜 도메인으로 간주됨 - 해결: 실제 사용 가능한 이메일로 변경 3. **관리자 페이지 보안 노출** - 문제: 81번 포트가 외부 노출됨 - 원인: 보안 설정 미숙 - 해결: 공유기 포트포워딩 규칙에서 81번은 제외 (내부망 전용) 4. **기존 포트포워딩 충돌** - 문제: `Some challenges have failed` 에러 발생 - 원인: 이전 웹서버(174번)로 포트포워딩된 80/443 규칙이 남아있어 Let's Encrypt 검증 방해 - 해결: 기존 174번 규칙을 삭제하고 99번으로 일괄 변경 5. **zone 파일에 AAAA `::1` 레코드 잔존** - 문제: 특정 도메인만 SSL 발급이 계속 실패 (Internal Error). 브라우저 접속은 IPv4로 자동 대체되어 정상처럼 보였음 - 확인: ```bash nslookup -type=AAAA 도메인.kr ``` → `Address: ::1`(로컬호스트)로 나오면 원인 확정 - 원인: zone 파일에 `AAAA ::1`이 등록되어 있어 Let's Encrypt가 IPv6 우선 검증 시도 → 실패 - 해결: ```bash sudo nano /etc/bind/도메인.kr.zone ``` 해당 줄을 `;`로 주석 처리 (⚠️ `#`으로 하면 zone 파일 전체가 깨져서 SERVFAIL 발생, 반드시 `;` 사용) → Serial 번호 증가 → 저장 후 ```bash sudo systemctl restart named sudo systemctl status named ``` 6. **도메인이 사설 IP를 가리키는 자체 네임서버로 위임됨** - 문제: 특정 도메인에서만 `Some challenges have failed`, 상세 로그에 `DNS problem: query timed out` 또는 `SERVFAIL` - 확인 (로컬에서는 항상 정상으로 보이므로 반드시 외부 DNS로 대조): ```bash nslookup -type=NS 정상도메인.kr 8.8.8.8 # 후이즈 네임서버 응답 (정상) nslookup -type=NS 문제도메인.kr 8.8.8.8 # Server failed (문제) ``` - 원인: 후이즈에 해당 도메인의 네임서버가 자체(`ns.도메인.kr`)로 위임되어 있고, 그 네임서버의 A 레코드가 사설 IP(192.168.0.174)를 가리켜 외부에서 접근 불가능 - 해결: 후이즈에서 해당 도메인 네임서버를 커스텀 → 후이즈 기본 네임서버로 전환. 전환 전까지는 Proxy Host의 Domain Names에서 해당 도메인만 제외하고 나머지 먼저 정상 발급 7. **서브도메인은 부모 도메인과 별개로 취급됨** - 문제: 서브도메인(`sub.도메인.kr`)을 Proxy Host에 추가했는데 NXDOMAIN - 확인: ```bash nslookup 서브.도메인.kr ``` - 원인: 서브도메인은 부모 zone 파일 안에 별도의 A 레코드가 있어야 함 - 해결: ```bash sudo nano /etc/bind/도메인.kr.zone ``` `서브 IN A 192.168.0.174` 추가 → Serial 증가 → `sudo systemctl restart named` 8. **재발급할 때마다 예전 인증서가 목록에 계속 쌓임** - 문제: 도메인 조합을 바꿔 재발급하면 이전 조합의 인증서가 자동 삭제되지 않고 남음 - 원인: NPM/Let's Encrypt 구조상 도메인 조합이 다르면 별개의 인증서로 취급 - 해결: SSL Certificates 메뉴에서 각 Proxy Host가 실제 쓰는 인증서 확인 후 안 쓰는 것은 수동 삭제 --- ## 💡 핵심 개념 정리 - **HTTP Challenge**: Let's Encrypt 인증서 발급 시 해당 도메인의 80번 포트로 특정 파일에 접근하여 소유권을 검증하는 절차. - **헤어핀 NAT**: 내부망에서 내부 서버의 공인 IP로 접속 시, 공유기가 다시 내부로 돌려보내는 현상 (내부 테스트 시 실제 외부 동작과 다를 수 있음, 확인 필요). - **SAN 인증서**: 하나의 SSL 인증서에 여러 도메인을 포함하는 기술. 도메인 하나라도 검증 실패하면 전체 발급 실패. - **네임서버 위임**: 도메인의 DNS 응답을 누가 담당할지 등록기관에 지정하는 것. 커스텀 네임서버는 반드시 외부(공인 IP)에서 접근 가능해야 함. --- ## 🗺️ 구성 요약표 | 항목 | 내용 | |---|---| | Nginx Proxy Manager | 192.168.0.99 | | 실제 웹서버 | 192.168.0.174 | | 관리자 페이지 | 81 (내부망 전용) | | 주요 설정 폴더 | ./data, ./letsencrypt | ## 🔒 SSL 탭 항목 정리 | 항목 | 역할 | 권장 | |---|---|---| | SSL Certificate | 사용할 인증서 선택. `Request a new Certificate` 선택 시 Let's Encrypt로 신규 발급 | 발급 후엔 목록에서 기존 인증서 선택 | | Force SSL | http 요청을 https로 강제 리다이렉트(301) | ✅ ON | | HTTP/2 Support | https 연결에서 HTTP/2 사용, 한 연결로 여러 리소스 병렬 전송 | ✅ ON | | HSTS Enabled | 브라우저에 "이 도메인은 https로만 접속"을 기억시키는 헤더 전송. 켜면 SSL을 꺼도 브라우저가 http 접속을 거부함 | ⏸️ 인증서 안정화 확인 후 ON | | HSTS Sub-domains | HSTS를 하위 도메인(`*.도메인`)까지 적용. https 아닌 서브도메인이 하나라도 있으면 접속 불가 | ❌ OFF | | Use DNS Challenge | 80포트 대신 DNS TXT 레코드로 소유 인증. DNS 제공자 API 토큰 필요 (예: Cloudflare) | 80포트 막힘 / 와일드카드 인증서 필요 시만 ON | | Advanced | Nginx 설정 직접 추가 (보안 헤더, `client_max_body_size` 등) | 필요 시 |