mirror of
https://github.com/roles-ansible/ansible_role_avahi_daemon.git
synced 2024-08-16 15:09:48 +02:00
68 lines
1.9 KiB
Markdown
68 lines
1.9 KiB
Markdown
[](https://galaxy.ansible.com/do1jlr/avahi_daemon)
|
|
[](https://github.com/roles-ansible/ansible_role_avahi_daemon/blob/main/LICENSE)
|
|
|
|
ansible role avahi_daemon
|
|
===========================
|
|
Ansible role to install the avahi_daemon and optionally announce some services.
|
|
|
|
Variables
|
|
-----------
|
|
In the ``avahi_daemon__services`` variable you can define the services you want to announce.
|
|
Here is a list with available parameters:
|
|
+ ``service``: Service Name *(HTTP/SSH/...)* ***(required)***
|
|
+ ``port``: Service Port ***(required)***
|
|
- ``name``: optional name to announce the Service
|
|
- ``protocol``: ``any``/``ipv6``/``ipv4``
|
|
- ``txt_records``: an array of txt records
|
|
- ``transport``: Transport Protokoll (``tcp``/``udp``)
|
|
|
|
|
|
Example:
|
|
```yaml
|
|
---
|
|
avahi_daemon__services:
|
|
- service: 'SSH'
|
|
port: 22
|
|
protocol: 'any'
|
|
transport: 'tcp'
|
|
- service: 'NFS'
|
|
name: 'Filesharing Host %h'
|
|
port: 2049
|
|
protocol: 'ipv6'
|
|
txt_records:
|
|
- 'path=/path/to/nfsexport'
|
|
- service: 'FTP'
|
|
port: '21'
|
|
protocol: 'ipv4'
|
|
txt_records:
|
|
- 'path=/ftppath'
|
|
- 'u=ftpuser'
|
|
- 'p=ftppass'
|
|
```
|
|
|
|
Netfilter rules
|
|
---------------
|
|
Avahi is using multicast to announce services.
|
|
Do not forget to add netfilter rules for multicast dns.
|
|
|
|
Configuration example for `ferm`:
|
|
|
|
```
|
|
# mdns
|
|
daddr 224.0.0.251 proto udp dport 5353 ACCEPT;
|
|
daddr ff02::fb proto udp dport 5353 ACCEPT;
|
|
```
|
|
|
|
Links
|
|
-----
|
|
* http://dns-sd.org/
|
|
* http://www.multicastdns.org/
|
|
* https://www.ietf.org/rfc/rfc6762.txt
|
|
* http://www.dns-sd.org/ServiceTypes.html
|
|
|
|
- https://www.avahi.org/
|
|
- https://github.com/lathiat/avahi
|
|
|
|
+ https://github.com/lathiat/avahi/blob/master/avahi-daemon/avahi-service.dtd
|
|
|
|
* https://github.com/lathiat/nss-mdns
|