This is a maintenance fork of libuhttpd
 
 
 
Go to file
Chris Babcock e29741fb1f Merge remote-tracking branch 'upstream/master' into main 2021-03-06 23:52:36 -07:00
.github/workflows ci: auto release 2021-02-27 00:29:53 +08:00
cmake/Modules Use libev instead of libubox 2019-08-31 16:33:08 +08:00
example style: fix 2021-03-02 20:51:58 +08:00
src feat: connection: new api: traverse_headers 2021-03-02 20:53:05 +08:00
.gitignore Update .gitignore 2021-01-12 10:39:06 +08:00
.gitmodules http-parser: Use submodule 2020-03-06 13:48:48 +08:00
BUILDOPENWRT.md chmod 644 2018-03-18 10:48:32 +08:00
BUILDOPENWRT_ZH.md chmod 644 2018-03-18 10:48:32 +08:00
CMakeLists.txt Bump CMake minimum to 2.8.12 2021-01-20 22:34:15 +08:00
CONTRIBUTING.md chmod 644 2018-03-18 10:48:32 +08:00
CONTRIBUTING_ZH.md chmod 644 2018-03-18 10:48:32 +08:00
LICENSE Change the license information 2019-09-03 15:03:35 +08:00
README.md Merge remote-tracking branch 'upstream/master' into main 2021-03-06 23:52:36 -07:00
README_ZH.md Bump version 3.10.1 2021-03-01 17:12:42 +08:00
gen_cert.sh feat: multiple listen 2021-02-27 00:22:53 +08:00

README.md

This is a maintenance fork

libuhttpd(中文)

license PRs Welcome Issue Welcome Release Version Build Status

A very flexible, lightweight and fully asynchronous HTTP server library based on libev and http-parser for Embedded Linux.

Features

  • Lightweight and fully asynchronous
  • Use libev as its event backend
  • Support HTTPS - OpenSSL, mbedtls and CyaSSl(wolfssl)
  • Support HTTP pipelining
  • Support IPv6
  • Support plugin
  • Support upload large file
  • Support HTTP range requests
  • Support multi-process model - The same multi-process model as Nginx
  • Flexible - you can easily extend your application to have HTTP/HTTPS services
  • Code structure is concise and understandable, also suitable for learning

Dependencies

  • libev - A full-featured and high-performance event loop
  • http-parser - A high performance parser for HTTP messages written in C
  • mbedtls - If you choose mbedtls as your SSL backend
  • wolfssl - If you choose wolfssl as your SSL backend
  • openssl - If you choose openssl as your SSL backend

Benchmark

Nginx

$ wrk -t4 -c400 -d10s http://localhost:80/test.html
Running 10s test @ http://localhost:80/test.html
4 threads and 400 connections
Thread Stats   Avg      Stdev     Max   +/- Stdev
	Latency     3.54ms    7.32ms 224.58ms   93.30%
	Req/Sec    40.63k    12.49k   96.29k    74.50%
1622012 requests in 10.05s, 385.09MB read
Requests/sec: 161390.39
Transfer/sec:     38.32MB

libuhttpd

$ wrk -t4 -c400 -d10s http://localhost:8080/test.html
Running 10s test @ http://localhost:8080/test.html
4 threads and 400 connections
Thread Stats   Avg      Stdev     Max   +/- Stdev
	Latency     2.12ms    3.01ms  31.30ms   89.26%
	Req/Sec    70.87k    12.53k  142.54k    79.75%
2826394 requests in 10.05s, 547.18MB read
Requests/sec: 281328.83
Transfer/sec:     54.46MB

Configure

See which configuration are supported

~/libuhttpd/$ mkdir build && cd build
~/libuhttpd/build$ cmake .. -L
~/libuhttpd/build$ cmake .. -LH

Build and install

~/libuhttpd/build$ make && sudo make install

Run Example

Run

~/libuhttpd/build$ ./example/simple_server -v

Then use the command curl or browser to test

$ curl 'https://127.0.0.1:8000' -v

Install on OpenWrt

opkg update
opkg list | grep libuhttpd
opkg install libuhttpd-nossl

If the install command fails, you can compile it yourself.

Example

Contributing

If you would like to help making libuhttpd better, see the CONTRIBUTING.md file.