Ergo Proxy - The reverse proxy agent for local domain management.
The management of multiple apps running over different ports made easy through custom local domains.
More you can see in examples
The Ergo's goal is to be a simple reverse proxy that follows the Unix philosophy of doing only one thing and do it well. Simplicity means no magic involved. Just a flexible reverse proxy that extends the well-known /etc/hosts
declaration.
Feedback
This project is under development but it's already usable. Feel free to give me feedback and opening issues. Suggestions and contributions are welcome. :)
When dealing with multiple apps locally is really annoying having to remember each port that represents each service and it gets even worse when you have microservices. So I wanted a simple way to give a proper local domain for each app. Ergos comes to solve this simple problem.
brew tap cristianoliveira/tap
brew install ergo
curl -s https://raw.githubusercontent.com/cristianoliveira/ergo/master/install.sh | sh
For windows you can find the executable in each release.
Disclaimer: I only use unix based systems on my daily basis, so I can't test each build :(
go install github.com/cristianoliveira/ergo
Make sure you have $GOPATH/bin
in your path. export PATH=$PATH:$GOPATH/bin
Ergo looks for a .ergo
file inside the current folder. It must contain the names and URL of the services following the same format as the /etc/hosts
(domain+space+url) the main difference is that it also considers the port specified.
Let's start:
You need to set the http://127.0.0.1:2000/proxy.pac
configuration on your system network config
Ergo comes with a setup command that can configure that for you. The current systems supported are:
- osx
- linux-gnome
(Contributions are welcomed)
ergo setup <operation-system>
In case of errors or if it doesn't work please take a look on detailed config session below.
echo "ergoproxy http://localhost:3000" > .ergo
ergo run
Now you are able to access: http://ergoproxy.dev
.
Ergo redirects anything that finish with .dev
to the configured url.
Simple right? No magic involved.
Do you want add more services? So is easy, just add more lines in .ergo
:
echo "otherservice http://localhost:5000" >> .ergo
ergo list
ergo run
Restart the server and access: http://otherservice.dev
In order to use Ergo domains you need to set it as a proxy. Set the http://127.0.0.1:2000/proxy.pac
on:
Network Preferences > Advanced > Proxies > Automatic Proxy Configuration
Settings > Network and Internet > Proxy > Use setup script
On Ubuntu
System Settings > Network > Network Proxy > Automatic
For other distributions, check your network manager and look for proxy configuration. Use browser configuration as an alternative.
Browsers can be configured to use a specific proxy. Use this method as an alternative to system-wide configuration.
Exit Chrome and start it using the following option:
# Linux
$ google-chrome --proxy-pac-url=http://localhost:2000/proxy.pac
# OS X
$ open -a "Google Chrome" --args --proxy-pac-url=http://localhost:2000/proxy.pac
As an alternative you can see the scripts inside /resources
for running an
ephemeral setup. Those scripts sets the proxy only while ergo
is running.
Running tests:
make test
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature
- Commit your changes:
git commit -am 'Add some feature'
- Push to the branch:
git push origin my-new-feature
- Submit a pull request
Pull Requests are welcome!
Pull Request should have unit tests
MIT