Server Configuration

Attributes

port = 3000              # Server port (default: 3000)
host = "0.0.0.0"         # Bind address (default: "0.0.0.0")

setPort(nValue)

Set the server port.

setPort(8080)

setHost(cValue)

Set the bind address.

setHost("127.0.0.1")

setTimeout(nMs)

Set request timeout in milliseconds.

setTimeout(30000)  # 30 seconds

Default: 30,000ms (30 seconds)

setBodyLimit(nBytes)

Set maximum request body size in bytes.

setBodyLimit(50 * 1024 * 1024)  # 50MB

Default: 52,428,800 bytes (50MB)

setSessionCapacity(nMaxEntries)

Set maximum number of session entries.

setSessionCapacity(50000)  # 50,000 entries

Default: 10,000 entries

setSessionTTL(nSeconds)

Set session time-to-live in seconds.

setSessionTTL(3600)  # 1 hour

Default: 300 seconds (5 minutes)

setCacheCapacity(nCapacity)

Set maximum number of cache entries.

setCacheCapacity(50000)  # 50,000 entries

Default: 10,000 entries

setCacheTTL(nSeconds)

Set default cache time-to-live in seconds.

setCacheTTL(600)  # 10 minutes

Default: 300 seconds (5 minutes)

enableTls(cCertPath, cKeyPath)

Enable HTTPS with TLS certificates.

enableTls("cert.pem", "key.pem")

enableCompression() / disableCompression()

Enable or disable response compression (brotli/gzip).

enableCompression()

enableLogging() / disableLogging()

Enable or disable request logging.

enableLogging()

setMultipartFieldCountLimit(nMaxFields)

Set maximum number of multipart form fields.

setMultipartFieldCountLimit(100)  # Max 100 fields

Default: 1000 fields

setMultipartFieldSizeLimit(nBytes)

Set maximum size per multipart form field in bytes.

setMultipartFieldSizeLimit(5 * 1024 * 1024)  # 5MB per field

Default: 10MB

ipWhitelist(cIp) / ipBlacklist(cIp)

Add an IP address (or CIDR range) to the whitelist or blacklist.

ipWhitelist("192.168.1.0/24")
ipBlacklist("10.0.0.5")

proxyWhitelist(cIp)

Add a trusted proxy IP. Requests from these IPs will use X-Forwarded-For / X-Real-IP headers for client IP resolution.

proxyWhitelist("10.0.0.1")

setWsMaxConnections(nMax)

Set maximum total concurrent WebSocket connections.

setWsMaxConnections(500)  # Max 500 total connections

Default: 1000

setWsMaxPerIp(nMax)

Set maximum WebSocket connections per client IP.

setWsMaxPerIp(5)  # Max 5 connections per IP

Default: 10

setWsMessageRateLimit(nRate)

Set per-client WebSocket message rate limit in messages per second. Set to 0 to disable.

setWsMessageRateLimit(50)  # Max 50 messages/sec per client

Default: 100

forceSecureCookies()

Force the Secure flag on session cookies even when TLS is not enabled. Useful when running behind a TLS-terminating proxy.

forceSecureCookies()