//! Example to serve files from a directory. //! //! Run: //! ```text //! $ RUST_LOG=debug cargo run --example server ./ //! ``` //! //! and in another terminal you can run the client example: //! //! Run: //! ```test //! $ cargo run --example client https://localhost:4433/Cargo.toml //! ``` //! //! The output will be the source code of the Cargo.toml file. use std::{ ascii, fs, io, net::SocketAddr, path::{self, Path, PathBuf}, str, sync::Arc, }; use anyhow::{anyhow, bail, Context, Result}; use futures::{StreamExt, TryFutureExt}; use structopt::{self, StructOpt}; use tracing::{error, info, info_span}; use tracing_futures::Instrument as _; mod common; #[derive(StructOpt, Debug)] #[structopt(name = "server")] struct Opt { /// file to log TLS keys to for debugging #[structopt(long = "keylog")] keylog: bool, /// directory to serve files from #[structopt(parse(from_os_str))] root: PathBuf, /// TLS private key in PEM format #[structopt(parse(from_os_str), short = "k", long = "key", requires = "cert")] key: Option, /// TLS certificate in PEM format #[structopt(parse(from_os_str), short = "c", long = "cert", requires = "key")] cert: Option, /// Enable stateless retries #[structopt(long = "stateless-retry")] stateless_retry: bool, /// Address to listen on #[structopt(long = "listen", default_value = "[::1]:4433")] listen: SocketAddr, } fn main() { tracing::subscriber::set_global_default( tracing_subscriber::FmtSubscriber::builder() .with_env_filter(tracing_subscriber::EnvFilter::from_default_env()) .finish(), ) .unwrap(); let opt = Opt::from_args(); let code = { if let Err(e) = run(opt) { eprintln!("ERROR: {}", e); 1 } else { 0 } }; ::std::process::exit(code); } #[tokio::main] async fn run(options: Opt) -> Result<()> { let mut transport_config = quinn::TransportConfig::default(); transport_config.stream_window_uni(0).unwrap(); let mut server_config = quinn::ServerConfig::default(); server_config.transport = Arc::new(transport_config); let mut server_config = quinn::ServerConfigBuilder::new(server_config); server_config.protocols(common::ALPN_QUIC_HTTP); if options.keylog { server_config.enable_keylog(); } if options.stateless_retry { server_config.use_stateless_retry(true); } if let (Some(key_path), Some(cert_path)) = (&options.key, &options.cert) { let key = fs::read(key_path).context("failed to read private key")?; let key = if key_path.extension().map_or(false, |x| x == "der") { quinn::PrivateKey::from_der(&key)? } else { quinn::PrivateKey::from_pem(&key)? }; let cert_chain = fs::read(cert_path).context("failed to read certificate chain")?; let cert_chain = if cert_path.extension().map_or(false, |x| x == "der") { quinn::CertificateChain::from_certs(quinn::Certificate::from_der(&cert_chain)) } else { quinn::CertificateChain::from_pem(&cert_chain)? }; server_config.certificate(cert_chain, key)?; } else { let dirs = directories_next::ProjectDirs::from("org", "quinn", "quinn-examples").unwrap(); let path = dirs.data_local_dir(); let cert_path = path.join("cert.der"); let key_path = path.join("key.der"); let (cert, key) = match fs::read(&cert_path).and_then(|x| Ok((x, fs::read(&key_path)?))) { Ok(x) => x, Err(ref e) if e.kind() == io::ErrorKind::NotFound => { info!("generating self-signed certificate"); let cert = rcgen::generate_simple_self_signed(vec!["localhost".into()]).unwrap(); let key = cert.serialize_private_key_der(); let cert = cert.serialize_der().unwrap(); fs::create_dir_all(&path).context("failed to create certificate directory")?; fs::write(&cert_path, &cert).context("failed to write certificate")?; fs::write(&key_path, &key).context("failed to write private key")?; (cert, key) } Err(e) => { bail!("failed to read certificate: {}", e); } }; let key = quinn::PrivateKey::from_der(&key)?; let cert = quinn::Certificate::from_der(&cert)?; server_config.certificate(quinn::CertificateChain::from_certs(vec![cert]), key)?; } let mut endpoint = quinn::Endpoint::builder(); endpoint.listen(server_config.build()); let root = Arc::::from(options.root.clone()); if !root.exists() { bail!("root path does not exist"); } let (endpoint, mut incoming) = endpoint.bind(&options.listen)?; info!("listening on {}", endpoint.local_addr()?); drop(endpoint); while let Some(conn) = incoming.next().await { info!("connection incoming"); tokio::spawn( handle_connection(root.clone(), conn).unwrap_or_else(move |e| { error!("connection failed: {reason}", reason = e.to_string()) }), ); } Ok(()) } async fn handle_connection(root: Arc, conn: quinn::Connecting) -> Result<()> { let quinn::NewConnection { connection, mut bi_streams, .. } = conn.await?; let span = info_span!( "connection", remote = %connection.remote_address(), protocol = %connection .handshake_data() .unwrap() .protocol .map_or_else(|| "".into(), |x| String::from_utf8_lossy(&x).into_owned()) ); async { info!("established"); // Each stream initiated by the client constitutes a new request. while let Some(stream) = bi_streams.next().await { let stream = match stream { Err(quinn::ConnectionError::ApplicationClosed { .. }) => { info!("connection closed"); return Ok(()); } Err(e) => { return Err(e); } Ok(s) => s, }; tokio::spawn( handle_request(root.clone(), stream) .unwrap_or_else(move |e| error!("failed: {reason}", reason = e.to_string())) .instrument(info_span!("request")), ); } Ok(()) } .instrument(span) .await?; Ok(()) } async fn handle_request( root: Arc, (mut send, recv): (quinn::SendStream, quinn::RecvStream), ) -> Result<()> { let req = recv .read_to_end(64 * 1024) .await .map_err(|e| anyhow!("failed reading request: {}", e))?; let mut escaped = String::new(); for &x in &req[..] { let part = ascii::escape_default(x).collect::>(); escaped.push_str(str::from_utf8(&part).unwrap()); } info!(content = %escaped); // Execute the request let resp = process_get(&root, &req).unwrap_or_else(|e| { error!("failed: {}", e); format!("failed to process request: {}\n", e) .into_bytes() .into() }); // Write the response send.write_all(&resp) .await .map_err(|e| anyhow!("failed to send response: {}", e))?; // Gracefully terminate the stream send.finish() .await .map_err(|e| anyhow!("failed to shutdown stream: {}", e))?; info!("complete"); Ok(()) } fn process_get(root: &Path, x: &[u8]) -> Result> { if x.len() < 4 || &x[0..4] != b"GET " { bail!("missing GET"); } if x[4..].len() < 2 || &x[x.len() - 2..] != b"\r\n" { bail!("missing \\r\\n"); } let x = &x[4..x.len() - 2]; let end = x.iter().position(|&c| c == b' ').unwrap_or_else(|| x.len()); let path = str::from_utf8(&x[..end]).context("path is malformed UTF-8")?; let path = Path::new(&path); let mut real_path = PathBuf::from(root); let mut components = path.components(); match components.next() { Some(path::Component::RootDir) => {} _ => { bail!("path must be absolute"); } } for c in components { match c { path::Component::Normal(x) => { real_path.push(x); } x => { bail!("illegal component in path: {:?}", x); } } } let data = fs::read(&real_path).context("failed reading file")?; Ok(data.into()) }