{"id":17172888,"url":"https://github.com/20tab/uwsgi-local-dns-resolver","last_synced_at":"2026-03-07T21:02:15.109Z","repository":{"id":30663841,"uuid":"34219575","full_name":"20tab/uwsgi-local-dns-resolver","owner":"20tab","description":null,"archived":false,"fork":false,"pushed_at":"2022-01-13T08:09:48.000Z","size":24,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-11-28T10:42:09.739Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/20tab.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":"2015-04-19T18:52:04.000Z","updated_at":"2022-01-13T08:09:43.000Z","dependencies_parsed_at":"2022-08-17T17:00:53.981Z","dependency_job_id":null,"html_url":"https://github.com/20tab/uwsgi-local-dns-resolver","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/20tab/uwsgi-local-dns-resolver","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/20tab%2Fuwsgi-local-dns-resolver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/20tab%2Fuwsgi-local-dns-resolver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/20tab%2Fuwsgi-local-dns-resolver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/20tab%2Fuwsgi-local-dns-resolver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/20tab","download_url":"https://codeload.github.com/20tab/uwsgi-local-dns-resolver/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/20tab%2Fuwsgi-local-dns-resolver/sbom","scorecard":{"id":2512,"data":{"date":"2025-08-11","repo":{"name":"github.com/20tab/uwsgi-local-dns-resolver","commit":"e558a230a3e42ee6b077b08cc65c875acb087d4a"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3,"checks":[{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Code-Review","score":0,"reason":"Found 0/14 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 2 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-14T12:53:00.938Z","repository_id":30663841,"created_at":"2025-08-14T12:53:00.938Z","updated_at":"2025-08-14T12:53:00.938Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30231490,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-07T19:01:10.287Z","status":"ssl_error","status_checked_at":"2026-03-07T18:59:58.103Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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-10-14T23:48:38.772Z","updated_at":"2026-03-07T21:02:15.092Z","avatar_url":"https://github.com/20tab.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# uWSGI-local-DNS-resolver\nuWSGI-local-DNS-resolver (from now on __uWSGI-DNS__) is a DNS server that resolves to `localhost` each request directed to a uWSGI-subscribed domain.\n\n# Why?\nOur main intent is to let users transparently connect to their local development instances handled through a uWSGI HTTP subscription server.\n\n## Project status\nuWSGI-DNS is still a work in progress. As a consequence, its APIs could be subject to changes.\n\n## Features\n- Python 2 \u0026 Python 3 compatibility.\n- UNIX/Linux systems compatibility.\n- Automatic domain refresh on new uWSGI subscriptions.\n- Failed nodes detection and handling.\n\n## Installation\nYou can install uwsgi-dns through PIP with:\n```bash\n$ pip install uwsgidns  # you could need to use sudo here, or -U\n```\n\nAlternatively, you can clone the repository manually:\n```bash\n$ git clone https://github.com/20tab/uwsgi-local-dns-resolver.git\n$ cd uwsgi-local-dns-resolver\n$ python setup.py install  # you could need sudo here\n```\n\nAnd if you want, you can test the server with:\n```bash\n$ sudo uwsgidns # we need sudo to bind on reserved port 53\n```\n\nOnce started, you should have a DNS server running on `localhost:53`.\n\nNote: installing uWSGI-DNS inside a virtualenv is obviously possible, but you should use particular care while integrating it into uWSGI configuration files.\n\n## Configuration\n```bash\n$ uwsgidns -h\nusage: uwsgidns [-h] [-l {CRITICAL,ERROR,WARNING,INFO,DEBUG,NOTSET}] [-p]\n                [-u upstream DNS server URI] [-s uwsgi-HTTP-stats-URI]\n\nDNS server that resolves to localhost uWSGI HTTP subscribed domains.\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -l {CRITICAL,ERROR,WARNING,INFO,DEBUG,NOTSET}, --logging {CRITICAL,ERROR,WARNING,INFO,DEBUG,NOTSET}\n                        set the logging level\n  -p, --proxy           proxy other requests to upstream DNS server\n                        (--upstream)\n  -u upstream DNS server URI, --upstream upstream DNS server URI\n                        the URI to the upstream DNS server (with --proxy),\n                        defaults to 8.8.8.8:53\n  -s uwsgi-HTTP-stats-URI, --stats uwsgi-HTTP-stats-URI\n                        the URI (remote:port) to the uWSGI HTTP subscription\n                        stats server\n```\n\n### Non-local requests\nuWSGI-DNS can act as a DNS proxy (`-p`), forwarding each non-local request to the upstream server specified with the `-u` flag;\notherwise, it simply drops such requests and let the OS fallback DNS server handle them.\n\n### uWSGI stats\nSetting the `-s` will let uWSGI-DNS poll the uWSGI subscription server periodically.\nIn this way uWSGI-DNS will notice failed/disappeared HTTP nodes and will remove them from the local domains.\n\n## uWSGI (Emperor) integration\nThe integration with the uWSGI emperor is simple and straightforward.\nWe assume you use the uWSGI HTTP subscription server.\nTo integrate uWSGI-DNS you can edit the configuration file of your emperor/subscription server as follows:\n\n```ini\n; uWSGI subscription server - ini configuration file\nhttp = :80\nhttp-subscription-server = 127.0.0.1:5005\nhttp-stats-server = 127.0.0.1:5004\n\n; resubscribe let uWSGI-DNS know about new HTTP nodes\nhttp-resubscribe = 127.0.0.1:9696\n\n; launch the uWSGI-DNS with the HTTP subscription server\n; you can tweak the command line arguments and the path here\nattach-daemon = uwsgidns\n```\nAnytime you'll launch the subscription system, the uWSGI-DNS server will launch with it.\n\nPlease note that in the following section we provide some more OS-specific examples.\n\n## OS integration\nTODO: other OSs integration.\n\nThe OS integration largely varies with each platforms.\nWe provide here just a few examples, adapt them to your needs.\n\n### OS X integration\nYou can use LaunchD to automatically launch a uWSGI emperor instance on startup.\nTo do so, create the file `it.unbit.uwsgi.emperor.plist` in the `/Library/LaunchDaemons/` directory and make sure it has the following content.\nThe same example can also be found in this repository.\n\n```plist\n\u003c?xml version=\"1.0\" encoding=\"UTF-8\"?\u003e\n\u003c!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\" \"http://www.apple.com/DTDs/PropertyList-1.0.dtd\"\u003e\n\u003cplist version=\"1.0\"\u003e\n\u003cdict\u003e\n        \u003ckey\u003eRunAtLoad\u003c/key\u003e\n        \u003ctrue/\u003e\n        \u003ckey\u003eDisabled\u003c/key\u003e\n        \u003cfalse/\u003e\n        \u003ckey\u003eKeepAlive\u003c/key\u003e\n    \t\u003cdict\u003e\n         \t\u003ckey\u003eSuccessfulExit\u003c/key\u003e\n         \t\u003cfalse/\u003e\n   \t \u003c/dict\u003e\n        \u003ckey\u003eLabel\u003c/key\u003e\n        \u003cstring\u003eit.unbit.uwsgi.emperor\u003c/string\u003e\n        \u003ckey\u003eProgramArguments\u003c/key\u003e\n        \u003carray\u003e\n                \u003cstring\u003e/usr/local/bin/uwsgi\u003c/string\u003e\n                \u003cstring\u003e--master\u003c/string\u003e\n                \u003cstring\u003e--die-on-term\u003c/string\u003e\n                \u003c!-- You could either need or not some more plugins,\n                     if you're using a monolitic uWSGI build --\u003e\n                \u003cstring\u003e--plugin\u003c/string\u003e\n                \u003cstring\u003esyslog\u003c/string\u003e\n                \u003cstring\u003e--logger\u003c/string\u003e\n                \u003cstring\u003esyslog:\u003c/string\u003e\n                \u003cstring\u003e--emperor\u003c/string\u003e\n                \u003cstring\u003e/Users/*/*/vassals/*.ini\u003c/string\u003e\n                \u003cstring\u003e--emperor\u003c/string\u003e\n                \u003cstring\u003e/Users/*/vassals/*.ini\u003c/string\u003e\n                \u003cstring\u003e--emperor-tyrant\u003c/string\u003e\n                \u003cstring\u003e--http\u003c/string\u003e\n                \u003cstring\u003e:80\u003c/string\u003e\n                \u003cstring\u003e--http-subscription-server\u003c/string\u003e\n                \u003cstring\u003e127.0.0.1:5005\u003c/string\u003e\n                \u003cstring\u003e--http-resubscribe\u003c/string\u003e\n                \u003cstring\u003e127.0.0.1:9696\u003c/string\u003e\n                \u003cstring\u003e--http-stats-server\u003c/string\u003e\n                \u003cstring\u003e127.0.0.1:5004\u003c/string\u003e\n                \u003cstring\u003e--emperor-stats-server\u003c/string\u003e\n                \u003cstring\u003e127.0.0.1:5000\u003c/string\u003e\n                \u003cstring\u003e--attach-daemon\u003c/string\u003e\n                \u003cstring\u003e/usr/local/bin/uwsgidns -p\u003c/string\u003e\n        \u003c/array\u003e\n\u003c/dict\u003e\n\u003c/plist\u003e\n```\nPut the vassals configuration files in your home folder and then start the uWSGI emperor with the command:\n```bash\n$ sudo launchctl load /Library/LaunchDaemons/it.unbit.uwsgi.emperor.plist\n```\n\nYou can finally edit your connection parameters and set the [custom DNS server](https://support.apple.com/kb/PH14159) pointing to `127.0.0.1`.\nThe DNS resolver will try to solve local requests and then will proxy to upstream the others.\nThe default upstream is `8.8.8.8:53` and you can customize it with the `-u UPSTREAM_ADDRESS:PORT` flag.\n\n_Bonus_: before editing your network settings, you can create a new [Network Location](https://support.apple.com/en-us/HT202480) to be specifically used while developing and edit its DNS settings.\n\n## Tests\nTODO: add tests.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F20tab%2Fuwsgi-local-dns-resolver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F20tab%2Fuwsgi-local-dns-resolver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F20tab%2Fuwsgi-local-dns-resolver/lists"}