caddy-handler-plugin

Build go-plugin for caddy handler

Usage

Create handler plugin

hanlder.go

package main

import (
    "fmt"
    "net/http"

    "github.com/hashicorp/go-hclog"

    "github.com/gsmlg-dev/caddy-handler-plugin/shared"
    "github.com/gsmlg-dev/caddy-handler-plugin/server"
)

type HandlerServer struct {
  logger hclog.Logger
  server.HandlerServerDefault
}

func (g *HandlerServer) Serve(q shared.PluginQuery, reply *shared.PluginReply) error {
  reply.Done = true
  header := http.Header{}
  header.Set("Server-Handler", "Custom Caddy Handler")
  header.Set("Content-Type", "text/plain")
  reply.Header = header
  out := fmt.Sprintf(`Hello World

  * with Query:

  %v

  * with Config:

  %v
`, q, g.Config)
  reply.Body = []byte(out)
  return nil
}

func main() {
  logger := hclog.New(&hclog.LoggerOptions{
		Level:      hclog.Trace,
		Output:     os.Stderr,
		JSONFormat: true,
	})
  handler := &HandlerServer{
    logger: logger,
  }
  server.New(handler)
}

# Build Plugin
go build -o hanlder.bin hanlder.go

Built Caddy with caddy-handler-plugin

xcaddy build --with github.com/gsmlg-dev/caddy-handler-plugin

Load plugin in Caddyfile

localhost:8080 {
    handler_plugin * "/caddy-plugins/hanlder.bin" {
        name "web handler"
        pass_next_if_not_match false
    }
}

Examples

• Embed Static files to Go
• Inject OAuth2 Token

TODO

• Add logger