https://github.com/briandowns/simple-httpd

Drop-in replacement for Python SimpleHTTPServer. Provides TLS via Let's Encrypt over HTTP2, and auto generated self-signed certificates.
https://github.com/briandowns/simple-httpd

golang http http-server http2 letsencrypt letsencrypt-certificates

Last synced: 29 days ago
JSON representation

Drop-in replacement for Python SimpleHTTPServer. Provides TLS via Let's Encrypt over HTTP2, and auto generated self-signed certificates.

• Host: GitHub
• URL: https://github.com/briandowns/simple-httpd
• Owner: briandowns
• License: apache-2.0
• Created: 2017-06-11T06:30:12.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2022-01-01T22:37:45.000Z (almost 3 years ago)
• Last Synced: 2024-05-01T13:11:11.795Z (8 months ago)
• Topics: golang, http, http-server, http2, letsencrypt, letsencrypt-certificates
• Language: Go
• Homepage:
• Size: 13.9 MB
• Stars: 232
• Watchers: 7
• Forks: 19
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-discoveries - simple-httpd - a replacement for Python SimpleHTTPServer and optionally provides automatic TLS via Let's Encrypt over HTTP2 or generated self-signed certificates _(`Go`)_ (Servers)

README

        
# simple-httpd

[![Build Status](https://travis-ci.org/briandowns/simple-httpd.svg?branch=master)](https://travis-ci.org/briandowns/simple-httpd)

simple-httpd is aimed to be a simple replacement for using `python -m SimpleHTTPServer` to serve local files.  Like [SimpleHTTPServer](https://docs.python.org/2/library/simplehttpserver.html), simple-httpd supports HTTP GET and HEAD requests and adheres to the [HTTP/1.1 RFC 2616](https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html) guidelines.

The HTML output is a mix of the Python module layout and of an Apache directory listing layout.

If you're looking for a full featured or even just more capable web server, take a look at [Caddy](https://caddyserver.com/).

## Features

* HTTP2 with [Let's Encrypt](https://letsencrypt.org/) integration for automatic TLS, if enabled.

* Automatic self signed certificate generation and use, if enabled.

* Multiple language support: English, Italian, Spanish, Irish. ISO 639-1 are given on the CLI.

Certificates are cached in `${HOME}/.autocert` for reuse.

## Installation

```

go get github.com/briandowns/simple-httpd

```

or

```

make install

```

or, on BSD

```

gmake install

```

### Examples

HTTP/1.1 on default port (8000)

```

simple-httpd

```

HTTP/1.1 on the given port

```

simple-httpd -p 8181

```

HTTP/2 with Let's Encrypt on the default port

```

simple-httpd -l some.valid.domain

```

The port assignment is for the HTTP server.  The TLS port will be 8081 and both will respond to requests.

```

simple-httpd -p 8080 -t some.valid.domain

```

Generate a self signed certificate and run the server

```

simple-httpd -g

```

Run server in Spanish

```

simple-httpd -l es

## Contributions

* File Issue with details of the problem, feature request, etc.

* Submit a pull request and include details of what problem or feature the code is solving or implementing.