Skip to content
/ v6dns Public

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

adamyi/v6dns

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

v6dns

NPM version David deps Known Vulnerabilities npm download

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:

npm -g install v6dns

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

About

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

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published