Skip to content

Release history

Groxy releases

All releases

6 shown

No immediate action
v0.5.2 New feature

HTTPS inspection benchmarks

No immediate action
v0.5.1 Feature

Custom block docs + examples

No immediate action
v0.4.1 Maintenance

Routine maintenance and dependency updates.

No immediate action
v0.4.0 New feature

AccessLog middleware

v0.3.1 Maintenance
Notable features
  • Quickstart section: "Try it in 60 seconds"
  • Forward proxy guide added (docs/building-forward-proxy.md)
  • CA trust instructions for HTTPS inspection
Full changelog

What's changed

This patch release improves Groxy's documentation and contributor experience.

Added

  • Quickstart section: "Try it in 60 seconds"
  • Forward proxy guide: docs/building-forward-proxy.md
  • CA trust instructions for HTTPS inspection
  • Open source project hygiene files:
    • CONTRIBUTING.md
    • SECURITY.md
    • CHANGELOG.md
    • ROADMAP.md
    • issue and PR templates

Notes

No runtime behavior changes are included in this release.

Install

go get github.com/SalzDevs/[email protected]

Docs

https://pkg.go.dev/github.com/SalzDevs/groxy

v0.3.0 New feature
⚠ Upgrade required
  • HTTPS inspection is opt‑in; by default Groxy tunnels HTTPS traffic normally using CONNECT
  • Users must install and trust the generated Groxy CA certificate for inspected traffic
  • Current implementation targets HTTP/1.1 over TLS only
Notable features
  • Added `HTTPSInspectionConfig` and `Config.HTTPSInspection` for opt‑in TLS interception
  • Local CA generation/loading (`NewCA`, `LoadCAFiles`, `CA.WriteFiles`) and per‑host certificate handling
  • Extended HTTPS middleware to support request/response hooks, blocking, and body transforms
Full changelog

Highlights

Groxy v0.3.0 adds opt-in HTTPS inspection using local TLS interception.

This means existing middleware can now run on selected HTTPS traffic when inspection is explicitly enabled.

What's new

  • Added HTTPSInspectionConfig
  • Added Config.HTTPSInspection
  • Added local CA generation/loading:
    • NewCA
    • LoadCAFiles
    • CA.WriteFiles
  • Added host matching helpers:
    • MatchHosts
    • MatchAllHosts
  • Added per-host certificate generation and renewal
  • Added HTTPS middleware support for:
    • request hooks
    • response hooks
    • blocking
    • body transforms
  • Added HTTPS inspection example
  • Updated README/docs

Important security note

HTTPS inspection requires users to install and trust the generated Groxy CA certificate.

Only inspect traffic you own or are authorized to inspect.

By default, Groxy still tunnels HTTPS traffic normally using CONNECT. HTTPS inspection is explicit opt-in.

Limitations

  • HTTPS inspection currently targets HTTP/1.1 over TLS.
  • Users must manually trust the local CA.
  • Generated per-host certificates are memory-only and renewed before expiry.

Install

go get github.com/SalzDevs/[email protected]

Beta — feedback welcome: [email protected]