Skip to content

Latest commit

 

History

History
32 lines (19 loc) · 1.52 KB

README.md

File metadata and controls

32 lines (19 loc) · 1.52 KB

freedns-go

Optimized DNS Server for Chinese users.

freedns-go is CDN friendly since it prefers the domestic DNS upstream for websites having servers in mainland China.

Usage

Download the prebuilt binary from the releases page. Use -f 114.114.114.114:53 to set the upstream in China, and use -c 8.8.8.8:53 to set the upstream that returns usable results for foreign sites.

sudo ./freedns-go -f 114.114.114.114:53 -c 8.8.8.8:53 -l 0.0.0.0:53

Issue a request to the server just started:

host baidu.com 127.0.0.1
host google.com 127.0.0.1

baidu.com is dispatched to 114.114.114.114, but google.com is dispatched to 8.8.8.8 because its server is not located in China.

How does it work?

freedns-go tries to dispatch the request to a DNS upstream located in China, which is fast but maybe poisoned. If it detected any IP addresses not belonged to China, which means there is a chance that the domain is spoofed, then freedns-go uses the foreign upstream.

The cache policy is lazy cache. If there are some records are expired but in the cache, it will return the cached records and update it on the background.

Note: freedns-go just dispatches your queries to the optimal upstreams. Your network should be able to reach those upstreams (e.g. 8.8.8.8). You can do that by port forwarding, or any ways you like..