Prax

Rack proxy server for development

This is an (almost) complete rewrite of Prax in Crystal, a Ruby-inspired language that compiles down to LLVM. This version should avoid problems with version managers, since Prax is now a binary application that don't rely on Ruby anymore (except for Rack and rackup).

Please refer to the wiki for more information:

• Manual Install Guide
• User Guide

How it works

1. resolves *.dev domains to 127.0.0.1 / ::1 (localhost)
2. redirects the :80 and :443 ports to :20559 and :20558
3. receives incoming HTTP requests and extracts the hostname (eg: myapp.dev)
4. spawns a Rack applications (found at ~/.prax/myapp) if any
5. proxies the request to the spawned Rack aplication or to the specified port.

.dev TLD

Prax proposes 2 solutions to resolve .dev domains:

• an NSSwitch extension, only compatible wih glibc and no longer compatible with Google Chrome/Chromium;
• a dnsmasq configuration, either throught NetworkManager or by installing dnsmasq manually (eg. through your Linux distribution package).

Prax also supports http://xip.io domains, so you may use myapp.129.168.0.1.xip.io for example. This is very useful when using an external device like a smartphone or tablet or another computer.

Port Redirections

The port redirections are iptables rules, that are installed and removed using an initd script. The script redirects the port :80 and :443 on 127.0.0.1 and for each wlanX and ethX devices found on your machine, to allow incoming traffic, so you may use xip.io to test on external devices, as mentioned above.

Install

Prax is getting ready for end-user consumption, but is still missing an easy setup. You'll may want to follow the Manual Install Guide until deb and rpm packages are built and tested.

License

Prax is distributed under the CeCILL 2.1 license. Please see LICENSE for details.

HTML templates for rendering errors are from Pow!!, by Sam Stephenson and Basecamp, and are under the MIT license.

The NSSwitch extension originaly come from Hoof, by pyromaniac, and is under the MIT license.

Credits

• Julien Portalier julien@portalier.com

Prax wouldn't exist without Pow!! by Sam Stephenson and Basecamp. Prax is nothing more but a reimplementation (in another language) with Linux compatibility in mind.