https://github.com/eliben/static-server

A simple, zero-configuration HTTP server CLI for serving static files
https://github.com/eliben/static-server

go http http-server static-server

Last synced: 15 days ago
JSON representation

A simple, zero-configuration HTTP server CLI for serving static files

• Host: GitHub
• URL: https://github.com/eliben/static-server
• Owner: eliben
• License: unlicense
• Created: 2023-08-29T17:29:03.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2024-10-15T17:14:26.000Z (29 days ago)
• Last Synced: 2024-10-16T23:42:06.264Z (27 days ago)
• Topics: go, http, http-server, static-server
• Language: Go
• Homepage:
• Size: 26.4 KB
• Stars: 185
• Watchers: 3
• Forks: 9
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![Go](https://github.com/eliben/static-server/actions/workflows/go.yml/badge.svg)](https://github.com/eliben/static-server/actions/workflows/go.yml)

----

# static-server

Simple static file server, with support of HTTP and HTTPS. Useful for local testing of web applications.

There are no configuration files and no dependencies (except one for testing). Serving the current directory on HTTP port 8080 is as simple as invoking:

```

$ go run github.com/eliben/static-server@latest

 Serving directory "." on http://127.0.0.1:8080

```

If you want to install `static-server` locally first, you can run:

```

$ go install github.com/eliben/static-server@latest

```

And then invoke `static-server` as needed. Command-line flags can be used to

configure the behavior of the server:

```

$ static-server -h

Usage: ./static-server [dir]

  [dir] is optional; if not passed, '.' is used.

  By default, the server listens on localhost:8080. Both the

  host and the port are configurable with flags. Set the host

  to something else if you want the server to listen on a

  specific network interface. Setting the port to 0 will

  instruct the server to pick a random available port.

  -addr string

    	full address (host:port) to listen on; don't use this if 'port' or 'host' are set (default "localhost:8080")

  -certfile string

    	TLS certificate file to use with -tls (default "cert.pem")

  -cors

    	enable CORS by returning Access-Control-Allow-Origin header

  -host string

    	specific host to listen on (default "localhost")

  -keyfile string

    	TLS key file to use with -tls (default "key.pem")

  -port string

    	port to listen on; if 0, a random available port will be used (default "8080")

  -silent

    	suppress messages from output (reporting only errors)

  -tls

    	enable HTTPS serving with TLS

  -version

    	print version and exit

```