• cookbook
• http2-server-push

HTTP/2 Server Push Recipe

Requires go1.8+

How to send web assets using HTTP/2 server push? 🔗

Step 1: Generate a self-signed X.509 TLS certificate 🔗

Step 2: Register a route to serve web assets 🔗

e.Static("/", "static")

Step 3: Create a handler to serve index.html and push it’s dependencies 🔗

e.GET("/", func(c echo.Context) (err error) {
  pusher, ok := c.Response().Writer.(http.Pusher)
  if ok {
    if err = pusher.Push("/app.css", nil); err != nil {
      return
    }
    if err = pusher.Push("/app.js", nil); err != nil {
      return
    }
    if err = pusher.Push("/echo.png", nil); err != nil {
      return
    }
  }
  return c.File("index.html")
})

If http.Pusher is supported, web assets are pushed; otherwise, client makes separate requests to get them.

Step 4: Start TLS server using cert.pem and key.pem 🔗

if err := e.StartTLS(":1323", "cert.pem", "key.pem"); err != http.ErrServerClosed {
  log.Fatal(err)
}

or use customized HTTP server with your own TLSConfig

s := http.Server{
  Addr:    ":8443",
  Handler: e, // set Echo as handler
  TLSConfig: &tls.Config{
    //Certificates: nil, // <-- s.ListenAndServeTLS will populate this field
  },
  //ReadTimeout: 30 * time.Second, // use custom timeouts
}
if err := s.ListenAndServeTLS("cert.pem", "key.pem"); err != http.ErrServerClosed {
  log.Fatal(err)
}

Step 5: Start the server and browse to https://localhost:1323 🔗

Protocol: HTTP/2.0
Host: localhost:1323
Remote Address: [::1]:60288
Method: GET
Path: /

Source Code

index.html

server.go