HTTP/2 サーバー

HTTP/2 はリクエスト多重化、header 圧縮、server push によりレイテンシーを改善します。 Go の HTTP サーバーは TLS 上で HTTP/2 を自動的にネゴシエートするため、Echo で HTTP/2 を配信するには 証明書付きでサーバーを起動すれば済みます。

1. 自己署名 X.509 TLS 証明書を生成する

次のコマンドで cert.pem と key.pem を生成します。

go run $GOROOT/src/crypto/tls/generate_cert.go --host localhost

ノート

デモ目的のため、自己署名証明書を使います。本番では certificate authority から証明書を取得してください。

2. リクエスト情報を echo するハンドラを作成する

e.GET("/request", func(c *echo.Context) error {
  req := c.Request()
  format := `
    <code>
      Protocol: %s<br>
      Host: %s<br>
      Remote Address: %s<br>
      Method: %s<br>
      Path: %s<br>
    </code>
  `
  return c.HTML(http.StatusOK, fmt.Sprintf(format, req.Proto, req.Host, req.RemoteAddr, req.Method, req.URL.Path))
})

3. TLS サーバーを起動する

生成した証明書と key でサーバーを起動します。

sc := echo.StartConfig{Address: ":1323"}
if err := sc.StartTLS(context.Background(), e, "cert.pem", "key.pem"); err != nil {
  e.Logger.Error("failed to start server", "error", err)
}

または、独自の tls.Config を持つカスタム http.Server を使います。

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)
}

4. 検証する

サーバーを起動して https://localhost:1323/request にアクセスします。次のような出力が表示されます。

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

ソースコード

package main

import (
  "context"
  "fmt"
  "net/http"

  "github.com/labstack/echo/v5"
)

func main() {
  e := echo.New()
  e.GET("/request", func(c *echo.Context) error {
    req := c.Request()
    format := `
      <code>
        Protocol: %s<br>
        Host: %s<br>
        Remote Address: %s<br>
        Method: %s<br>
        Path: %s<br>
      </code>
    `
    return c.HTML(http.StatusOK, fmt.Sprintf(format, req.Proto, req.Host, req.RemoteAddr, req.Method, req.URL.Path))
  })
  sc := echo.StartConfig{Address: ":1323"}
  if err := sc.StartTLS(context.Background(), e, "cert.pem", "key.pem"); err != nil {
    e.Logger.Error("failed to start server", "error", err)
  }
}