Repolode
ZoeyVid

ZoeyVid/NPMplus

nginx 리버스 프록시 설정을 위한 웹 GUI를 제공하는 nginx-proxy-manager 포크로, HTTP/3, CrowdSec, 강화된 TLS 및 mTLS를 추가하고 Docker 이미지로 배포됩니다.

대체할 수 있는 제품:Cloudflare Tunnel

스타
2,434
포크
123
열린 이슈
18
마지막 커밋
13시간 전

어떤 프로젝트인가요?

NPMplus는 nginx를 리버스 프록시로 설정하는 웹 인터페이스인 nginx-proxy-manager의 포크입니다. Docker 이미지로 배포되며 기본 설정의 보안을 강화하는 것을 목표로 합니다. HTTP/3(QUIC)를 지원하고, aws-lc가 적용된 패치 버전의 nginx를 사용하며, 인증서 압축과 선택적 Encrypted Client Hello를 활성화하고, 기본적으로 유효 기간이 짧은 Let's Encrypt 인증서를 발급합니다.

기본 기능 외에도 호스트별 클라이언트 인증서 mTLS, 여러 업스트림을 사용하는 로드 밸런싱, gRPC 및 proxy protocol 호스트, 여러 인증 제공자를 위한 내장 auth_request 연동, 악성 트래픽 차단을 위한 AppSec 지원 CrowdSec를 제공합니다. 웹 UI는 엄격한 CSP를 적용해 HTTPS로 제공되며 OIDC 로그인을 사용할 수 있습니다.

이 프로젝트는 AGPL-3.0 라이선스로 제공되며 x86_64-v2와 arm64에서 실행됩니다. 문서에 따르면 업스트림을 그대로 대체하는 방식으로 사용할 수 없으므로 마이그레이션은 한 방향으로만 가능하며, 기존 사용자 지정 nginx 설정을 수정해야 할 수 있습니다.

핵심 기능

  • 01선택적 Encrypted Client Hello와 함께 HTTPS에 더해 HTTP/3(QUIC) 제공
  • 02악성 요청 차단을 위해 CrowdSec 및 AppSec 연동
  • 03호스트별로 설정하는 클라이언트 인증서 mTLS 지원
  • 04여러 업스트림에 프록시 호스트의 부하를 분산하고 gRPC 및 스트림 프록시
  • 05일반적인 인증 제공자를 위한 내장 auth_request 연동 및 UI용 OIDC 로그인 제공
  • 06zstd 및 brotli 압축과 Goaccess 로그 분석 지원

활용 사례

  • GUI를 통해 하나의 공개 nginx 진입점 뒤에서 여러 웹 서비스를 셀프 호스팅
  • 홈랩이나 중소기업 앱 앞단에 CrowdSec 기반 침입 차단 기능 추가
  • auth_request를 통해 내부 서비스 앞단에 SSO 또는 인증 제공자 배치
  • 자동 TLS 인증서가 필요한 Docker 호스트에서 리버스 프록시 운영

빠른 시작

  1. 1

    Docker와 Docker Compose를 설치합니다

  2. 2

    NPMplus 저장소에서 compose.yaml을 다운로드하고 시간대(TZ)를 설정합니다

  3. 3

    Docker Compose로 NPMplus를 시작합니다

    docker compose up -d
  4. 4

    포트 81에서 HTTPS로 관리자 UI를 엽니다

사용 전 알아둘 점

  • AGPL-3.0에 따라 배포됩니다. 수정 및 네트워크를 통한 사용에도 적용되는 강력한 카피레프트 라이선스입니다.
  • x86_64-v2(amd64v2)와 aarch64/arm64만 지원합니다. 일반 x86-64와 32비트 아키텍처는 지원하지 않습니다.
  • SQLite만 권장됩니다. MariaDB, MySQL, PostgreSQL은 지원되지 않으며 이들 간의 마이그레이션도 불가능합니다.
  • 업스트림 nginx-proxy-manager에서의 마이그레이션은 되돌릴 수 없으므로 먼저 백업해야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

NPMplus은(는) 무엇인가요?
nginx 리버스 프록시 설정을 위한 웹 GUI를 제공하는 nginx-proxy-manager 포크로, HTTP/3, CrowdSec, 강화된 TLS 및 mTLS를 추가하고 Docker 이미지로 배포됩니다. NPMplus는 nginx를 리버스 프록시로 설정하는 웹 인터페이스인 nginx-proxy-manager의 포크입니다. Docker 이미지로 배포되며 기본 설정의 보안을 강화하는 것을 목표로 합니다. HTTP/3(QUIC)를 지원하고, aws-lc가 적용된 패치 버전의 nginx를 사용하며, 인증서 압축과 선택적 Encrypted Client Hello를 활성화하고, 기본적으로 유효 기간이 짧은 Let's Encrypt 인증서를 발급합니다.
NPMplus은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
NPMplus은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
NPMplus은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. NPMplus의 마지막 커밋은 2026년 11월 5일입니다.
NPMplus은(는) 어디에 사용할 수 있나요?
GUI를 통해 하나의 공개 nginx 진입점 뒤에서 여러 웹 서비스를 셀프 호스팅 홈랩이나 중소기업 앱 앞단에 CrowdSec 기반 침입 차단 기능 추가 auth_request를 통해 내부 서비스 앞단에 SSO 또는 인증 제공자 배치 자동 TLS 인증서가 필요한 Docker 호스트에서 리버스 프록시 운영
NPMplus는 어떻게 설치하나요?
Docker와 Docker Compose를 설치합니다 NPMplus 저장소에서 compose.yaml을 다운로드하고 시간대(TZ)를 설정합니다 Docker Compose로 NPMplus를 시작합니다: docker compose up -d 포트 81에서 HTTPS로 관리자 UI를 엽니다
NPMplus은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ZoeyVid/NPMplus

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트