Skip to main content

A DNS forwarder using Shadowsocks as the server

Project description

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:

Name

Explanation

server

the address your server listens

server_port

server port

local_address

the address your local listens

password

password used for encryption

method

encryption method, “aes-256-cfb” is recommended

dns

DNS 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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

shadowdns-0.1.3.tar.gz (5.2 kB view details)

Uploaded Source

File details

Details for the file shadowdns-0.1.3.tar.gz.

File metadata

  • Download URL: shadowdns-0.1.3.tar.gz
  • Upload date:
  • Size: 5.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for shadowdns-0.1.3.tar.gz
Algorithm Hash digest
SHA256 1a4d9e71734077a66b162c2206a875a771336e4fe75584a5f15c6c6648630f38
MD5 0747e3f62d41957e0280296ab9288a76
BLAKE2b-256 669d34b1e31f8d88cab756d6cbdf5211f5554d1b1ce0ff1a2eb89a2b4c4a82ea

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page