A transparent blazing fast fastcgi reverse proxy .
- Cross platform .
- Accelerated and optimized without modules hell.
- No configurations needed .
- Standalone, Tiny & Lightweight .
- Supports both http and https .
- Automatically use HTTP/2 "in https" .
- Control the whole webserver just with your preferred programming language .
- Tell xerver to perform some operations using http-headers, i.e "send-file, proxy-pass, ... etc" .
- More is coming, just stay tuned .
- A request hits the
xerver
. xerver
handles the request .xserver
send it to the backendfastcgi
process and the main controller file .- the controller file contains your own logic .
fastcgi
process reply toxerver
with the result .xerver
parse the result and then prepare it to be sent to the client .
1- make sure you have Golang
installed .
2- go get -u github.com/alash3al/xerver
3- go install github.com/alash3al/xerver
4- make sure $GOPATH
in your $PATH
env var .
5- xerver --help
Only acts as a static file server by default on port 80
xerver --root=/path/to/www/ --http=:80
Listen on address 0.0.0.0:80
and send the requests to ./controller.php
xerver --backend=unix:/var/run/php5-fpm.sock controller=./controller.php --http=:80
** OR Listen on address 0.0.0.0:80
& 0.0.0.0:443
** and send the requests to ./controller.php
xerver --backend=unix:/var/run/php5-fpm.sock controller=./controller.php --http=:80 --https=:443 --cert=./cert.pem --key=./key.pem
Open your ./controller.php and :
<?php
// uncomment any of the following to test it .
// here you perform your own logic
// echo "<pre>" . print_r($_SERVER, 1);
// some xerver internal header for some operations
// 1)- tell xerver to serve a file/directory to the client .
// header("Xerver-Internal-FileServer: " . __DIR__ . "/style.css");
// 2)- tell xerver to serve from another server "act as reverse proxy" .
// header("Xerver-Internal-ProxyPass: http://localhost:8080/");
// 3)- tell xerver to hide its own tokens "A.K.A 'Server' header"
// header("Xerver-Internal-ServerTokens: off");
// the above headers won't be sent to the client .
Open your browser and go to localhost
or any localhost
paths/subdomains .
You can use xerver.php
as a production ready controller file