gateway: add configurable response write timeout

CHANGELOG.md

@@ -16,6 +16,8 @@ The following emojis are used to highlight certain changes:
 
 ### Added
 
+- `gateway`: Configurable write timeout [#818](https://github.com/ipfs/boxo/pull/818)
+
 ### Changed
 
 ### Removed

gateway/gateway.go

@@ -48,6 +48,11 @@ type Config struct {
 	// directory listings, DAG previews and errors. These will be displayed to the
 	// right of "About IPFS" and "Install IPFS".
 	Menu []assets.MenuItem
+
+	// ResponseWriteTimeout is the maximum duration the gateway will wait for a
+	// response to be written before returning a 503 Service Unavailable error.
+	// An unset or zero value uses the default timeout. -1 means no timeout.
+	ResponseWriteTimeout time.Duration
 }
 
 // PublicGateway is the specification of an IPFS Public Gateway.

gateway/handler.go

@@ -32,6 +32,8 @@
 var log = logging.Logger("boxo/gateway")
 
 const (
+	defaultResponseTimeout = 30 * time.Second
+
 	ipfsPathPrefix        = "/ipfs/"
 	ipnsPathPrefix        = ipns.NamespacePrefix
 	immutableCacheControl = "public, max-age=29030400, immutable"
@@ -68,7 +70,17 @@
 //
 // [IPFS HTTP Gateway]: https://specs.ipfs.tech/http-gateways/
 func NewHandler(c Config, backend IPFSBackend) http.Handler {
-	return newHandlerWithMetrics(&c, backend)
+	handler := newHandlerWithMetrics(&c, backend)
+
+	timeout := c.ResponseWriteTimeout
+	switch timeout {
+	case 0:
+		timeout = defaultResponseTimeout
+	case -1:
+		return handler
+	}
+
+	return http.TimeoutHandler(handler, timeout, "")
 }
 
 // serveContent replies to the request using the content in the provided Reader