armor

README

Armor

Uncomplicated HTTP server, supports HTTP/2 and auto TLS

Armor is written in Go. It is based on the upcoming Echo v3.

What can it do today?

• Serve HTTP/2
• Automatically install TLS certificates from https://letsencrypt.org
• Proxy HTTP and WebSocket requests
• Define virtual hosts with path level routing
• Graceful shutdown
• Limit request body
• Serve static files
• Log requests
• Gzip response
• Cross-origin Resource Sharing (CORS)
• Security
  • XSSProtection
  • ContentTypeNosniff
  • ContentSecurityPolicy
  • HTTP Strict Transport Security (HSTS)
• Add / Remove trailing slash from the URL with option to redirect
• Redirect requests
• http to https
• http to https www
• http to https non www
• non www to www
• www to non www

Most of the functionality is implemented via Plugin interface which makes writing a custom plugin super easy.

Getting Started

What's on the roadmap?

• Website
• Code coverage
• Test cases

Documentation

Index

• Constants
• type Armor
• type Host
• type Path
• type Plugin
• type TLS

Constants

const (
	Version = "0.2.3"
)

Types

type Armor

type Armor struct {
	Address      string           `json:"address"`
	TLS          *TLS             `json:"tls"`
	ReadTimeout  time.Duration    `json:"read_timeout"`
	WriteTimeout time.Duration    `json:"write_timeout"`
	Plugins      []Plugin         `json:"plugins"`
	Hosts        map[string]*Host `json:"hosts"`
	Logger       *log.Logger      `json:"-"`
}

type Host

type Host struct {
	Name     string           `json:"-"`
	CertFile string           `json:"cert_file"`
	KeyFile  string           `json:"key_file"`
	Plugins  []Plugin         `json:"plugins"`
	Paths    map[string]*Path `json:"paths"`
	Echo     *echo.Echo       `json:"-"`
}

type Path

type Path struct {
	Plugins []Plugin `json:"plugins"`
}

type Plugin

type Plugin map[string]interface{}

type TLS

type TLS struct {
	Address   string `json:"address"`
	CertFile  string `json:"cert_file"`
	KeyFile   string `json:"key_file"`
	Auto      bool   `json:"auto"`
	CacheFile string `json:"cache_file"`
}