path: root/src/main.rs

/*
    This file is part of gnix (https://codeberg.org/metamuffin/gnix)
    which is licensed under the GNU Affero General Public License (version 3); see /COPYING.
    Copyright (C) 2025 metamuffin <metamuffin.org>
*/
#![feature(
    try_trait_v2,
    slice_split_once,
    iterator_try_collect,
    never_type,
    string_from_utf8_lossy_owned
)]

pub mod certs;
pub mod config;
pub mod control_socket;
pub mod deser_helpers;
pub mod error;
pub mod generation;
pub mod h3_support;
pub mod modules;

use crate::{
    config::ConfigPackage,
    control_socket::{cs_client_reload, serve_control_socket},
    generation::Generation,
};
use aes_gcm_siv::{aead::generic_array::GenericArray, Aes256GcmSiv, KeyInit};
use anyhow::{anyhow, Context, Result};
use bytes::Bytes;
use clap::Parser;
use error::ServiceError;
use futures::future::try_join_all;
use h3::server::RequestStream;
use h3_quinn::SendStream;
use h3_support::H3RequestBody;
use http::header::{CONTENT_LENGTH, TRANSFER_ENCODING};
use http_body_util::{combinators::BoxBody, BodyExt};
use hyper::{
    body::Incoming,
    header::{CONTENT_TYPE, HOST, SERVER},
    http::HeaderValue,
    service::service_fn,
    Request, Response, Uri,
};
use hyper_util::rt::{TokioExecutor, TokioIo};
use log::{debug, error, info, warn, LevelFilter};
use modules::NodeContext;
use std::{
    net::{IpAddr, SocketAddr},
    path::PathBuf,
    process::exit,
    str::FromStr,
    sync::Arc,
};
use tokio::{
    net::TcpListener,
    signal::ctrl_c,
    spawn,
    sync::{RwLock, Semaphore},
};

pub struct State {
    pub crypto_key: Aes256GcmSiv,
    pub generation: RwLock<Arc<Generation>>,
    pub l_incoming: Semaphore,
    pub l_outgoing: Semaphore,
    pub l_incoming_h3: Semaphore,
    pub quic_endpoints: RwLock<Vec<quinn::Endpoint>>,
}

#[derive(Parser)]
struct Args {
    #[arg(long)]
    setuid: Option<String>,
    #[arg(long)]
    control_socket: Option<PathBuf>,
    #[arg(short, long)]
    watch: bool,
    #[arg(short, long)]
    reload: bool,
    /// YAML config file
    config: PathBuf,
}

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let args = Args::parse();

    env_logger::Builder::new()
        .filter_level(LevelFilter::Info)
        .parse_env("LOG")
        .init();

    rustls::crypto::ring::default_provider()
        .install_default()
        .unwrap();

    let config_package = ConfigPackage::new(&args.config)?;

    if args.reload {
        let cs_path = args
            .control_socket
            .ok_or(anyhow!("reload needs control socket path"))?;
        match cs_client_reload(&cs_path, config_package).await {
            Ok(()) => {
                exit(0);
            }
            Err(e) => {
                eprintln!("Error: {e}");
                exit(1);
            }
        }
    }

    let generation = Generation::new(config_package)?;
    let state = Arc::new(State {
        crypto_key: aes_gcm_siv::Aes256GcmSiv::new(GenericArray::from_slice(
            &generation.config.private_key,
        )),
        quic_endpoints: RwLock::new(Vec::new()),
        l_incoming: Semaphore::new(generation.config.limits.max_incoming_connections),
        l_incoming_h3: Semaphore::new(generation.config.limits.max_incoming_connections_h3),
        l_outgoing: Semaphore::new(generation.config.limits.max_outgoing_connections),
        generation: RwLock::new(Arc::new(generation)),
    });

    if let Some(path) = args.control_socket {
        let state = state.clone();
        tokio::spawn(async move {
            if let Err(e) = serve_control_socket(state, &path).await {
                error!("{e:?}");
                exit(1)
            }
        });
    }
    {
        let state = state.clone();
        tokio::spawn(async move {
            if let Err(e) = serve_http(state).await {
                error!("{e:?}");
                exit(1)
            }
        });
    }
    {
        let state = state.clone();
        tokio::spawn(async move {
            if let Err(e) = serve_https(state).await {
                error!("{e:?}");
                exit(1)
            }
        });
    }
    {
        let state = state.clone();
        tokio::spawn(async move {
            if let Err(e) = serve_h3(state).await {
                error!("{e:?}");
                exit(1)
            }
        });
    }

    ctrl_c().await.unwrap();
    Ok(())
}

