Home

Awesome

ShadowDNS

PyPI version Build Status

A DNS forwarder using Shadowsocks as the server.

ShadowDNS creates a DNS server at localhost.

Experimental; use with caution.

Install

OS X:

brew install swig
git clone https://github.com/clowwindy/M2Crypto.git
cd M2Crypto
pip install .
pip install shadowdns

Windows:

Install M2Crypto (Google an M2Crypto Windows installer for your python version and install it. Might be complicated, need someone to write a help here).

easy_install pip
pip install shadowdns

Debian / Ubuntu:

apt-get install python-pip python-m2crypto
pip install shadowdns

CentOS:

yum install m2crypto python-setuptools
easy_install pip
pip install shadowdns

Usage

Create a config file /etc/shadowdns.json (or put it in other path). Example:

{
    "server":"my_server_ip",
    "server_port":8388,
    "local_address": "127.0.0.1",
    "password":"mypassword",
    "method":"aes-256-cfb",
    "dns":"8.8.8.8"
}

Explanation of the fields:

NameExplanation
serverthe address your server listens
server_portserver port
local_addressthe address your local listens
passwordpassword used for encryption
methodencryption method, "aes-256-cfb" is recommended
dnsDNS server to use

Run sudo ssdns -c /etc/shadowdns.json on your local machine.

Set your DNS to 127.0.0.1.

License

MIT

Bugs and Issues

Please visit Issue Tracker

Mailing list: http://groups.google.com/group/shadowsocks