{"id":21070167,"url":"https://github.com/dominikrys/iris","last_synced_at":"2025-03-14T02:41:13.173Z","repository":{"id":163930742,"uuid":"333149378","full_name":"dominikrys/iris","owner":"dominikrys","description":"🌐 DNS server","archived":false,"fork":false,"pushed_at":"2021-08-14T12:14:07.000Z","size":150,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-20T21:55:19.837Z","etag":null,"topics":["dns","rust","server"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/dominikrys.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-01-26T16:42:19.000Z","updated_at":"2022-12-10T12:17:58.000Z","dependencies_parsed_at":null,"dependency_job_id":"9525a590-a33d-478f-b411-00fc2c1a57ef","html_url":"https://github.com/dominikrys/iris","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dominikrys%2Firis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dominikrys%2Firis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dominikrys%2Firis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dominikrys%2Firis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dominikrys","download_url":"https://codeload.github.com/dominikrys/iris/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243513365,"owners_count":20302937,"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":["dns","rust","server"],"created_at":"2024-11-19T18:44:29.777Z","updated_at":"2025-03-14T02:41:13.147Z","avatar_url":"https://github.com/dominikrys.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Iris\n\n[![Build Status](https://img.shields.io/github/workflow/status/dominikrys/iris/Continuous%20Integration?style=flat-square)](https://github.com/dominikrys/iris/actions)\n\nRudimentary DNS server implementation in Rust with support for the most common DNS record types. Written with the help of [Emil Hernvall's DNS guide](https://github.com/EmilHernvall/dnsguide). Non-exhaustive tests are also provided.\n\nThe aim of this project was to learn about Rust and DNS protocols.\n\n## Demo\n\n[![asciicast](https://asciinema.org/a/422536.svg)](https://asciinema.org/a/422536)\n\n## Build Instructions\n\n[Rust](https://www.rust-lang.org/) (stable or nightly) needs to be installed. Then, run:\n\n```bash\ncargo build\n```\n\nFor automated pre-commit/pre-push checks, a [Lefthook](https://github.com/evilmartians/lefthook) script is included. Run `lefthook install` to initialize it.\n\n## How to Run\n\nRun the server:\n\n```bash\ncargo run\n```\n\nThen, while the server is running, send a DNS query to port 2053:\n\n```bash\ndig @127.0.0.1 -p 2053 www.google.com\n```\n\nTo run the provided tests:\n\n```bash\ncargo test\n```\n\n## Links\n\n- [DNS packet structure reference](http://www.networksorcery.com/enp/protocol/dns.htm)\n- [Domain name compression explanation](https://docstore.mik.ua/orelly/networking_2ndEd/dns/ch15_02.htm)\n\n## Further Improvements\n\nI've achieved what I wanted to with this project, but there are some further improvements that could be made:\n\n- Support replies larger than 512B (TCP connection support is necessary for this)\n- Concurrency\n- Start resolving using other servers than the A root server\n- Add support for hosting zones\n- Allow acting as an authoritative server\n- DNSSEC\n- Add support for more records (SOA, TXT, SRV, OPT)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdominikrys%2Firis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdominikrys%2Firis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdominikrys%2Firis/lists"}