superng6/darkhttpd repository overview

GitHub:https://github.com/SuperNG6/tiny-docker-httpd⁠
DockerHub:https://hub.docker.com/r/superng6/darkhttpd⁠

⁠Ultra tiny docker image that serves file (less than 75kB)

docker pull superng6/darkhttpd

⁠Version

2018-12-10 darkhttpd-1.12

⁠Architecture

⁠How to run darkhttpd

docker run --rm -it  -p 80:80/tcp -v /www:/www superng6/darkhttpd:latest

Serve /var/www/htdocs on the default port (80 if running as root, else 8080): $ ./darkhttpd /var/www/htdocs

Serve ~/public_html on port 8081: $ ./darkhttpd ~/public_html --port 8081

Only bind to one IP address (useful on multi-homed systems): $ ./darkhttpd ~/public_html --addr 192.168.0.1

Serve at most 4 simultaneous connections: $ ./darkhttpd ~/public_html --maxconn 4

Log accesses to a file: $ ./darkhttpd ~/public_html --log access.log

Chroot for extra security (you need root privs for chroot): $ ./darkhttpd /var/www/htdocs --chroot

Use default.htm instead of index.html: $ ./darkhttpd /var/www/htdocs --index default.htm

Add mimetypes - in this case, serve .dat files as text/plain: $ cat extramime text/plain dat $ ./darkhttpd /var/www/htdocs --mimetypes extramime

Drop privileges: $ ./darkhttpd /var/www/htdocs --uid www --gid www

Use acceptfilter (FreeBSD only): $ kldload accf_http $ ./darkhttpd /var/www/htdocs --accf

Run in the background and create a pidfile: $ ./darkhttpd /var/www/htdocs --pidfile /var/run/httpd.pid --daemon

Web forward (301) requests for some hosts: $ ./darkhttpd /var/www/htdocs --forward example.com http://www.example.com⁠
--forward secure.example.com https://www.example.com/secure⁠

Web forward (301) requests for all hosts: $ ./darkhttpd /var/www/htdocs --forward example.com http://www.example.com⁠
--forward-all http://catchall.example.com⁠

Commandline options can be combined: $ ./darkhttpd ~/public_html --port 8080 --addr 127.0.0.1

To see a full list of commandline options, run darkhttpd without any arguments: $ ./darkhttpd

vim:set ts=2 sw=2 et tw=80: