Skip to content

nxweb – Fast and Lightweight Web Server for Applications Written in C & Python

License

LGPL-3.0 and 2 other licenses found

Licenses found

LGPL-3.0
COPYING.LESSER
GPL-3.0
LICENSE
GPL-3.0
COPYING
Notifications You must be signed in to change notification settings

Sergey-A-K/nxweb

NXWEB

NXWEB – Fast and Lightweight Web Server for Applications Written in C and Python.

Project home page

NXWEB.ORG

Rationale

Sometimes web applications need small and fast components that are best written in C. Example: ad banner rotation engine. It gets invoked many times on every page of your site producing little HTML snippets based on predefined configuration. How would you implement it? CGI is not an option as it gets loaded and unloaded on every request. Writing a module for your main web server such as Apache httpd or nginx gives best performance but server's API isn't very friendly (especially when dealing with shared memory, etc.). What we need is sort of servlet container for C (just like Java has). Before writing NXWEB I evaluated a number of existing light/embeddable web servers (mongoose, microhttpd, libevent, G-WAN) each one having their own drawbacks.

Contributing and Credits

NXWEB was originally created by Yaroslav Stavnichiy, and is currently not maintained by. Copyright (c) 2011-2012 Yaroslav Stavnichiy yarosla@gmail.com

What NXWEB offers:

  • good (if not best) performance; see [[Benchmarks|benchmarks]]
  • can serve thousands concurrent requests
  • small memory footprint
  • event-driven & multi-threaded model designed to scale
  • exceptionally light code base
  • simple API
  • decent HTTP protocol handling
  • keep-alive connections
  • chunked requests and responses
  • SSL support (via GNUTLS)
  • HTTP proxy (with keep-alive connection pooling)
  • file cache for proxied content and custom handlers' output
  • cached content can be served when backend is unavailable
  • non-blocking sendfile support (with configurable small file memory cache)
  • cacheable gzip content encoding
  • cacheable image thumbnails with watermarks (via ImageMagick)
  • basic server-side includes (SSI)
  • templating engine with page inheritance subrequests
  • integrated Python WSGI-server
  • modular design for developers
  • can be run as daemon; relaunches itself on error
  • open source

Limitations:

  • only tested on Linux

Architecture

Main thread binds TCP port, accepts connections and distributes them among network threads.

Network threads work in non-blocking fashion (using epoll) handling HTTP protocol exchange. There should be no need in using more network threads than the number of CPU cores you have, as every thread is very efficient and can easily handle thousands of concurrent connections. Numbers of network threads is automatically configured but could be limited by {{{#define NXWEB_MAX_NET_THREADS}}} directive.

After receiving complete HTTP request network thread finds and invokes application's URI handler. The invocation could happen within network thread (should only be used for quick non-blocking handlers) or within worker thread (should be used for slower or blocking handlers).

Worker threads are organized in pool. Each thread takes new job from queue, invokes URI handler, signals network thread after handler completes the job. Number of worker threads is dynamically configured depending on the load with limits specified by #define directives.

API

See official website and source code

Building from source

Download archive from here Follow INSTALL file notes

Issues

Please report issues via issue tracker

Discussions & Announcements

nxweb Visit this group

nxweb-ru (in Russian) Visit this group

About

nxweb – Fast and Lightweight Web Server for Applications Written in C & Python

Topics

Resources

License

LGPL-3.0 and 2 other licenses found

Licenses found

LGPL-3.0
COPYING.LESSER
GPL-3.0
LICENSE
GPL-3.0
COPYING

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published