Skip to content
forked from adamyi/v6dns

A DNS Server which lets IPv4-prioritized devices to use IPv6 first, or lets IPv6-prioritized devices to use IPv4 first.

License

Notifications You must be signed in to change notification settings

GJSmith3rd/v6dns

 
 

Repository files navigation

V6DNS

EXPERIMENTAL only

For original development version see:

https://github.com/adamyi/v6dns

A DNS Server which lets IPv4-prioritized devices to use IPv6 first, or lets IPv6-prioritized devices to use IPv4 first.

Installation

Run the following command:


### Usage

v6dns [host] [port] [server] [serverport] [priority]

The command above will run a DNS relay listening on host:port, forwarding to server:serverport and treating queries specially as mentioned below.

By default, the address is 127.0.0.1, the port is 53, and the server is 8.8.8.8, port of which is also 53. Configuration file can be used to change that default settings as well. For details on that, please see the next section.

Here the priority can only be 4 or 6, standing for IPv4 or IPv6. Do not use words like "IPv4", "IPv6", "ipv4", "ipv6", et cetera in configuration. Just use 4 or 6~

It works better with cache. (e.g. using dnsmasq to forward again)

### Configuration
The configuration file is at /etc/v6dns.yaml

Here's a sample configuration:

v6dns Configuration

The location of this file should be /etc/v6dns.yaml

host: 127.0.0.1 port: 53 server: 8.8.8.8 serverport: 53 priority: 6


### Procedure

Here's how it works (when IPv6 is set as priority. IPv4 is similar):

 * If it's a type A query, send an AAAA query to upstream DNS server
 * If there's an AAAA record, forward it to client; if not, send the A query
 * For other types of queries, redirect to upstream DNS server as well
 * Send the result to client

### License

[MIT](LICENSE)

About

A DNS Server which lets IPv4-prioritized devices to use IPv6 first, or lets IPv6-prioritized devices to use IPv4 first.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 56.6%
  • HTML 25.7%
  • CSS 17.7%