proxyboi 0.5.0

A super simple reverse proxy with TLS support
proxyboi-0.5.0 is not a library.


GitHub Actions Workflow Docker Cloud Build Status AUR license

A super simple reverse proxy with TLS support

How to run

In order to listen for proxy requests on all local interfaces on port 8080 and proxy them to a service running at, do:

proxyboi -l

You can also feed your TLS certificates into it:

proxyboi -l --cert mycert.pem --key mykey.key

You can see a detailed (and pretty!) verbose log using -v:

proxyboi -l -v

Pretty log


proxyboi 0.5.0
Sven-Hendrik Haase <>
A super simple reverse proxy with TLS support

    proxyboi [FLAGS] [OPTIONS] <upstream>

    <upstream>    Upstream server to proxy to (eg. http://localhost:8080)

    -h, --help        Prints help information
    -k, --insecure    Allow connections against upstream proxies with invalid TLS certificates
    -q, --quiet       Be quiet (log nothing)
    -v, --verbose     Be verbose (log data of incoming and outgoing requests)
    -V, --version     Prints version information

    -l, --listen <listen>                          Socket to listen on [default:]
        --response-header <response-headers>...
            Additional response headers to send to requesting client

        --timeout <timeout>
            Connection timeout against upstream in seconds (including DNS name resolution)
            [default: 5]

        --cert <tls-cert>                          TLS cert to use
        --key <tls-key>                            TLS key to use
        --upstream-header <upstream-headers>...    Additional headers to send to upstream server


This is mostly a note for me on how to release this thing:

  • Make sure is up to date.
  • cargo release --dry-run <version>
  • cargo release <version>
  • Releases will automatically be deployed by Github Actions.
  • Docker images will automatically be built by Docker Hub.
  • Update Arch package.