Skip to content
KitploitKITPLOIT
도구익스플로잇블로그
Log in
제출
도구익스플로잇블로그
제출

해킹, 침투 테스트 및 사이버 보안 도구를 당신의 보안 무기고에!

Kitploit은 해킹, 사이버 보안 및 침투 테스트 도구 디렉토리입니다. 최신 프로젝트 업데이트를 발견하여 취약점을 찾고, 시스템을 분석하고, 테스트를 자동화하고, 보안을 강화하세요.

피드문의개인정보© 2026 Kitploit

도구 디렉토리

카테고리

모든 카테고리 보기
Loading categories
reproxy — 경량 에지 HTTP(S) 서버 및 리버스 프록시로, 자동 SSL, Docker/Consul 디스커버리, 경로별 인증, 속도 제한, 상태 확인 기반 장애 조치를 제공합니다. | Kitploit
도구/GitHubGitHub/umputun/reproxy
Authentication & AuthorizationGeneral Purpose UtilitiesWeb SecurityNetwork SecurityAPI Security
GitHubumputun/reproxy

reproxy

경량 에지 HTTP(S) 서버 및 리버스 프록시로, 자동 SSL, Docker/Consul 디스커버리, 경로별 인증, 속도 제한, 상태 확인 기반 장애 조치를 제공합니다.

저장소 보기
1.3k967918일 전Kitploit 검토 완료
공유
웹사이트
Reproxy | Simple Reverse Proxy

Reproxy는 다양한 프로바이더(docker, static, file, consul catalog)를 지원하는 간단한 엣지 HTTP(s) 서버 / 리버스 프록시입니다. 하나 이상의 프로바이더가 요청된 서버, 요청된 URL, 대상 URL, 헬스 체크 URL에 대한 정보를 제공합니다. 단일 바이너리 또는 docker 컨테이너로 배포됩니다.

  • Let's Encrypt를 이용한 자동 SSL 종료
  • 사용자 제공 SSL 인증서 지원
  • 간단하지만 유연한 프록시 규칙
  • 정적, 명령줄 프록시 규칙 프로바이더
  • 동적, 파일 기반 프록시 규칙 프로바이더
  • 자동 검색 기능을 갖춘 Docker 프로바이더
  • 서비스 태그로 검색하는 Consul Catalog 프로바이더
  • 다중 (가상) 호스트 지원
  • 선택적 트래픽 압축
  • 선택적 IP 기반 접근 제어
  • 라우트별 기본 인증
  • 사용자 정의 크기 제한 및 타임아웃
  • 단일 바이너리 배포
  • Docker 컨테이너 배포
  • 선택적 "SPA 친화적" 모드를 갖춘 내장 정적 자산 서버
  • 리다이렉트 규칙 지원
  • 전체 활동 및 사용자 활동에 대한 선택적 제한기
  • 실시간 헬스 체크 및 장애 조치/로드 밸런싱
  • 라우트 정보와 prometheus 메트릭을 제공하는 관리 서버
  • 사용자 정의 기능을 구현하기 위한 RPC 기반 플러그인 지원
  • Apache Log Format과 간소화된 stdout 리포트를 모두 지원하는 선택적 로깅

build Coverage Status Go Report Card Docker Hub

서버(호스트)는 FQDN, 즉 s.example.com, *(전체 캐치), 또는 정규식으로 설정할 수 있습니다. 정확한 일치가 우선하므로, 서버가 example.com과 example\.(com|org)인 두 규칙이 있을 때 example.com/some/url에 대한 요청은 전자와 일치합니다. 요청된 URL은 정규식일 수 있으며, 예를 들어 ^/api/(.*)이고 대상 URL은 정규식으로 일치된 그룹을 포함할 수 있습니다. 즉, http://d.example.com:8080/$1입니다. 위 예시의 경우 http://s.example.com/api/something?foo=bar는 http://d.example.com:8080/something?foo=bar로 프록시됩니다.

정확한 서버 이름과 *.example.com 서버 이름은 호스트를 대소문자 구분 없이 일치시키며 후행 점 하나를 무시하므로, Admin.Example.com과 admin.example.com.은 admin.example.com 규칙에 일치합니다. 정규식 서버는 작성된 그대로 일치하므로, 대소문자를 구분하지 않아야 할 때는 (?i)를 추가하세요. 라우트 정규식은 이스케이프된 요청 경로와 일치하며, 여기서 공백은 %20이고 ü는 %C3%BC이지만, 정적 자산 접두사는 일반 텍스트로 작성할 수 있습니다. 라우트 정규식은 대소문자를 구분합니다. 보호된 라우트가 경로를 대소문자 구분 없이 처리하는 업스트림 앞에 있을 때는 해당 라우트에 (?i)를 추가하세요.