async fn serve_http(state: Arc<State>) -> Result<()> {
    let Some(bind_addrs) = state
        .generation
        .read()
        .await
        .config
        .http
        .as_ref()
        .map(|h| h.bind.clone())
    else {
        return Ok(()); // http disabled
    };

    let listen_futs: Result<Vec<()>> = try_join_all(bind_addrs.iter().map(|e| async {
        let listener = TcpListener::bind(*e).await?;
        let listen_addr = listener.local_addr()?;
        info!(
            "HTTP listener bound to {}/tcp",
            listener.local_addr().unwrap()
        );
        loop {
            let (stream, addr) = listener.accept().await.context("accepting connection")?;
            debug!("connection from {addr}");
            let stream = TokioIo::new(stream);
            let state = state.clone();
            tokio::spawn(
                async move { serve_stream(state, stream, addr, false, listen_addr).await },
            );
        }
    }))
    .await;
    listen_futs?;
    Ok(())
}

async fn serve_https(state: Arc<State>) -> Result<()> {
    let Some(bind_addrs) = state
        .generation
        .read()
        .await
        .config
        .https
        .as_ref()
        .map(|h| h.bind.clone())
    else {
        return Ok(()); // https disabled
    };

    let listen_futs: Result<Vec<()>> = try_join_all(bind_addrs.iter().map(|e| async {
        let listener = TcpListener::bind(*e).await?;
        let listen_addr = listener.local_addr()?;
        info!(
            "HTTPS (h1+h2) listener bound to {}/tcp",
            listener.local_addr().unwrap()
        );
        loop {
            let (stream, addr) = listener.accept().await.context("accepting connection")?;
            let generation = state.generation.read().await.clone();
            let Some(tls_acceptor) = generation.tls_acceptor.clone() else {
                warn!("HTTPS (h1+h2) listener is missing TLS configuration");
                break;
            };
            let state = state.clone();
            tokio::task::spawn(async move {
                debug!("connection from {addr}");
                match tls_acceptor.accept(stream).await {
                    Ok(stream) => {
                        serve_stream(state, TokioIo::new(stream), addr, true, listen_addr).await
                    }
                    Err(e) => warn!("error accepting tls: {e}"),
                };
            });
        }
        info!(
            "HTTPS (h1+h2) listener for {} shutting down",
            listener.local_addr().unwrap()
        );
        Ok(())
    }))
    .await;
    listen_futs?;
    Ok(())
}

pub async fn serve_stream<T: Unpin + Send + 'static + hyper::rt::Read + hyper::rt::Write>(
    state: Arc<State>,
    stream: T,
    addr: SocketAddr,
    secure: bool,
    listen_addr: SocketAddr,
) {
    if let Ok(_semaphore) = state.l_incoming.try_acquire() {
        let builder = hyper_util::server::conn::auto::Builder::new(TokioExecutor::new());
        let conn = builder.serve_connection_with_upgrades(
            stream,
            service_fn(|req| {
                let state = state.clone();
                async move {
                    let req = req.map(|body: Incoming| body.map_err(ServiceError::Hyper).boxed());
                    match service(state, req, addr, secure, listen_addr).await {
                        Ok(r) => Ok(r),
                        Err(ServiceError::Hyper(e)) => Err(e),
                        Err(error) => Ok(error_response(addr, error)),
                    }
                }
            }),
        );
        if let Err(err) = conn.await {
            warn!("error: {:?}", err);
        }
    } else {
        warn!("connection dropped: too many incoming");
    }
}

async fn serve_h3(state: Arc<State>) -> Result<()> {
    let generation = state.generation.read().await.clone();
    let https_config = match &generation.config.https {
        Some(n) => n,
        None => return Ok(()),
    };
    if https_config.disable_h3 {
        return Ok(());
    }
    let bind_addrs = https_config.bind.clone();

    try_join_all(bind_addrs.iter().map(|listen_addr| async {
        let Some(quic_config) = generation.quic_config.clone() else {
            warn!("HTTPS (h3) listener is missing TLS configuration");
            return Ok(());
        };
        let endpoint = quinn::Endpoint::server(quic_config, *listen_addr)?;
        state.quic_endpoints.write().await.push(endpoint.clone());
        let listen_addr = *listen_addr;
        info!("HTTPS (h3) listener bound to {listen_addr}/udp");
        while let Some(conn) = endpoint.accept().await {
            let state = state.clone();
            let generation = generation.clone();
            tokio::spawn(serve_h3_stream(conn, generation, state, listen_addr));
        }
        Ok::<_, anyhow::Error>(())
    }))
    .await?;
    Ok(())
}

