1
0
Fork 0
mirror of https://github.com/roles-ansible/ansible_role_avahi_daemon.git synced 2024-08-16 15:09:48 +02:00
ansible_role_avahi_daemon/README.md
2021-09-02 11:02:00 +02:00

1.9 KiB

Galaxy 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:

---
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;