편의를 위해, 후행 /가 있는 요청과 정규식 그룹이 없는 요청은 /(.*)로 확장되며, 그러한 경우의 대상은 /$1로 확장됩니다. 즉, /api/ -> http://127.0.0.1/service는 ^/api/(.*) -> http://127.0.0.1/service/$1로 변환됩니다.

라우트 매칭 전에, reproxy는 디코딩된 경로에 . 또는 .. 세그먼트, 반복된 슬래시(//), ; 또는 백슬래시가 포함된 요청을 400으로 거부합니다. 단일 후행 슬래시는 허용됩니다.

대상 URL에서 호스트 치환이 지원됩니다. 예를 들어, /files/${host}는 일치된 호스트 이름으로 대체됩니다. 중괄호 없는 $host도 사용할 수 있습니다.

정규식 서버의 그룹은 대상 URL에서 ${host.1}, ${host.2} 등으로 사용할 수 있습니다(중괄호 필수). 예를 들어 서버 ^([^.]+)\.example\.com$에 라우트 ^/(.*)$와 대상 https://${host.1}.foo.com/$1을 사용하면 http://aaaa.example.com/some을 https://aaaa.foo.com/some으로 프록시합니다. $1, $2는 계속 라우트 그룹을 가리킵니다. 누락된 그룹은 빈 문자열로 대체되며, 정확한 서버, * 또는 *.example.com 서버의 ${host.N}도 그룹이 없으므로 빈 문자열로 대체됩니다. 호스트 값은 URL 이스케이프 없이 그대로 삽입되므로 서버 그룹을 엄격하게 유지하세요. 정규식을 ^와 $로 앵커링하고, 호스트 레이블이 가질 수 있는 문자만 캡처하세요. 즉 (.*) 대신 ([a-z0-9-]+)를 사용하세요. (.*)는 ...example.com 같은 호스트에서 ..도 매칭합니다. 라우트 매칭 전에 reproxy는 HTTP 호스트 헤더 검증에서 허용되지 않는 문자를 포함하거나 %를 포함하는 Host 헤더를 거부하고 400을 반환합니다. 호스트 토큰이 라우트 그룹 바로 뒤에 오는 경우, 그룹을 중괄호로 작성하세요. 즉 ${1}${host.1}로 작성하세요. $1aaaa는 1aaaa라는 이름의 그룹으로 읽히기 때문입니다.

HTTP와 HTTPS를 모두 지원합니다. HTTPS의 경우 정적 인증서뿐만 아니라 자동 ACME(Let's Encrypt) 인증서도 사용할 수 있습니다. 선택적 assets 서버를 사용하여 정적 파일을 제공할 수 있습니다. reproxy를 시작하려면 최소 하나의 provider가 정의되어야 합니다. 나머지 매개변수는 엄격히 선택 사항이며 합리적인 기본값을 가집니다.

예시:

  • 정적 provider 사용: reproxy --static.enabled --static.rule="*,example.com/api/(.*),https://api.example.com/$1"
  • 자동 docker 검색 사용: reproxy --docker.enabled --docker.auto
  • docker 컨테이너로: docker up -p 80:8080 umputun/reproxy --docker.enabled --docker.auto
  • 자동 SSL 사용: docker up -p 80:8080 -p 443:8443 umputun/reproxy --docker.enabled --docker.auto --ssl.type=auto --ssl.fqdn=example.com

설치

Reproxy는 작은 자체 포함 바이너리와 docker 이미지로 배포됩니다. 바이너리와 이미지 모두 여러 아키텍처와 여러 운영 체제를 지원하며, linux_x86_64, linux_arm64, linux_arm, macos_x86_64, macos_arm64, windows_x86_64, windows_arm을 포함합니다. 또한 arm64와 x86 deb 및 rpm 패키지도 제공합니다.

  • 바이너리 배포의 경우 릴리스 섹션에서 적절한 파일을 다운로드하세요
  • Homebrew 사용자: brew install umputun/apps/reproxy
  • docker 컨테이너는 Docker Hub와 Github Container Registry에서 사용할 수 있습니다. 예: docker pull umputun/reproxy 또는 docker pull ghcr.io/umputun/reproxy.

최신 안정 버전은 :vX.Y.Z docker 태그(:latest 별칭 포함)를 가지며, 현재 master는 :master 태그를 가집니다.

Providers

프록시 규칙은 다양한 provider에 의해 제공됩니다. 현재 포함된 것 - file, docker, static, consul-catalog. 각 provider는 프록시된 요청과 정적(assets) 모두에 대해 여러 라우팅 규칙을 정의할 수 있습니다. 사용자는 동시에 여러 provider를 설정할 수 있습니다.

다양한 provider의 예시는 examples를 참조하세요

정적 provider

이것은 모든 매핑 규칙을 명령줄(또는 환경)에서 직접 정의하는 가장 간단한 provider입니다. 여러 규칙을 지원합니다. 각 규칙은 3~7개의 쉼표로 구분된 요소 server,sourceurl,destination[,ping-url[,forward-health-checks[,timeout[,throttle]]]]입니다. 예를 들어:

  • *,^/api/(.*),https://api.example.com/$1 - /api 접두사가 붙은 모든 요청을 https://api.example.com으로 프록시합니다.
  • example.com,/foo/bar,https://api.example.com/zzz,https://api.example.com/ping - example.com에 대한 모든 요청과 /foo/bar URL에 대한 요청을 https://api.example.com/zzz로 프록시하며, 상태 확인에는 https://api.example.com/ping을 사용합니다.
  • example.com,/foo/bar,https://api.example.com/zzz,https://api.example.com/ping,true - 위와 동일하지만 /ping 및 /health 요청도 백엔드로 전달합니다.
  • example.com,^/upload/(.*),https://api.example.com/$1,,,5m - 경로별 요청 타임아웃 5분 (ping-url과 forward-health-checks를 건너뛰기 위해 4번째와 5번째 필드는 비워 둠).
  • example.com,^/login,https://api.example.com/login,,,,2 - 사용자당 초당 2회 요청의 경로별 스로틀 (앞의 위치 기반 필드는 비워 둠).

4번째 요소는 상태 보고에 사용되는 선택적 ping URL을 정의합니다. 5번째 요소는 선택적으로 상태 확인 요청을 백엔드로 전달하도록 활성화합니다 (true, yes, 1). 자세한 내용은 상태 확인 섹션을 참조하세요. 6번째 요소는 선택적 경로별 요청 타임아웃입니다 (Go duration, 예: 5m, 30s). 0 또는 비어 있으면 전역 --timeout.write 설정을 상속합니다. 7번째 요소는 사용자당 선택적 경로별 초당 요청 제한입니다. 0 또는 비어 있으면 --throttle.user를 상속합니다. 빈 위치 기반 필드는 허용됩니다 (예: 사용하지 않는 중간 필드에 ,,).

파일 프로바이더

이 프로바이더는 라우팅 규칙이 담긴 yaml 파일을 사용합니다.

reproxy --file.enabled --file.name=config.yml

config.yml 예시:

default: # the same as * (catch-all) server
  - { route: "^/api/svc1/(.*)", dest: "http://127.0.0.1:8080/blah1/$1" }
  - {
      route: "/api/svc3/xyz",
      dest: "http://127.0.0.3:8080/blah3/xyz",
      ping: "http://127.0.0.3:8080/ping",
      remote: "192.168.1.0/24, 127.0.0.1", # optional, restrict access to the route
      forward-health-checks: true # optional, forward /ping and /health to backend
    }
  - {
      route: "^/admin/(.*)",
      dest: "http://127.0.0.4:8080/$1",
      auth: "admin:$2y$05$..." # optional, per-route basic auth (htpasswd bcrypt format)
    }
  - {
      route: "^/upload/(.*)",
      dest: "http://127.0.0.5:8080/$1",
      timeout: 5m # optional, per-route request timeout (Go duration). 0 or omitted inherits --timeout.write
    }
  - {
      route: "^/login",
      dest: "http://127.0.0.6:8080/login",
      throttle: 2 # optional, per-route req/sec per user. 0 or omitted inherits --throttle.user
    }
srv.example.com:
  - { route: "^/api/svc2/(.*)", dest: "http://127.0.0.2:8080/blah2/$1/abc" }
  - { route: "/web/", dest: "/var/www", "assets": true }
"*.files.example.com":
  - { route: "^/files/(.*)", dest: "http://123.123.200.200:8080/$host/$1" }

동적 프로바이더이므로 파일 변경 사항이 자동으로 적용됩니다.

서로 다른 도메인의 여러 정적 사이트는 서버 이름을 키로 사용하고 assets: true를 설정하여 제공할 수 있습니다:

도구 다운로드

인기

모두 보기 →

커뮤니티에서 가장 많이 사용되는 도구를 찾아보세요.

아직 인기 데이터가 없습니다.

모든 도구 탐색

도구 컬렉션을 둘러보세요

모든 도구 보기 →