{"id":21024791,"url":"https://github.com/bernoussama/mercury","last_synced_at":"2025-04-12T11:35:38.520Z","repository":{"id":263054107,"uuid":"889206632","full_name":"bernoussama/mercury","owner":"bernoussama","description":"light DNS server","archived":false,"fork":false,"pushed_at":"2024-12-06T01:20:28.000Z","size":77,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-06T02:13:27.958Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","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/bernoussama.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":"2024-11-15T20:21:42.000Z","updated_at":"2024-12-18T09:58:39.000Z","dependencies_parsed_at":"2024-11-15T21:25:58.855Z","dependency_job_id":"d4ce863a-2597-4ffe-9c91-d0614bada228","html_url":"https://github.com/bernoussama/mercury","commit_stats":null,"previous_names":["bernoussama/mercury"],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bernoussama%2Fmercury","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bernoussama%2Fmercury/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bernoussama%2Fmercury/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bernoussama%2Fmercury/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bernoussama","download_url":"https://codeload.github.com/bernoussama/mercury/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248560795,"owners_count":21124724,"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-11-19T11:28:36.169Z","updated_at":"2025-04-12T11:35:38.491Z","avatar_url":"https://github.com/bernoussama.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mercury\n\nMercury is a light DNS server implementation from scratch in Go\n\n## Capabilities\n\n- Recursive resolver - resolves directly using the Internet root servers by default, eliminating the need to trust any external name servers.\n- Authoritative server for your own zones.\n- DNS sinkhole - (dns-level ad-block)\n- Caches DNS queries\n- Handles concurrent clients\n\n[//]: # \"## Why?\"\n\n## 🚀 Quick Start\n### Install\n\n#### Docker compose:\n\n- `compose.yaml`\n```yaml\nservices:\n  mercury:\n    image: ghcr.io/bernoussama/mercury:latest\n    ports:\n      - \"${PORT}:53153/udp\"\n      - \"${PORT}:53153/tcp\"\n    volumes:\n      - ./zones:/opt/mercury/zones\n```\n\n- run the container in the background\n```bash\nPORT=53 docker compose up -d\n```\n\n### systemd service\n\n\u003e WIP\n\n\n## ⚙️ Usage\n\u003e ⚠️ still in development\n\nif you want to use just send dns requests to the server\n\nexample:\n```bash\ndig google.com @server-ip -p 53\n```\n \n\u003e cli comming soon\n\n## 👏 Contributing\n\nComments and pull requests are welcome and encouraged.\n\nYou can contribute by forking the repo and opening pull requests.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbernoussama%2Fmercury","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbernoussama%2Fmercury","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbernoussama%2Fmercury/lists"}