{"id":43098599,"url":"https://github.com/phyber/kube-mdns","last_synced_at":"2026-01-31T17:06:03.717Z","repository":{"id":304900639,"uuid":"1020281246","full_name":"phyber/kube-mdns","owner":"phyber","description":"Tool for publishing mDNS names via Avahi based on Kubernetes Ingress annotations","archived":false,"fork":false,"pushed_at":"2025-09-21T20:24:10.000Z","size":74,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-21T22:17:40.408Z","etag":null,"topics":["avahi","k8s","kubernetes","mdns","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/phyber.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-APACHE","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-15T16:09:48.000Z","updated_at":"2025-09-21T20:24:15.000Z","dependencies_parsed_at":"2025-07-17T06:23:23.553Z","dependency_job_id":"ed8d7e57-67e2-4c5b-86fc-c398be44f201","html_url":"https://github.com/phyber/kube-mdns","commit_stats":null,"previous_names":["phyber/kube-mdns"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/phyber/kube-mdns","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phyber%2Fkube-mdns","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phyber%2Fkube-mdns/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phyber%2Fkube-mdns/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phyber%2Fkube-mdns/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/phyber","download_url":"https://codeload.github.com/phyber/kube-mdns/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phyber%2Fkube-mdns/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28948357,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-31T14:26:55.697Z","status":"ssl_error","status_checked_at":"2026-01-31T14:26:52.545Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["avahi","k8s","kubernetes","mdns","rust"],"created_at":"2026-01-31T17:06:02.881Z","updated_at":"2026-01-31T17:06:03.711Z","avatar_url":"https://github.com/phyber.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# kube-mdns\n\nKube mDNS registers hostnames with Avahi based on annotations given to an\n`Ingress`. This allows Ingresses to have unique `.local` hostnames assigned to\nthem, which helps with reverse proxying.\n\nThis project is based on [`docker-mdns`], which provides the same functionality\nfor Docker environments.\n\n## Minimum Supported Rust Version (MSRV)\n\nThe MSRV for this project is currently 1.85.1.\n\n## Configuration\n\nKube mDNS does not take any command line arguments, but will take logging\nconfiguration from the environment via the `RUST_LOG` environment variable.\nExamples for setting this can be found in the `tracing_subscriber`\n[`EnvFilter`] documentation.\n\nThe main Kube mDNS configuration is done through annotations on `Ingress`\nobjects in Kubernetes.\n\n| Label                                  | Description                         |\n|----------------------------------------|-------------------------------------|\n| `phyber.github.io/kube-mdns.hostnames` | Hostnames to add for this `Ingress` |\n\nThe `phyber.github.io/kube-mdns.hostnames` annotation can take a list of\nwhitespace separated hostnames if you want multiple hostnames for a single\n`Ingress`.\n\nThe IP addresses that the hostnames point to will be taken from the IP address\nof the `LoadBalancer` that ends up attached to the `Ingress` object.\n\n## Example\n\n```yaml\n---\napiVersion: \"networking.k8s.io/v1\"\nkind: \"Ingress\"\nmetadata:\n  annotations:\n    nginx.ingress.kubernetes.io/backend-protocol: \"HTTP\"\n    nginx.ingress.kubernetes.io/ssl-redirect: \"true\"\n    phyber.github.io/kube-mdns.hostnames: \"example.local\"\nspec:\n  ingressClassName: \"nginx\"\n  rules:\n    - host: \"example.local\"\n      http:\n        paths:\n          - path: \"/\"\n            pathType: \"ImplementationSpecific\"\n            backend:\n              service:\n                name: \"example\"\n                port:\n                  name: \"example\"\n```\n\n## Known Issues\n\nThese are mostly issues just because they're untested with my current setup.\n\n  - This is currently developed in a Kubernetes \"cluster\" with just a single\n    node\n  - With \u003e1 node in a cluster, how do we decide which node to announce mDNS\n    from? Do we need to decide at all?\n    - RFC-6762 section 6.6 suggests it should be fine to announce all\n      configured names from each node\n      - Specifically the second case given, where duplicate mDNS responses\n        contain the same rrtype, rrclass, and rdata\n  - The container image is not currently a multi-arch image, making use of the\n    Helm charts a little more difficult as users must manually specify which\n    image tag they'd like to use\n\n## License\n\nLicensed under either of\n\n  * Apache License, Version 2.0\n    ([LICENSE-APACHE] or https://www.apache.org/licenses/LICENSE-2.0)\n  * MIT license\n    ([LICENSE-MIT] or https://opensource.org/licenses/MIT)\n\nat your option.\n\n\u003c!-- links --\u003e\n[`docker-mdns`]: https://github.com/phyber/docker-mdns\n[`EnvFilter`]: https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#example-syntax\n[LICENSE-APACHE]: LICENSE-APACHE\n[LICENSE-MIT]: LICENSE-MIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphyber%2Fkube-mdns","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphyber%2Fkube-mdns","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphyber%2Fkube-mdns/lists"}