homeio

1import type { Server as HttpServer } from "node:http";
2
3/**
4 * How long nginx keeps an idle connection to Homeio open before reusing or
5 * dropping it. The installer writes it into the upstream block
6 * (`keepalive_timeout`); 60s is also nginx's default.
7 */
8export const NGINX_UPSTREAM_KEEPALIVE_MS = 60_000;
9
10/**
11 * Connections waiting to be accepted while the event loop is busy. Node's
12 * default of 511 overflowed under load (thousands of drops a minute, each a
13 * 502); the kernel caps it at net.core.somaxconn, 4096 on current distributions.
14 */
15export const LISTEN_BACKLOG = 4096;
16
17/**
18 * Node closes idle keep-alive sockets after 5s by default, but nginx reuses
19 * them for up to a minute. Under load nginx then sends a request on a socket
20 * Node is closing, and the visitor gets a 502 ("Connection reset by peer").
21 * The side that closes idle connections must be the proxy: Node keeps them a
22 * little longer than nginx does.
23 */
24export function configureUpstreamKeepAlive(
25  server: Pick<HttpServer, "keepAliveTimeout" | "headersTimeout">,
26) {
27  server.keepAliveTimeout = NGINX_UPSTREAM_KEEPALIVE_MS + 5_000;
28  // Node requires the header timeout to outlast the keep-alive timeout, or it
29  // can drop a reused socket while the next request's headers arrive.
30  server.headersTimeout = server.keepAliveTimeout + 1_000;
31}
32