Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
docs:guide-developer:mdns [2023/02/28 13:06] – [Alternatives] stokitodocs:guide-developer:mdns [2024/10/17 00:59] (current) – [Config File] bartprokop
Line 15: Line 15:
 <code - /etc/config/umdns> <code - /etc/config/umdns>
 config umdns config umdns
-        option jail 1 + option jail 1 # enables jail - see procd 
-        list network lan + list network lan 
-        list network dmz # Provides visibility into both networks, but does not act as a repeater+ list network dmz # Provides visibility into both networks, but does not act as a repeater
 </code> </code>
 +
 Note that it may be unsafe to enable umdns on ''wan'' interface. Note that it may be unsafe to enable umdns on ''wan'' interface.
 +
 +Note that ''%%network list%%'' argument refers to interface name under ''%%/etc/config/network%%'' not the device name shown by ''%%ifconfig%%''. Test if you using the right name with ''%%ifstatus%%''. So if you have something like ''%%config interface 'vlan1'%%'' in your ''%%/etc/config/network%%'', use ''%%vlan1%%''.
  
 ==== Install ==== ==== Install ====
Line 25: Line 28:
  
 ==== Firewall ==== ==== Firewall ====
-UDP port 5353 should be opened in firewall:+If you need to advertise on WAN or other networks then UDP port 5353 should be opened in firewall:
 <code - /etc/config/firewall> <code - /etc/config/firewall>
 config rule config rule
Line 32: Line 35:
         option name 'Allow-mDNS'         option name 'Allow-mDNS'
         option target 'ACCEPT'         option target 'ACCEPT'
-        list dest_ip '224.0.0.251'+        option dest_ip '224.0.0.251'
         option dest_port '5353'         option dest_port '5353'
-        list proto 'udp'+        option proto 'udp'
 </code> </code>
 To configure from GUI see "Firewall rules" section of [[https://blog.christophersmart.com/2020/03/30/resolving-mdns-across-vlans-with-avahi-on-openwrt/|Resolving mDNS across VLANs with Avahi on OpenWRT]] To configure from GUI see "Firewall rules" section of [[https://blog.christophersmart.com/2020/03/30/resolving-mdns-across-vlans-with-avahi-on-openwrt/|Resolving mDNS across VLANs with Avahi on OpenWRT]]
Line 131: Line 134:
       "path=/nextcloud/remote.php/dav/files/YOUR_USER/",       "path=/nextcloud/remote.php/dav/files/YOUR_USER/",
       "u=YOUR_USER"       "u=YOUR_USER"
 +    ]
 +  }
 +}
 +</code>
 +Or you can advertise SFTP and SSH:
 +<code - /etc/umdns/ssh.json>
 +{
 +  "ssh_login": {
 +    "service": "_ssh._tcp.local",
 +    "port": 22,
 +    "txt": [
 +      "u=root"
 +    ]
 +  },
 +  "sftp_share": {
 +    "service": "_sftp-ssh._tcp.local",
 +    "port": 22,
 +    "txt": [
 +      "path=/",
 +      "u=root"
     ]     ]
   }   }
Line 136: Line 159:
 </code> </code>
 See more examples in [[commit>?p=project/mdnsd.git;a=tree;f=json;hb=HEAD|umdns sources]] See more examples in [[commit>?p=project/mdnsd.git;a=tree;f=json;hb=HEAD|umdns sources]]
 +
 +The reload the umdns service with: ''ubus call umdns reload'' or ''service umdns reload''
  
 ==== Testing === ==== Testing ===
-To see that service was advertised you may use ''avahi-discover'' or ''avahi-browse -d local _webdav._tcp.local''+To see that service was advertised you may use ''avahi-discover'' GUI application. 
 +To see from a command line use ''avahi-browse --all''. 
 +To find a specific service use: ''avahi-browse -d local _webdav._tcp''. 
 + 
  • Last modified: 2023/02/28 13:06
  • by stokito