Skip to content
KitploitKITPLOIT
工具漏洞利用博客
Log in
提交
工具漏洞利用博客
提交

黑客、渗透测试和网络安全工具,武装您的安全武器库!

Kitploit 是一个黑客、网络安全和渗透测试工具的目录。发现最新的项目更新,查找漏洞、分析系统、自动化测试并加强你的安全。

订阅源联系隐私© 2026 Kitploit

工具目录

分类

查看所有分类
Loading categories
reproxy — 轻量级边缘HTTP(S)服务器和反向代理,具有自动SSL、Docker/Consul发现、按路由认证、速率限制和基于健康检查的故障转移。 | Kitploit
工具/GitHubGitHub/umputun/reproxy
身份验证与授权通用工具Web安全网络安全API 安全
GitHubumputun/reproxy

reproxy

轻量级边缘HTTP(S)服务器和反向代理,具有自动SSL、Docker/Consul发现、按路由认证、速率限制和基于健康检查的故障转移。

查看仓库
1.3k967917天前Kitploit 审核通过
分享
网站
Reproxy | 简单反向代理

Reproxy 是一个简单的边缘 HTTP(s) 服务器 / 反向代理,支持多种提供程序(docker、static、file、consul catalog)。一个或多个提供程序提供有关请求服务器、请求 URL、目标 URL 和健康检查 URL 的信息。它以单个二进制文件或 docker 容器的形式分发。

  • 使用 Let's Encrypt 自动进行 SSL 终止
  • 支持用户提供的 SSL 证书
  • 简单但灵活的代理规则
  • 静态、命令行代理规则提供程序
  • 动态、基于文件的代理规则提供程序
  • 具有自动发现功能的 Docker 提供程序
  • 通过服务标签进行发现的 Consul Catalog 提供程序
  • 支持多个(虚拟)主机
  • 可选的流量压缩
  • 可选的基于 IP 的访问控制
  • 按路由的基本身份验证
  • 用户定义的大小限制和超时
  • 单一二进制文件分发
  • Docker 容器分发
  • 内置静态资源服务器,可选“SPA 友好”模式
  • 支持重定向规则
  • 可选的限制器,用于整体活动以及用户活动
  • 实时健康检查和故障转移/负载均衡
  • 带有路由信息和 prometheus 指标的管理服务器
  • 通过 RPC 支持插件以实现自定义功能
  • 可选的日志记录,同时支持 Apache 日志格式和简化的 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)证书。可选的资源服务器可用于提供静态文件。启动 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 包。

  • 对于二进制分发,请在 release 部分 下载相应的文件
  • 对于 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 可以为代理请求和静态(资源)定义多条路由规则。用户可以同时设置多个 provider。

在 examples 中查看各种 provider 的示例

静态 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 分钟(第 4 和第 5 个字段留空以跳过 ping-url 和 forward-health-checks)。
  • 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。允许位置字段留空(例如用 ,, 表示未使用的中间字段)。

File provider

此 provider 使用带路由规则的 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 来提供服务:

site-en.example.com:
  - { route: "/", dest: "/var/www/en", "assets": true }
site-ru.example.com:
  - { route: "/", dest: "/var/www/ru", "assets": true }

重要: 资产规则的 route 字段必须是路径前缀(例如 /、/web/),而不是正则表达式。像 ^/(.*) 这样的正则模式无法与 assets: true 配合使用,因为静态资产匹配使用的是路径前缀比较,而不是正则表达式。

Docker provider

Docker provider 支持全自动发现(使用 --docker.auto),无需额外配置。默认情况下,它会将所有形如 http://<url>/<container name>/(.*) 的请求重定向到指定容器的内部 IP 和暴露端口。只有活跃(运行中)的容器会被检测到。

此默认行为可通过标签更改:

下载工具

最受欢迎

查看全部 →

发现我们社区最常用的工具。

暂无热门数据。

探索所有工具

浏览我们的工具集合

查看所有工具 →