bojanz / httpx

Provides an extended, production-ready HTTP server.

httpx

Provides an extended, production-ready HTTP server.

Backstory: https://bojanz.github.io/increasing-http-server-boilerplate-go/

Features

1. Production-ready defaults (TLS, timeouts), following Cloudflare recommendations.
2. Limiter for max simultaneous connections.
3. Support for systemd sockets.

    // Serve r on port 80.
    server := httpx.NewServer(":80", r)
    err := server.Start()
    // Serve r on a systemd socket (FileDescriptorName=myapp-http).
    server := httpx.NewServer("systemd:myapp-http", r)
    err := server.Start()

    cert, err := tls.LoadX509KeyPair("/srv/cert.pem", "/srv/key.pem")
    // Serve r on port 443.
    server := httpx.NewServerTLS(":443", cert, r)
    err := server.Start()
    // Serve r on a systemd TLS socket (FileDescriptorName=myapp-https).
    server := httpx.NewServerTLS("systemd:myapp-https", cert, r)
    err := server.Start()

    // Serve up to 1000 simultaneous connections on port 8080.
    server := httpx.NewServer(":8080", r)
    server.MaxConnections = 1000
    err := server.Start()

Systemd setup

/etc/systemd/system/myapp.service:

[Unit]
Description=MyApp
Requires=myapp-http.socket myapp-https.socket

[Service]
Type=simple
ExecStart=/usr/bin/myapp serve
NonBlocking=true
Restart=always

[Install]
WantedBy=multi-user.target

/etc/systemd/system/myapp-http.socket:

[Unit]
Description=MyApp HTTP socket
PartOf=myapp.service

[Socket]
ListenStream=80
NoDelay=true
Service=myapp.service
FileDescriptorName=myapp-http

[Install]
WantedBy=sockets.target

/etc/systemd/system/myapp-https.socket:

[Unit]
Description=MyApp HTTPS socket
PartOf=myapp.service

[Socket]
ListenStream=443
NoDelay=true
Service=myapp.service
FileDescriptorName=myapp-https

[Install]
WantedBy=sockets.target

Additional resources:

• https://www.darkcoding.net/software/systemd-socket-activation-in-go/
• https://vincent.bernat.ch/en/blog/2018-systemd-golang-socket-activation

Alternatives

• ory/graceful provides production-ready defaults and graceful shutdown.