convez.ai
MCP ServerDevOps & InfraestruturaIntermediário
soapbucket

SBproxy

soapbucket/sbproxy

Gateway IA + proxy reverso em um binário. Governança, auth e LLM em YAML.

Ver no GitHub
BomPluginScore · de 0 a 100

Gateway de IA e proxy reverso unificado, auto-hospedável, escrito em Rust. Consolida roteamento HTTP, governança de tráfego LLM, autenticação, rate limiting e proteção em um único binário com configuração centralizada.

Instalação

$npx convez-ai soapbucket/sbproxy

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
54
Forks
1
Acompanhando
0
Saúde
87%
Último commit
há 2 meses
Versão
v1.14.0
Issues abertas
1
Contribuidores
1

Casos de uso

  • Centralizar roteamento de tráfego HTTP e chamadas para LLMs em uma única gateway
  • Implementar guardrails, rate limiting e orçamentos para modelos de IA
  • Substituir múltiplas ferramentas (reverse proxy + AI gateway) por uma solução unificada

Veredito

Solução sólida para equipes que precisam de um ponto único de controle sobre tráfego HTTP e LLM, com performance mínima (sub-ms overhead) e segurança integrada. Ideal para arquiteturas que querem eliminar ferramentas duplicadas mantendo flexibilidade.

README

A tradução para o português deste README ainda está na fila.

Last modified: 2026-05-16


Why SBproxy

Most teams run one tool for HTTP traffic and another for LLM traffic. That's two systems to configure, deploy, and monitor. SBproxy handles both in one binary.

  • One config file replaces your reverse proxy, AI gateway, and the middleware glue between them.
  • 200+ LLM models behind an OpenAI-compatible API, with fallback chains, guardrails, and budgets.
  • Secure by default. Auth, rate limiting, WAF, DDoS, and CSRF are built in.
  • Hot reload with no dropped connections.
  • Sub-millisecond p99 overhead. Idle RSS in single-digit megabytes.

Install

curl (macOS / Linux):

curl -fsSL https://download.sbproxy.dev | sh

The script detects your OS and architecture, fetches the matching release binary from GitHub, and drops it in ~/.local/bin. Override with SBPROXY_INSTALL=<dir> for a custom location or SBPROXY_VERSION=<tag> to pin a release.

Homebrew (macOS / Linux):

brew tap soapbucket/tap
brew install sbproxy

Docker:

docker pull ghcr.io/soapbucket/sbproxy:latest

From source (needs Rust 1.82+):

git clone https://github.com/soapbucket/sbproxy
cd sbproxy
make build-release

Quick start

We host a public HTTP echo service at test.sbproxy.dev (request inspection, like httpbin) so you can wire up a real upstream without leaving the SoapBucket ecosystem. Try it directly:

curl https://test.sbproxy.dev/get

Now run the gateway in front of it. Drop this into sb.yml:

proxy:
  http_bind_port: 8080

origins:
  "myapp.example.com":
    action:
      type: proxy
      url: https://test.sbproxy.dev
make run CONFIG=sb.yml
curl -H "Host: myapp.example.com" http://127.0.0.1:8080/get

myapp.example.com is the host your client sees; SoapBucket matches it against origins: and forwards to the upstream. Use any hostname you want here; example.com is reserved (RFC 2606), so it never collides with anything real.

That's a reverse proxy. Add AI routing, auth, and rate limiting in the same file. See examples/ for runnable end-to-end configurations covering each feature.


Documentation

The full documentation lives in docs/README.md: manual, configuration reference, AI gateway guide, scripting reference, performance, troubleshooting, architecture, and more. Running the operator for the first time? Start with docs/quickstart-operator.md.

For contributors: CONTRIBUTING.md.


Community


Upgrading from v0.1.x (Go)

SBproxy v1.0 is a Rust rewrite. The Go implementation that previously occupied this repository is archived at soapbucket/sbproxy-go and tagged v0.1.2-go-final. New work happens here. See MIGRATION.md for the upgrade path; existing sb.yml files should compile unchanged.


License

Licensed under the Apache License 2.0. Free for any use, including production and commercial, with no field-of-use restriction.

See also NOTICE and TRADEMARKS. A Soap Bucket LLC project.

Ver o original no GitHub

Bom para

Relacionados