|
7 years ago | |
---|---|---|
.gitignore | 7 years ago | |
LICENSE | 7 years ago | |
README.md | 7 years ago | |
config.go | 7 years ago | |
hostsplitter.go | 7 years ago | |
signal_handler.go | 7 years ago | |
site.go | 7 years ago |
README.md
HostSplitter
HostSplitter is an HTTP reverse proxy and load balancer that distributes requests to an arbitrary amount of sites based on the Host header.
Motivation
I commonly run into an issue developing small golang websites: I want to use the same IP address for many sites that aren't large enough to justify their own server.
Site files
HostSplitter will look for site files by default in "/etc/hostsplitter/". HostSplitter will only read files with the .json extension.
A each site file should look like
{
"hostnames": [
"ammar.io",
"www.ammar.io"
],
"backends": [
"127.0.0.1:9000"
],
"secret": "puppies1234"
}
The "secret" field is passed along with every request to that site in the X-Hostsplitter-Secret
header. This is intended to be checked before trusting the passed along IP.
Real IP
The original requester's IP is located in the X-Forwarded-For
header.
Reloading
HostSplitter provides 0 downtime reload functionality via SIGUSR1. E.g
pkill -10 hostsplitter
Roadmap
- SSL