29 releases
| 0.1.13-RC2 | Nov 5, 2025 |
|---|---|
| 0.1.11-patch1 | Feb 12, 2025 |
| 0.1.10 | Dec 17, 2024 |
| 0.1.8 | Oct 21, 2024 |
| 0.0.1-alpha8 | Oct 30, 2023 |
#141 in HTTP server
3MB
22K
SLoC
Contains (WOFF font, 99KB) fontawesome-webfont.woff, (WOFF font, 78KB) fontawesome-webfont.woff2, (WOFF font, 45KB) open-sans-v17-all-charsets-300.woff2, (WOFF font, 41KB) open-sans-v17-all-charsets-300italic.woff2, (WOFF font, 45KB) open-sans-v17-all-charsets-600.woff2, (WOFF font, 43KB) open-sans-v17-all-charsets-600italic.woff2 and 18 more.
ODD-BOX
A simple, cross-platform reverse proxy server tailored for local development and tinkering. Think of it as a lightweight (and more streamlined) alternative to something like IIS, but with a key difference: configuration is primarily done declaratively through structured files, rather than a graphical user interface.
It allows you to configure a list of processes to run and host them behind their own custom hostnames. Self-signed certificates for HTTPS are automatically generated when accessing a site thru the terminating proxy service the first time (cached in .odd-box-cache dir). As with most reverse-proxy servers, odd-box also supports targetting remote backend servers.
As configuration is done thru basic files (toml format) which are easy to share, it's very easy to reproduce a particular setup.
Pre-built binaries are available in the release section.
You can also build it yourself, or install it using brew, cargo, nix or devbox; see the installation section for guidance.
Features (incomplete list)
See the docs for details and more features.
- Cross-platform support (Windows, Linux, macOS)
- Lets-Encrypt support for automatic certificate generation
- Docker integration
- Simple configuration using TOML files
- Keep specified binaries running automatically
- Host local directories for static sites
- Support for both process-specific and global environment variables
- Proxy to remote backend servers
- Terminating proxy supporting HTTP/1.1 & HTTP2 (level 7)
- TCP tunneling for HTTP/1 and HTTPS via SNI sniffing (level 4)
- Basic round-robin load balancing for remote targets
- Automatic self-signed certificates for all hosted processes
- Built in support for rendering markdown files as html for static sites
- Administration API for programmatic control of the proxy
- Web interface for those that do not enjoy the terminal based UI
Planned features
- Certificate management UI (web & tui)
- Traffic inspection UI (web & tui)
- Extended routing rules (ie. not just host header & sni sniffing)
- Basic statistics (process uptimes,con+req count,bytes transfered,latency etc.)
Screenshot(s)
odd-box v0.1.2: