dns2socks 0.2.3

Convert DNS requests to SOCKS5 proxy.
Documentation
mod android;
mod api;
mod config;
mod dns;
mod dump_logger;

use hickory_proto::op::{Message, Query};
use moka::future::Cache;
use socks5_impl::{
    Error, Result, client,
    protocol::{Address, UserKey},
};
use std::{net::SocketAddr, sync::Arc, time::Duration};
use tokio::{
    io::{AsyncReadExt, AsyncWriteExt, BufStream},
    net::{TcpListener, TcpStream, ToSocketAddrs, UdpSocket},
};

pub use ::tokio_util::sync::CancellationToken;
pub use api::{dns2socks_start, dns2socks_stop};
pub use config::{ArgProxy, ArgVerbosity, Config, ProxyType};
pub use dump_logger::dns2socks_set_log_callback;

pub const LIB_NAME: &str = "dns2socks_core";

const MAX_BUFFER_SIZE: usize = 4096;

pub async fn main_entry(config: Config, shutdown_token: tokio_util::sync::CancellationToken) -> Result<()> {
    log::info!("Starting DNS2Socks listening on {}...", config.listen_addr);
    let user_key = config.socks5_settings.credentials.clone();

    let timeout = Duration::from_secs(config.timeout);

    let cache = create_dns_cache();

    fn handle_error(res: Result<Result<(), Error>, tokio::task::JoinError>, protocol: &str) {
        match res {
            Ok(Err(e)) => log::error!("{} error \"{}\"", protocol, e),
            Err(e) => log::error!("{} error \"{}\"", protocol, e),
            _ => {}
        }
    }

    tokio::select! {
        _ = shutdown_token.cancelled() => {
            log::info!("Shutdown received");
        },
        res = tokio::spawn(udp_thread(config.clone(), user_key.clone(), cache.clone(), timeout)) => {
            handle_error(res, "UDP");
        },
        res = tokio::spawn(tcp_thread(config, user_key, cache, timeout)) => {
            handle_error(res, "TCP");
        },
    }

    log::info!("DNS2Socks stopped");

    Ok(())
}

pub(crate) async fn udp_thread(opt: Config, user_key: Option<UserKey>, cache: Cache<Vec<Query>, Message>, timeout: Duration) -> Result<()> {
    let listener = match UdpSocket::bind(&opt.listen_addr).await {
        Ok(listener) => listener,
        Err(e) => {
            log::error!("UDP listener {} error \"{}\"", opt.listen_addr, e);
            return Err(e.into());
        }
    };
    let listener = Arc::new(listener);
    log::info!("Udp listening on: {}", opt.listen_addr);

    loop {
        let listener = listener.clone();
        let opt = opt.clone();
        let cache = cache.clone();
        let auth = user_key.clone();
        let block = async move {
            let mut buf = vec![0u8; MAX_BUFFER_SIZE];
            let (len, src) = listener.recv_from(&mut buf).await?;
            buf.resize(len, 0);
            tokio::spawn(async move {
                if let Err(e) = udp_incoming_handler(listener, buf, src, opt, cache, auth, timeout).await {
                    log::error!("DNS query via UDP incoming handler error \"{}\"", e);
                }
            });
            Ok::<(), Error>(())
        };
        if let Err(e) = block.await {
            log::error!("UDP listener error \"{}\"", e);
        }
    }
}

async fn udp_incoming_handler(
    listener: Arc<UdpSocket>,
    mut buf: Vec<u8>,
    src: SocketAddr,
    opt: Config,
    cache: Cache<Vec<Query>, Message>,
    auth: Option<UserKey>,
    timeout: Duration,
) -> Result<()> {
    let message = dns::parse_data_to_dns_message(&buf, false)?;
    let domain = dns::extract_domain_from_dns_message(&message)?;

    if opt.cache_records
        && let Some(cached_message) = dns_cache_get_message(&cache, &message).await
    {
        let data = cached_message.to_vec().map_err(|e| e.to_string())?;
        listener.send_to(&data, &src).await?;
        log_dns_message("DNS query via UDP cache hit", &domain, &cached_message);
        return Ok(());
    }

    let proxy_addr = opt.socks5_settings.addr;
    let dest_addr = opt.dns_remote_server;

    let data = if opt.force_tcp {
        let mut new_buf = (buf.len() as u16).to_be_bytes().to_vec();
        new_buf.append(&mut buf);
        tcp_via_socks5_server(proxy_addr, dest_addr, auth, &new_buf, timeout)
            .await
            .map_err(|e| format!("querying \"{domain}\" {e}"))?
    } else {
        client::UdpClientImpl::datagram(proxy_addr, dest_addr, auth)
            .await
            .map_err(|e| format!("preparing to query \"{domain}\" {e}"))?
            .transfer_data(&buf, timeout)
            .await
            .map_err(|e| format!("querying \"{domain}\" {e}"))?
    };
    let message = dns::parse_data_to_dns_message(&data, opt.force_tcp)?;
    let msg_buf = message.to_vec().map_err(|e| e.to_string())?;

    listener.send_to(&msg_buf, &src).await?;

    let prefix = format!("DNS query via {}", if opt.force_tcp { "TCP" } else { "UDP" });
    log_dns_message(&prefix, &domain, &message);
    if opt.cache_records {
        dns_cache_put_message(&cache, &message).await;
    }
    Ok::<(), Error>(())
}

