{"id":36252238,"url":"https://github.com/noglitchyo/dealdoh-client","last_synced_at":"2026-01-11T07:01:32.112Z","repository":{"id":37548216,"uuid":"192723752","full_name":"noglitchyo/dealdoh-client","owner":"noglitchyo","description":"DNS client with an embedded HTTP proxy and CLI to make/forward DNS query using a pool of DNS and different DNS protocols. Built on top of Dealdoh, written in PHP.","archived":false,"fork":false,"pushed_at":"2023-04-21T20:29:32.000Z","size":130,"stargazers_count":2,"open_issues_count":3,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-04-07T13:03:49.104Z","etag":null,"topics":["cli","dns","dns-client","dns-over-https","doh","middleware","proxy","rfc-8484"],"latest_commit_sha":null,"homepage":null,"language":"PHP","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/noglitchyo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-06-19T12:00:32.000Z","updated_at":"2024-04-07T13:03:49.105Z","dependencies_parsed_at":"2022-08-23T16:20:36.943Z","dependency_job_id":null,"html_url":"https://github.com/noglitchyo/dealdoh-client","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/noglitchyo/dealdoh-client","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noglitchyo%2Fdealdoh-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noglitchyo%2Fdealdoh-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noglitchyo%2Fdealdoh-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noglitchyo%2Fdealdoh-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/noglitchyo","download_url":"https://codeload.github.com/noglitchyo/dealdoh-client/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noglitchyo%2Fdealdoh-client/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28296941,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-11T04:44:51.577Z","status":"ssl_error","status_checked_at":"2026-01-11T04:44:44.232Z","response_time":60,"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":["cli","dns","dns-client","dns-over-https","doh","middleware","proxy","rfc-8484"],"created_at":"2026-01-11T07:01:21.087Z","updated_at":"2026-01-11T07:01:32.102Z","avatar_url":"https://github.com/noglitchyo.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# dealdoh-client\n\u003e A toy to deal DNS over HTTPS and more!\n\ndealdoh-client is a simple DNS client embedding a DNS-over-HTTPS (DoH) proxy server and CLI to make \u0026 forward DNS queries through a variety of upstreams. \n\n![PHP from Packagist](https://img.shields.io/packagist/php-v/noglitchyo/dealdoh-client.svg)\n[![Build Status](https://travis-ci.org/noglitchyo/dealdoh-client.svg?branch=master)](https://travis-ci.org/noglitchyo/dealdoh-client)\n[![codecov](https://codecov.io/gh/noglitchyo/dealdoh-client/branch/master/graph/badge.svg)](https://codecov.io/gh/noglitchyo/dealdoh-client)\n![Scrutinizer code quality (GitHub/Bitbucket)](https://img.shields.io/scrutinizer/quality/g/noglitchyo/dealdoh-client.svg)\n![Packagist](https://img.shields.io/packagist/l/noglitchyo/dealdoh-client.svg)\n![Docker Cloud Build Status](https://img.shields.io/docker/cloud/build/noglitchyo/dealdoh-client.svg)\n\n## Description\n\ndealdoh-client can be use in different manners and for different purposes:\n- as a DoH proxy server\n- as a DNS client, using the provided command-line client to make DNS queries\n- both can use a pool of DNS upstream which can be easily configured by running some commands\n\nDealdoh is built on top of the [Dealdoh library](https://github.com/noglitchyo/dealdoh).\n\n## Roadmap\n\n- [x] [Docker image](./docker/README.md)\n\n## Getting started\n\nAs mentionned above, there is multiple ways to use dealdoh-client.\nLet's see what can be done at the time with dealdoh-client.\n\n### As a DoH proxy server\n\n### As a DNS command-line client\n\n#### Requirements\n\n- PHP 7.3\n- [Composer](https://getcomposer.org/doc/00-intro.md)\n\n#### Installation\n\n- You can use the client by cloning the project:\n\n`git clone https://github.com/noglitchyo/dealdoh-client` \n\n`composer install`\n\n- or by using as a dependency in a project:\n\n`composer require noglitchyo/dealdoh-client` \n\n#### Usage\n\n##### Add a DNS upstream\n\nYou can use the following command to add a DNS upstream to the DNS pool:\n\n`php bin/dealdoh upstream:add https://dns.google.com/resolve google-doh-api`\n\n##### Execute a DNS query\n\nTo execute DNS query directly from the command-line, you can use the provided binary:\n\n`php bin/dealdoh resolve tools.ietf.org AAAA --pretty`\n\nIt will output the result as JSON string: (response is truncated)\n```json\n{\n    \"header\": {\n        \"id\": 0,\n        \"qr\": true,\n        \"opcode\": 0,\n        \"aa\": false,\n        \"tc\": false,\n        \"rd\": true,\n        \"ra\": true,\n        \"z\": 0,\n        \"rcode\": 0\n    },\n    \"question\": [\n        {\n            \"qname\": \"tools.ietf.org.\",\n            \"qtype\": 28,\n            \"qclass\": 1\n        }\n    ],\n    \"answer\": [\n        {\n            \"name\": \"tools.ietf.org.\",\n            \"type\": 28,\n            \"class\": 1,\n            \"ttl\": 13,\n            \"data\": \"2001:1900:3001:11::3e\"\n        }\n    ],\n    \"authority\": [],\n    \"additional\": []\n}\n```\n\n## Testing\n\nIf you wish to run the test, checkout the project and run the test with: \n\n`composer test`\n\n## Contributing\n\nGet started here [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnoglitchyo%2Fdealdoh-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnoglitchyo%2Fdealdoh-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnoglitchyo%2Fdealdoh-client/lists"}