2f2720802d
The relay now supports loading configuration from a TOML file via --config <path>. CLI flags override TOML values. All fields have serde defaults so a minimal config only needs what you want to change. Example relay.toml: listen_addr = "0.0.0.0:4433" [[peers]] url = "193.180.213.68:4433" fingerprint = "1a:39:38:..." label = "Pangolin EU" Federation hint on startup now shows TOML format with TLS fingerprint (not Ed25519 identity fingerprint), since TLS fingerprint is what peers actually verify. Configured peers are logged on startup. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
95 lines
3.5 KiB
Rust
95 lines
3.5 KiB
Rust
//! Relay daemon configuration.
|
|
|
|
use serde::{Deserialize, Serialize};
|
|
use std::net::SocketAddr;
|
|
|
|
/// A federated peer relay.
|
|
#[derive(Clone, Debug, Serialize, Deserialize)]
|
|
pub struct PeerConfig {
|
|
/// Address of the peer relay (e.g., "193.180.213.68:4433").
|
|
pub url: String,
|
|
/// Expected TLS certificate fingerprint (hex, with colons).
|
|
pub fingerprint: String,
|
|
/// Optional human-readable label.
|
|
#[serde(default)]
|
|
pub label: Option<String>,
|
|
}
|
|
|
|
/// Configuration for the relay daemon.
|
|
///
|
|
/// All fields have defaults, so a minimal TOML file only needs the
|
|
/// fields you want to override (e.g., just `[[peers]]`).
|
|
#[derive(Clone, Debug, Serialize, Deserialize)]
|
|
#[serde(default)]
|
|
pub struct RelayConfig {
|
|
/// Address to listen on for incoming connections (client-facing).
|
|
pub listen_addr: SocketAddr,
|
|
/// Address of the remote relay (for the lossy inter-relay link).
|
|
/// If None, this relay is the destination-side relay.
|
|
pub remote_relay: Option<SocketAddr>,
|
|
/// Maximum concurrent sessions.
|
|
pub max_sessions: usize,
|
|
/// Jitter buffer target depth in packets.
|
|
pub jitter_target_depth: usize,
|
|
/// Jitter buffer maximum depth in packets.
|
|
pub jitter_max_depth: usize,
|
|
/// Logging level (trace, debug, info, warn, error).
|
|
pub log_level: String,
|
|
/// featherChat auth validation URL (e.g., "https://chat.example.com/v1/auth/validate").
|
|
/// If set, clients must present a valid token before joining rooms.
|
|
pub auth_url: Option<String>,
|
|
/// Port for the Prometheus metrics HTTP endpoint (e.g., 9090).
|
|
/// If None, the metrics endpoint is disabled.
|
|
pub metrics_port: Option<u16>,
|
|
/// Peer relay addresses to probe for health monitoring.
|
|
/// Each target gets a persistent QUIC connection sending 1 Ping/s.
|
|
#[serde(default)]
|
|
pub probe_targets: Vec<SocketAddr>,
|
|
/// Enable mesh mode: each relay probes all configured targets concurrently.
|
|
/// Discovery is manual via multiple --probe flags; this flag signals intent.
|
|
#[serde(default)]
|
|
pub probe_mesh: bool,
|
|
/// Enable trunk batching for outgoing media in room mode.
|
|
/// When true, packets destined for the same receiver are accumulated into
|
|
/// [`TrunkFrame`]s and flushed every 5 ms (or when the batcher is full),
|
|
/// reducing per-packet QUIC datagram overhead.
|
|
#[serde(default)]
|
|
pub trunking_enabled: bool,
|
|
/// Port for the WebSocket listener (browser clients connect here).
|
|
/// If None, WebSocket support is disabled.
|
|
pub ws_port: Option<u16>,
|
|
/// Directory to serve static files from (HTML/JS/WASM for web clients).
|
|
pub static_dir: Option<String>,
|
|
/// Federation peer relays.
|
|
#[serde(default)]
|
|
pub peers: Vec<PeerConfig>,
|
|
}
|
|
|
|
impl Default for RelayConfig {
|
|
fn default() -> Self {
|
|
Self {
|
|
listen_addr: "0.0.0.0:4433".parse().unwrap(),
|
|
remote_relay: None,
|
|
max_sessions: 100,
|
|
jitter_target_depth: 50,
|
|
jitter_max_depth: 250,
|
|
log_level: "info".to_string(),
|
|
auth_url: None,
|
|
metrics_port: None,
|
|
probe_targets: Vec::new(),
|
|
probe_mesh: false,
|
|
trunking_enabled: false,
|
|
ws_port: None,
|
|
static_dir: None,
|
|
peers: Vec::new(),
|
|
}
|
|
}
|
|
}
|
|
|
|
/// Load relay configuration from a TOML file.
|
|
pub fn load_config(path: &str) -> Result<RelayConfig, anyhow::Error> {
|
|
let content = std::fs::read_to_string(path)?;
|
|
let config: RelayConfig = toml::from_str(&content)?;
|
|
Ok(config)
|
|
}
|