C++ Makefile HTML Shell Vim script M4 Other
Permalink
Failed to load latest commit information.
3rdparty
contrib remove useless cut in favor of shell file redirection Apr 24, 2017
debian updated copyright year to 2017 Jan 28, 2017
docs updated copyright year to 2017 Jan 28, 2017
examples project restructuring in order to `make install` also header files. Feb 12, 2017
flowcc project restructuring in order to `make install` also header files. Feb 12, 2017
src [xzero] big code simplification & adds InetConnector protocol switch Mar 18, 2017
tests mute codacay while trying it out Apr 24, 2017
www updated copyright year to 2017 Jan 28, 2017
xurl project restructuring in order to `make install` also header files. Feb 12, 2017
xzero-flow some compile warning fixes [GCC] Mar 11, 2017
xzero [xzero] DnsClient: use ns_c_in instead of deprecated C_IN Apr 26, 2017
.clang-format initial import Jul 24, 2014
.dockerignore docker support Nov 27, 2015
.gitignore adds a default x0d.conf to the package Jul 7, 2016
.travis.yml updates my email alias Jan 28, 2017
ChangeLog ChangeLog update Dec 18, 2015
Dockerfile updates my email alias Jan 28, 2017
Doxyfile.in cmake cleanup Jul 6, 2016
INSTALL major project rewrite to seperate sub-projects even more clearly Jul 26, 2014
Jenkinsfile Jenkinsfile: disable deb pkg builder for now Jul 22, 2016
LICENSE updated copyright year to 2017 Jan 28, 2017
Makefile.am [xzero] big code simplification & adds InetConnector protocol switch Mar 18, 2017
README.md
REWRITE.md remove unnecessary enum field HttpChannelState::DONE Jul 20, 2016
TODO.md [xzero] big code simplification & adds InetConnector protocol switch Mar 18, 2017
XzeroBase.pc.in pkg-config file fixes Feb 23, 2017
XzeroFlow.pc.in project restructuring in order to `make install` also header files. Feb 12, 2017
XzeroTest.pc.in [xzero] adds XzeroTest.pc Mar 5, 2017
autogen.sh
configure.ac
docker-x0d.conf missing int cast Nov 27, 2015
generate_asset.sh adds helper script for compiling assets into c++ Dec 23, 2015
mimetypes2cc.sh remove useless cut in favor of shell file redirection Apr 24, 2017
x0d.conf some local changes for my test env Aug 27, 2016

README.md

Xzero HTTP Application Web Server

x0d is a thin low-latency and scalable HTTP web server built on-top of the Xzero C++ HTTP Framework.

It supports a very expressive and natural configuration via the Flow configuration language and a number of standard plugins to become your web application server.

Features

  • Customizable Error Pages
  • Automatic Directory Indexing
  • on-the-fly executable upgrade with gracefully finishing currently active requests.
  • Easily Extensible via the Powerful Plugin System
  • SSL connection encryption
    • SSL Server Name Indication (SNI) extension
  • Dynamic Content Compression
  • Advanced Dynamic Load Balancer
    • Supporting different backend transports (TCP/IP, and UNIX Domain Sockets).
    • Supporting different backend protocols (HTTP and FastCGI)
    • Advanced Health Monitoring
    • JSON API for retrieving state, stats, and reconfiguring clusters (including adding/updating/removing backends).
    • Client Side Routing support
    • Sticky Offline Mode
    • X-Sendfile support, full static file transmission acceleration
    • HAproxy compatible CSV output
    • Object Cache
      • fully runtime configurable
      • client-cache aware
      • life JSON stats
      • supports serving stale objects when no backend is available
      • Vary response-header Support.
      • multiple update strategies (locked, shadowed)
  • Basic Authentication
    • including PAM authentication
  • Request Path Aliasing
  • Automatic Directory Listing
  • Apache-style access logging
  • User-directory Support
  • Browser Match Support
  • Customizable Expires & Cache-Control Response Header Control
  • instant mode (configuration-less basic HTTP serving)
  • CGI/1.1 Support

Installation Requirements

  • gcc >= 4.8.0 (for building only, CLANG >= 3.8 is also supported)
  • automake / autoconf (for building only)
  • zlib (optional & recommended, for compression)
  • OpenSSL (optional & recommended, for SSL/TLS encryption)

Building from Source on Ubuntu 16.04:

# Installs required dependencies
sudo apt-get install make autoconf automake libtool gcc-4.8 g++-4.8 \
    libmysqlclient-dev zlib1g-dev libbz2-dev pkg-config libssl-dev \
    libpcre3-dev libfcgi-dev libgoogle-perftools-dev libpam-dev git \

# Install git and clone repository
git clone git://github.com/christianparpart/x0.git && cd x0

# Now run cmake to bootstrap the build
mkdir -p build && cd build
../autogen.sh
../configure.sh

# Now compiling should just work.
make && sudo make install

# Run web server on port 8080
./src/x0d --instant=`pwd`/www/htdocs,8080

# or try its CLI help
./src/x0d -h

# have fun hacking and don't forget to checkout the just installed man pages ;-)

Build from Sources on Ubuntu 12.04

# Ensure required GCC (version 4.8)
sudo apt-get install python-software-properties
sudo add-apt-repository ppa:ubuntu-toolchain-r/test
sudo apt-get update
sudo apt-get install gcc-4.8 g++-4.8

# Installs required dependencies
sudo apt-get install make cmake libssl-dev \
    libmysqlclient-dev libev-dev zlib1g-dev libbz2-dev pkg-config \
    libpcre3-dev libfcgi-dev libgoogle-perftools0 libpam-dev git

# If you want to built the tests, you must install libgtest-dev and then
# built it yourself
sudo apt-get install libgtest-dev
cd /usr/src/gtest && sudo cmake -DCMAKE_C_COMPILER=$CC \
        -DCMAKE_CXX_COMPILER=$CXX . && sudo make && \
    sudo cp -vpi libgtest*.a /usr/local/lib/; cd -

# Install git and clone repository
git clone git://github.com/xzero/x0.git && cd x0

# Now run cmake to bootstrap the build
mkdir -p build && cd build
cmake .. -DCMAKE_C_COMPILER=/usr/bin/gcc-4.8 -DCMAKE_CXX_COMPILER=/usr/bin/g++-4.8

# Now compiling should just work.
make && sudo make install

# Run web server on port 8080
./src/x0d --instant=`pwd`/www/htdocs,8080

# or try its CLI help
./src/x0d -h

# have fun hacking and don't forget to checkout the just installed man pages ;-)

LICENSE

Copyright (c) 2009-2017 Christian Parpart <christian@parpart.family>

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.