async fn serve_h3_stream(
    conn: quinn::Incoming,
    generation: Arc<Generation>,
    state: Arc<State>,
    listen_addr: SocketAddr,
) {
    let addr = conn.remote_address(); // TODO wait for validatation (or not?)
    debug!("h3 connection attempt from {addr}");
    // TODO move outside of spawn?
    let Ok(_sem) = state.l_incoming_h3.try_acquire() else {
        return conn.refuse();
    };
    let conn = match conn.accept() {
        Ok(conn) => conn,
        Err(e) => return warn!("quic accep failed: {e}"),
    };
    let conn = match conn.await {
        Ok(conn) => conn,
        Err(e) => return warn!("quic connection failed: {e}"),
    };
    let mut conn =
        match h3::server::Connection::<_, Bytes>::new(h3_quinn::Connection::new(conn)).await {
            Ok(conn) => conn,
            Err(e) => return warn!("h3 accept failed {e}"),
        };
    debug!("h3 stream from {addr}");
    let max_par_requests = Semaphore::new(generation.config.limits.max_requests_per_connnection);
    loop {
        match conn.accept().await {
            Ok(Some(x)) => {
                let Ok((req, stream)) = x.resolve_request().await else {
                    warn!("h3 request accept failed");
                    continue;
                };
                let Ok(_sem_req) = max_par_requests.acquire().await else {
                    warn!("h3 par request semasphore closed");
                    return;
                };
                let state = state.clone();
                spawn(async move {
                    let (mut send, recv) = stream.split();
                    let req = req.map(|()| H3RequestBody(recv).boxed());

                    let resp = service(state.clone(), req, addr, true, listen_addr)
                        .await
                        .unwrap_or_else(|error| error_response(addr, error));

                    send_h3_response(resp, &mut send).await;
                });
                drop(_sem_req)
            }
            Ok(None) => break,
            Err(e) => {
                warn!("h3 connection error: {e}");
                break;
            }
        }
    }
    drop(_sem);
}

async fn send_h3_response(
    resp: Response<BoxBody<Bytes, ServiceError>>,
    send: &mut RequestStream<SendStream<Bytes>, Bytes>,
) {
    let (parts, mut body) = resp.into_parts();
    let mut resp = Response::from_parts(parts, ());

    resp.headers_mut().remove(TRANSFER_ENCODING); // TODO allow "trailers" options
    resp.headers_mut().remove(CONTENT_LENGTH);

    if let Err(e) = send.send_response(resp).await {
        debug!("h3 response send error: {e}");
        return;
    };
    while let Some(frame) = body.frame().await {
        match frame {
            Ok(frame) => {
                if frame.is_data() {
                    let data = frame.into_data().unwrap();
                    if let Err(e) = send.send_data(data).await {
                        debug!("h3 body send error: {e}");
                        return;
                    }
                } else if frame.is_trailers() {
                    let trailers = frame.into_trailers().unwrap();
                    if let Err(e) = send.send_trailers(trailers).await {
                        debug!("h3 trailers send error: {e}");
                        return;
                    }
                }
            }
            Err(_) => todo!(),
        }
    }
    if let Err(e) = send.finish().await {
        debug!("h3 response finish error: {e}");
    }
}

fn error_response(addr: SocketAddr, error: ServiceError) -> Response<BoxBody<Bytes, ServiceError>> {
    {
        warn!("service error {addr} {error:?}");
        let mut resp = Response::new(format!(
            "Sorry, we were unable to process your request: {error}"
        ));
        *resp.status_mut() = error.status_code();
        resp.headers_mut()
            .insert(CONTENT_TYPE, HeaderValue::from_static("text/plain"));
        resp.headers_mut()
            .insert(SERVER, HeaderValue::from_static("gnix"));
        resp
    }
    .map(|b| b.map_err(|e| match e {}).boxed())
}

async fn service(
    state: Arc<State>,
    mut request: Request<BoxBody<Bytes, ServiceError>>,
    mut addr: SocketAddr,
    secure: bool,
    listen_addr: SocketAddr,
) -> Result<hyper::Response<BoxBody<bytes::Bytes, ServiceError>>, ServiceError> {
    let generation = state.generation.read().await.clone();
    // move uri authority used in HTTP/2 to Host header field
    {
        let uri = request.uri_mut();
        if let Some(authority) = uri.authority() {
            let host =
                HeaderValue::from_str(authority.host()).map_err(|_| ServiceError::InvalidUri)?;

            let mut new_uri = http::uri::Parts::default();
            new_uri.path_and_query = uri.path_and_query().cloned();
            *uri = Uri::from_parts(new_uri).map_err(|_| ServiceError::InvalidUri)?;
            request.headers_mut().insert(HOST, host);
        }
    }

    if generation.config.source_ip_from_header {
        if let Some(x) = request.headers_mut().remove("x-real-ip") {
            addr = SocketAddr::new(
                IpAddr::from_str(x.to_str()?).map_err(|_| ServiceError::InvalidHeader)?,
                0,
            );
        } else {
            return Err(ServiceError::XRealIPMissing);
        }
    }

    debug!(
        "{addr} ~> {:?} {}",
        request.headers().get(HOST),
        request.uri()
    );

    let mut context = NodeContext {
        addr,
        state,
        secure,
        listen_addr,
    };
    let mut resp = generation.handler.handle(&mut context, request).await?;

    if !generation.config.disable_server_header {
        let server_header = resp.headers().get(SERVER).cloned();
        resp.headers_mut().insert(
            SERVER,
            if let Some(o) = server_header {
                HeaderValue::from_str(&format!(
                    "{} via gnix",
                    o.to_str().ok().unwrap_or("invalid")
                ))
                .unwrap()
            } else {
                HeaderValue::from_static("gnix")
            },
        );
    }

    Ok(resp)
}