Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

caddy

package

Go to main page

Versions in this module

v0

v0.3.0

Mar 10, 2026

Changes in this version

+ func BuildExternalHostname(sessionName, serviceName, projectAlias, domain string) string

type RouteHandler

+ Headers *RouteHeaders

+ type RouteHeaderOps struct

+ Set map[string][]string

+ type RouteHeaders struct

+ Request *RouteHeaderOps

v0.2.0

Feb 15, 2026

Changes in this version

+ func BuildHostname(sessionName, serviceName, projectAlias string) string

+ func BuildRouteID(sessionName, serviceName, projectAlias string) string

+ func SyncRoutes(sessions map[string]*SessionInfo) error

+ type CaddyAdmin struct

+ Listen string

+ type CaddyApps struct

+ HTTP CaddyHTTP

+ type CaddyConfig struct

+ Admin CaddyAdmin

+ Apps CaddyApps

+ func BuildCaddyConfig(sessions map[string]*SessionInfo) CaddyConfig

+ type CaddyHTTP struct

+ Servers map[string]CaddyServer

+ type CaddyServer struct

+ Listen []string

+ Routes []Route

v0.1.2

Feb 12, 2026

Changes in this version

type CaddyClient

+ func (c *CaddyClient) EnsureRoutesArray() error

v0.1.1

Oct 23, 2025

v0.1.0

Oct 1, 2025

Changes in this version

+ func DestroySessionRoutes(sessionName string, routes map[string]string) error

+ func GetServiceMapping(portName string) string

+ func NormalizeDNSName(serviceName string) string

+ func ProvisionSessionRoutes(sessionName string, services map[string]int) (map[string]string, error)

+ func ProvisionSessionRoutesWithProject(sessionName string, services map[string]int, projectAlias string) (map[string]string, error)

+ func RepairRoutes(result *HealthCheckResult, sessions map[string]*SessionInfo) error

+ func SanitizeHostname(sessionName string) string

+ type CaddyClient struct

+ func NewCaddyClient() *CaddyClient

+ func (c *CaddyClient) CheckCaddyConnection() error

+ func (c *CaddyClient) CreateRoute(sessionName, serviceName string, port int) (string, error)

+ func (c *CaddyClient) CreateRouteWithProject(sessionName, serviceName string, port int, projectAlias string) (string, error)

+ func (c *CaddyClient) DeleteRoute(routeID string) error

+ func (c *CaddyClient) DeleteSessionRoutes(sessionName string) error

+ func (c *CaddyClient) GetAllRoutes() ([]Route, error)

+ func (c *CaddyClient) ReplaceAllRoutes(routes []Route) error

+ type HealthCheckResult struct

+ CaddyError string

+ CaddyRunning bool

+ CatchAllFirst bool

+ RouteStatuses []RouteStatus

+ RoutesExisting int

+ RoutesNeeded int

+ RoutesWorking int

+ func CheckCaddyHealth(sessions map[string]*SessionInfo) (*HealthCheckResult, error)

+ type Route struct

+ Handle []RouteHandler

+ ID string

+ Match []RouteMatch

+ Terminal bool

+ type RouteHandler struct

+ Handler string

+ Upstreams []RouteUpstream

+ type RouteMatch struct

+ Host []string

+ type RouteResponse struct

+ ETag string

+ type RouteStatus struct

+ Error string

+ Exists bool

+ Hostname string

+ IsFirst bool

+ Port int

+ RouteID string

+ ServiceName string

+ ServiceUp bool

+ SessionName string

+ type RouteUpstream struct

+ Dial string

+ type SessionInfo struct

+ Name string

+ Ports map[string]int

+ ProjectAlias string