pub(crate) async fn tcp_thread(opt: Config, user_key: Option<UserKey>, cache: Cache<Vec<Query>, Message>, timeout: Duration) -> Result<()> {
    let listener = match TcpListener::bind(&opt.listen_addr).await {
        Ok(listener) => listener,
        Err(e) => {
            log::error!("TCP listener {} error \"{}\"", opt.listen_addr, e);
            return Err(e.into());
        }
    };
    log::info!("TCP listening on: {}", opt.listen_addr);

    while let Ok((mut incoming, _)) = listener.accept().await {
        let opt = opt.clone();
        let user_key = user_key.clone();
        let cache = cache.clone();
        tokio::spawn(async move {
            if let Err(e) = handle_tcp_incoming(&opt, user_key, cache, &mut incoming, timeout).await {
                log::error!("TCP error \"{}\"", e);
            }
        });
    }
    Ok(())
}

async fn handle_tcp_incoming(
    opt: &Config,
    auth: Option<UserKey>,
    cache: Cache<Vec<Query>, Message>,
    incoming: &mut TcpStream,
    timeout: Duration,
) -> Result<()> {
    let mut buf = [0u8; MAX_BUFFER_SIZE];
    let n = tokio::time::timeout(timeout, incoming.read(&mut buf)).await??;

    let message = dns::parse_data_to_dns_message(&buf[..n], true)?;
    let domain = dns::extract_domain_from_dns_message(&message)?;

    if opt.cache_records
        && let Some(cached_message) = dns_cache_get_message(&cache, &message).await
    {
        let data = cached_message.to_vec().map_err(|e| e.to_string())?;
        let len = u16::try_from(data.len()).map_err(|e| e.to_string())?.to_be_bytes().to_vec();
        let data = [len, data].concat();
        incoming.write_all(&data).await?;
        log_dns_message("DNS query via TCP cache hit", &domain, &cached_message);
        return Ok(());
    }

    let proxy_addr = opt.socks5_settings.addr;
    let target_server = opt.dns_remote_server;
    let response_buf = tcp_via_socks5_server(proxy_addr, target_server, auth, &buf[..n], timeout).await?;

    incoming.write_all(&response_buf).await?;

    let message = dns::parse_data_to_dns_message(&response_buf, true)?;
    log_dns_message("DNS query via TCP", &domain, &message);

    if opt.cache_records {
        dns_cache_put_message(&cache, &message).await;
    }

    Ok(())
}

async fn tcp_via_socks5_server<A, B>(
    proxy_addr: A,
    target_server: B,
    auth: Option<UserKey>,
    buf: &[u8],
    timeout: Duration,
) -> Result<Vec<u8>>
where
    A: ToSocketAddrs,
    B: Into<Address>,
{
    let s5_proxy = TcpStream::connect(proxy_addr).await?;
    let mut stream = BufStream::new(s5_proxy);
    let _addr = client::connect(&mut stream, target_server, auth).await?;

    stream.write_all(buf).await?;
    stream.flush().await?;

    let mut buf = vec![0; MAX_BUFFER_SIZE];
    let n = tokio::time::timeout(timeout, stream.read(&mut buf)).await??;
    Ok(buf[..n].to_vec())
}

fn log_dns_message(prefix: &str, domain: &str, message: &Message) {
    let ipaddr = match dns::extract_ipaddr_from_dns_message(message) {
        Ok(ipaddr) => {
            format!("{:?}", ipaddr)
        }
        Err(e) => e.to_string(),
    };
    log::trace!("{} {:?} <==> {:?}", prefix, domain, ipaddr);
}

pub(crate) fn create_dns_cache() -> Cache<Vec<Query>, Message> {
    Cache::builder()
        .time_to_live(Duration::from_secs(30 * 60))
        .time_to_idle(Duration::from_secs(5 * 60))
        .build()
}

pub(crate) async fn dns_cache_get_message(cache: &Cache<Vec<Query>, Message>, message: &Message) -> Option<Message> {
    if let Some(mut cached_message) = cache.get(&message.queries().to_vec()).await {
        cached_message.set_id(message.id());
        return Some(cached_message);
    }
    None
}

pub(crate) async fn dns_cache_put_message(cache: &Cache<Vec<Query>, Message>, message: &Message) {
    cache.insert(message.queries().to_vec(), message.clone()).await;
}