fileserver

README

go-http/v3/fileserver

There are many Go HTTP file server tools. This one is mine.

Tools

$> make cli
go build -mod vendor -ldflags="-s -w" -o bin/fileserver cmd/fileserver/main.go

fileserver

$> ./bin/fileserver -h
Usage of ./bin/fileserver:
  -cors-origins string
    	A comma-separated of origins to allow CORS requests from. (default "*")
  -enable-cors
    	Enable CORS headers on responses.
  -enable-gzip
    	Enable gzip-ed responses.
  -mimetype value
    	One or more key=value pairs mapping a file extension to a specific content (or mime) type to assign for that request
  -prefix string
    	A prefix to append to URL to serve requests from.
  -root string
    	A valid path to serve files from.
  -server-uri string
    	A valid aaronland/go-http-server URI. Registered schemes are: HTTP,HTTPS,LAMBDA,MKCERT,TLS. (default "http://localhost:8080")

Example

$> make debug
fileserver -root ./www \
	-mimetype js=text/javascript \
	-mimetype wasm=application/wasm \
	-enable-cors
	
2025/02/21 11:30:54 Serving ./www and listening for requests on http://localhost:8080

Documentation

Index

• func NewContentTypeHandler(opts *ContentTypeOptions, next http.Handler) (http.Handler, error)
• func NewFileServerHandler(opts *FileServerOptions) (http.Handler, error)
• func NewWithHeadersHandler(headers map[string]string, next http.Handler) (http.Handler, error)
• type ContentTypeOptions
• type FileServerOptions

Functions

func NewContentTypeHandler

func NewContentTypeHandler(opts *ContentTypeOptions, next http.Handler) (http.Handler, error)

func NewFileServerHandler

func NewFileServerHandler(opts *FileServerOptions) (http.Handler, error)

func NewWithHeadersHandler

func NewWithHeadersHandler(headers map[string]string, next http.Handler) (http.Handler, error)

Types

type ContentTypeOptions

type ContentTypeOptions struct {
	Matches map[string]string
}

type FileServerOptions

type FileServerOptions struct {
	Root        string
	EnableCORS  bool
	CORSOrigins []string
	EnableGzip  bool
}