{"id":19206779,"url":"https://github.com/hausgold/mdns-proxy","last_synced_at":"2025-05-12T17:27:18.141Z","repository":{"id":89453879,"uuid":"230390056","full_name":"hausgold/mdns-proxy","owner":"hausgold","description":"Serves as a jump host to your local mDNS-enabled container stack","archived":false,"fork":false,"pushed_at":"2025-05-12T08:58:52.000Z","size":52,"stargazers_count":3,"open_issues_count":0,"forks_count":2,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-05-12T10:06:11.053Z","etag":null,"topics":["docker","docker-image","mdns","oss","proxy","zeroconf"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/hausgold/mdns-proxy/","language":"Makefile","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/hausgold.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,"zenodo":null}},"created_at":"2019-12-27T06:54:05.000Z","updated_at":"2025-05-12T08:58:55.000Z","dependencies_parsed_at":"2025-04-20T15:46:08.790Z","dependency_job_id":null,"html_url":"https://github.com/hausgold/mdns-proxy","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/hausgold%2Fmdns-proxy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hausgold%2Fmdns-proxy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hausgold%2Fmdns-proxy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hausgold%2Fmdns-proxy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hausgold","download_url":"https://codeload.github.com/hausgold/mdns-proxy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253786350,"owners_count":21964146,"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":["docker","docker-image","mdns","oss","proxy","zeroconf"],"created_at":"2024-11-09T13:16:59.830Z","updated_at":"2025-05-12T17:27:18.128Z","avatar_url":"https://github.com/hausgold.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"![mDNS proxy](https://raw.githubusercontent.com/hausgold/mdns-proxy/master/docs/assets/project.svg)\n\n[![Continuous Integration](https://github.com/hausgold/mdns-proxy/actions/workflows/package.yml/badge.svg?branch=master)](https://github.com/hausgold/mdns-proxy/actions/workflows/package.yml)\n[![Source Code](https://img.shields.io/badge/source-on%20github-blue.svg)](https://github.com/hausgold/mdns-proxy)\n[![Docker Image](https://img.shields.io/badge/image-on%20docker%20hub-blue.svg)](https://hub.docker.com/r/hausgold/mdns-proxy/)\n\nThis Docker images provides a simple proxy for tunneling requests to\nmDNS-enabled Docker containers via a single endpoint. This allows bridging\nregular DNS to mDNS name resolution transparently. The usage of this software\nmay be useful in various situations, eg. using it together with\n[Dnsmasq](http://www.thekelleys.org.uk/dnsmasq/doc.html) on macOS (with Docker\nfor Mac) or as an regular entrypoint to a virtual machine or on a remote cloud\ninstance.\n\nA simple example setup requires a virtual machine, some mDNS-enabled containers\nrunning inside of it, this software running also inside of the virtual machine\nand some host entry configurations.\n\n- [Requirements](#requirements)\n- [Getting starting](#getting-starting)\n- [docker-compose usage example](#docker-compose-usage-example)\n- [Rebind another external DNS suffix](#rebind-another-external-dns-suffix)\n\n## Requirements\n\n* A dedicated host where some mDNS-enabled containers are running (which will\n  be made available on a single port of the host)\n\n## Getting starting\n\nYou just need to run it like that, to get a working ruby:\n\n```bash\n$ docker run -p 80:80 --rm hausgold/mdns-proxy\n```\n\nThe binded host port is then linked to the mDNS proxy which will handle\nrequests with various host headers (eg. test.local).\n\n## docker-compose usage example\n\n```yaml\nservices:\n  ruby:\n    image: hausgold/mdns-proxy\n    environment:\n      # The default, see \"Rebind another external DNS suffix\"\n      MDNS_SUFFIX: .local\n      # These root path entries will be upgraded to WebSocket\n      # connections transparently. The following list is the default.\n      WEBSOCKET_PATHS: 'cable|sockjs-node|livereload|ws'\n      # Change the maximum upload size per request\n      MAX_UPLOAD_SIZE: 20m\n```\n\n## Rebind another external DNS suffix\n\nYou can modify the incomming host names by reconfiguring the `MDNS_SUFFIX`\nwhich defaults to `.local`. This way you can transparently rebind the host to a\ndifferent DNS name. Say you have an AWS EC2 instance with some mDNS-enabled\ncontainers running and bind an IP to it. Setup an A DNS record for it like\n`example.com` and a wildcard to the very same host.  Then you set\n`MDNS_SUFFIX='.example.com'` here and your can access your mDNS containers like\nthis: `app.example.com`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhausgold%2Fmdns-proxy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhausgold%2Fmdns-proxy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhausgold%2Fmdns-proxy/lists"}