https://github.com/muhammadn/avahi-proxy

https://github.com/muhammadn/avahi-proxy

Last synced: about 2 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/muhammadn/avahi-proxy
• Owner: muhammadn
• License: agpl-3.0
• Created: 2024-10-24T21:34:04.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2024-10-27T14:49:38.000Z (3 months ago)
• Last Synced: 2024-10-28T09:33:00.761Z (2 months ago)
• Language: Go
• Size: 36.1 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Multicast DNS Proxy written in Go

This was to solve the problem in trying to proxy all my local "home.lan" domain to Multicast DNS ".local" domain.

Problem was all existing solutions are eiher written in scripting languages such as Ruby and Python which are less performant.

So now, everything that is within Multicast DNS ".local" domain is resolvable with "home.lan" as well.

For example, i have a machine which is "muhammads-macbook-pro.local" which resolves with Multicast DNS (mDNS) but i want the host "muhammads-macbook-pro" to be resolvable as "muhammads-macbook-pro.home.lan" as well.

This helps with machines like Microsoft Windows,Android and Linux (without avahi installed) which does not have Multicast DNS built-in (thus cannot resolve ".local" TLD)

Another use case is when you want your ".local" DNS hosts to be resolvable across IPSec VPNs or other segmented networks where mDNS reflection is not possible.

Also useful for dynamic IP environments where IPs are assigned via DHCP and it is almost impossible to configure hostnames via your custom domain.

So you can actually run `dnsmasq` and then upstream any `.home.lan` requests to this multicast dns proxy software and return the IP from multicast `.local`.

Example in `dnsmasq.conf`:

```

server=/home.lan/127.0.0.1#5354

```

Note: I assume you have Avahi running on Linux with DBus to run this program.

Run this program by specifying what is your LAN domain name. Default port is 5354.

Example:

```

./avahi-proxy run --baseDomain home.lan

```

depending on what domain you configured for your LAN network.

Also you can specify the port which you want `avahi-proxy` to run on.

example:

```

./avahi-proxy run --baseDomain home.lan --port 5355

``` 

Linux systemd configuration example:

```

[Unit]

Description=Avahi Multicast-DNS Proxy

After=network.target

[Service]

Type=simple

User=dnsmasq

Group=nogroup

ExecStart=/usr/local/bin/avahi-proxy run home.lan

Restart=on-failure

RestartSec=10

```

Contributions are welcome.