# dns2socks
[](https://crates.io/crates/dns2socks)

[](https://docs.rs/dns2socks)
[](https://crates.io/crates/dns2socks)
[](https://github.com/ssrlive/dns2socks/blob/master/LICENSE)
A DNS server that forwards DNS requests to a SOCKS5 server.
## Installation
### Precompiled Binaries
Download binary from [releases](https://github.com/ssrlive/dns2socks/releases) and put it in your `$PATH`.
### Install from Crates.io
If you have [Rust](https://rustup.rs/) toolchain installed, you can install `dns2socks` with the following command:
```sh
cargo install dns2socks
```
## Usage
```plaintext
dns2socks -h
Proxy server to routing DNS query to SOCKS5 server
Usage: dns2socks [OPTIONS]
Options:
-l, --listen-addr <IP:port> Listen address [default: 0.0.0.0:53]
-d, --dns-remote-server <IP:port> Remote DNS server address [default: 8.8.8.8:53]
-s, --socks5-settings <URL> SOCKS5 URL in the form socks5://[username[:password]@]host:port, Username and password are encoded in percent
encoding. For example: socks5://myname:pass%40word@127.0.0.1:1080 [default: socks5://127.0.0.1:1080]
-f, --force-tcp Force to use TCP to proxy DNS query
-c, --cache-records Cache DNS query records
-v, --verbosity <level> Verbosity level [default: info] [possible values: off, error, warn, info, debug, trace]
-t, --timeout <seconds> Timeout for DNS query [default: 5]
-h, --help Print help
-V, --version Print version
```