Module server

Available on crate feature server only.

A fully-fledged iroh-relay server over HTTP or HTTPS.

This module provides an API to run a full fledged iroh-relay server. It is primarily used by the iroh-relay binary in this crate. It can be used to run a relay server in other locations however.

This code is fully written in a form of structured-concurrency: every spawned task is always attached to a handle and when the handle is dropped the tasks abort. So tasks can not outlive their handle. It is also always possible to await for completion of a task. Some tasks additionally have a method to do graceful shutdown.

The relay server hosts the following services:

• HTTPS /relay: The main URL endpoint to which clients connect and sends traffic over.
• HTTPS /ping: Used for net_report probes.
• HTTPS /generate_204: Used for net_report probes.
• STUN: UDP port for STUN requests/responses.

Modules

• testingtest-utils
  Exposes functions to quickly configure a server suitable for testing.

Structs

• ClientRateLimit
  Per-client rate limit configuration.
• Limits
  Rate limits.
• Metrics
  Metrics tracked for the relay server
• QuicConfig
  Configuration for the QUIC server.
• RelayConfig
  Configuration for the Relay HTTP and HTTPS server.
• RelayMetrics
  All metrics tracked in the relay server.
• ReloadingResolver
  A Certificate resolver that reloads the certificate every interval
• Server
  A running Relay + STUN server.
• ServerConfig
  Configuration for the full Relay & STUN server.
• StunConfig
  Configuration for the STUN server.
• StunMetrics
  Metrics tracked for the STUN server.
• TlsConfig
  TLS configuration for Relay server.

Enums

• Access
  Access restriction for a node.
• AccessConfig
  Controls which nodes are allowed to use the relay.
• CertConfig
  TLS certificate configuration.

Constants

• DEFAULT_CERT_RELOAD_INTERVAL
  The default certificate reload interval.