{"id":13815421,"url":"https://github.com/shadowsocks/ShadowDNS","last_synced_at":"2025-05-15T09:31:45.255Z","repository":{"id":17821435,"uuid":"20721291","full_name":"shadowsocks/ShadowDNS","owner":"shadowsocks","description":"A DNS forwarder using Shadowsocks as the server","archived":false,"fork":false,"pushed_at":"2015-08-31T19:43:41.000Z","size":207,"stargazers_count":334,"open_issues_count":2,"forks_count":413,"subscribers_count":46,"default_branch":"master","last_synced_at":"2024-11-09T01:45:49.590Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/shadowsocks.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-06-11T10:26:53.000Z","updated_at":"2024-11-03T18:10:17.000Z","dependencies_parsed_at":"2022-06-26T03:43:46.590Z","dependency_job_id":null,"html_url":"https://github.com/shadowsocks/ShadowDNS","commit_stats":null,"previous_names":["clowwindy/shadowdns"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shadowsocks%2FShadowDNS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shadowsocks%2FShadowDNS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shadowsocks%2FShadowDNS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shadowsocks%2FShadowDNS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shadowsocks","download_url":"https://codeload.github.com/shadowsocks/ShadowDNS/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225342753,"owners_count":17459461,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-04T04:03:28.854Z","updated_at":"2024-11-19T11:30:25.103Z","avatar_url":"https://github.com/shadowsocks.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"ShadowDNS\n=========\n\n[![PyPI version]][PyPI] [![Build Status]][Travis CI] \n\nA DNS forwarder using [Shadowsocks] as the server.\n\nShadowDNS creates a DNS server at localhost.\n\nExperimental; use with caution.\n\nInstall\n-------\n\n#### OS X:\n\n    brew install swig\n    git clone https://github.com/clowwindy/M2Crypto.git\n    cd M2Crypto\n    pip install .\n    pip install shadowdns\n\n#### Windows:\n\nInstall M2Crypto (Google an M2Crypto Windows installer for your python version\n and install it. Might be complicated, need someone to write a help here).\n\n    easy_install pip\n    pip install shadowdns\n\n#### Debian / Ubuntu:\n\n    apt-get install python-pip python-m2crypto\n    pip install shadowdns\n\n#### CentOS:\n\n    yum install m2crypto python-setuptools\n    easy_install pip\n    pip install shadowdns\n\nUsage\n-----\n\nCreate a config file `/etc/shadowdns.json` (or put it in other path).\nExample:\n\n    {\n        \"server\":\"my_server_ip\",\n        \"server_port\":8388,\n        \"local_address\": \"127.0.0.1\",\n        \"password\":\"mypassword\",\n        \"method\":\"aes-256-cfb\",\n        \"dns\":\"8.8.8.8\"\n    }\n\nExplanation of the fields:\n\n| Name          | Explanation                                     |\n| ------------- | ----------------------------------------------- |\n| server        | the address your server listens                 |\n| server_port   | server port                                     |\n| local_address | the address your local listens                  |\n| password      | password used for encryption                    |\n| method        | encryption method, \"aes-256-cfb\" is recommended |\n| dns           | DNS server to use                               |\n\n\nRun `sudo ssdns -c /etc/shadowdns.json` on your local machine.\n\nSet your DNS to 127.0.0.1.\n\nLicense\n-------\nMIT\n\nBugs and Issues\n----------------\nPlease visit [Issue Tracker]\n\nMailing list: http://groups.google.com/group/shadowsocks\n\n\n[Build Status]:    https://img.shields.io/travis/clowwindy/ShadowDNS/master.svg?style=flat\n[Issue Tracker]:   https://github.com/clowwindy/ShadowDNS/issues?state=open\n[PyPI]:            https://pypi.python.org/pypi/shadowdns\n[PyPI version]:    https://img.shields.io/pypi/v/shadowdns.svg?style=flat\n[Shadowsocks]:     https://github.com/clowwindy/shadowsocks\n[Travis CI]:       https://travis-ci.org/clowwindy/ShadowDNS\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshadowsocks%2FShadowDNS","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshadowsocks%2FShadowDNS","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshadowsocks%2FShadowDNS/lists"}