{"id":26642861,"url":"https://github.com/whiteducksoftware/az-dns-forwarder","last_synced_at":"2025-04-10T22:39:25.021Z","repository":{"id":50498364,"uuid":"269046066","full_name":"whiteducksoftware/az-dns-forwarder","owner":"whiteducksoftware","description":"A containerized Azure DNS Forwarder 🛠","archived":false,"fork":false,"pushed_at":"2020-09-02T06:40:36.000Z","size":11,"stargazers_count":62,"open_issues_count":2,"forks_count":29,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-03-24T19:35:49.507Z","etag":null,"topics":["aci","aks","azure","bind","container","dns","forwarder"],"latest_commit_sha":null,"homepage":"https://whiteduck.de","language":"Dockerfile","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/whiteducksoftware.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":"2020-06-03T09:29:54.000Z","updated_at":"2025-01-09T13:40:22.000Z","dependencies_parsed_at":"2022-08-27T04:22:36.586Z","dependency_job_id":null,"html_url":"https://github.com/whiteducksoftware/az-dns-forwarder","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/whiteducksoftware%2Faz-dns-forwarder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whiteducksoftware%2Faz-dns-forwarder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whiteducksoftware%2Faz-dns-forwarder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whiteducksoftware%2Faz-dns-forwarder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/whiteducksoftware","download_url":"https://codeload.github.com/whiteducksoftware/az-dns-forwarder/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248312175,"owners_count":21082637,"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":["aci","aks","azure","bind","container","dns","forwarder"],"created_at":"2025-03-24T19:28:19.820Z","updated_at":"2025-04-10T22:39:24.995Z","avatar_url":"https://github.com/whiteducksoftware.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Containerized Azure DNS Forwarder\n\n\u003e This project is inspired by the [DNS Forwarder VM](https://github.com/Azure/azure-quickstart-templates/tree/master/301-dns-forwarder/). It provides a similar experience for a containerized environment. \n\nThis project provides a containerized DNS server that forwards queries to Azure's internal DNS servers so that hostnames in the virtual network can be resolved from outside the network. This is helpful, for example, when you need to resolve Private Link enabled resources from your on-premises networks connected via Side-to-Side VPN or ExpressRoute. \n\nThis Container can be deployed and exposed internally with Azure Kubernetes Service as well as Azure Container Instances.\n\n![DNS Forwarder](https://docs.microsoft.com/en-us/azure/private-link/media/private-endpoint-dns/hybrid-scenario.png)\n\n## Get started\nBelow you find get started guides for AKS as well as ACI.\n\n### Azure Kubernetes Service\n\nYou need make sure that all needed private Azure DNS zones are linked to the virtual network used for AKS. Without this the DNS forwarder will not be able to resolve them.\n\n```\nkubectl apply -f https://raw.githubusercontent.com/whiteducksoftware/az-dns-forwarder/master/deploy.yaml\n```\n\nThis will deploy the Azure DNS Forwarder container as Deployment with 3 replicas. It also creates an LoadBalancer services using an internal Azure Loadbalancer to expose the DNS forwarder internally. \n\n### Azure Container Instances\n\nYou can also run the DNS Forwarder as a serverless instance with ACI. Once again, you will need to make sure to expose ACI internally and make sure that all needed Azure private DNS zones are linked to the used virtual network.\n\n```\naz container create \\\n  --resource-group \u003cyour-rg\u003e \\\n  --name dns-forwarder \\\n  --image ghcr.io/whiteducksoftware/az-dns-forwarder/az-dns-forwarder:latest \\\n  --cpu 1 \\\n  --memory 0.5 \\\n  --restart-policy always \\\n  --vnet \u003cyour-vnet\u003e \\\n  --subnet \u003cyour-subnet\u003e \\\n  --ip-address private \\\n  --location \u003cyour-location\u003e \\\n  --os-type Linux \\\n  --port 53 \\\n  --protocol UDP\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhiteducksoftware%2Faz-dns-forwarder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwhiteducksoftware%2Faz-dns-forwarder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhiteducksoftware%2Faz-dns-forwarder/lists"}