Avahi 是 Linux 下轻量的mDNS/DNS-SD 零配置网络服务，对应 Windows 的 Bonjour、macOS 的原生零配置解析，安装后无需手动配置，就能实现局域网内主机名.local的自动 IP 解析，替代手动修改/etc/hosts，完美实现类似 Windows 的局域网主机名解析效果，仅需几步即可完成部署和使用。
一、Avahi 安装（主流 Linux 发行版全覆盖）
1. Debian/Ubuntu 系列（Ubuntu 20.04/22.04、Deepin、Kali 等）
bash
<?XML:NAMESPACE PREFIX = “[default] http://www.w3.org/2000/svg” NS = “http://www.w3.org/2000/svg” />
运行
# 先更新软件源，再安装核心包+工具包
sudo apt update && sudo apt install avahi-daemon avahi-utils -y
avahi-daemon：Avahi 核心服务进程，负责局域网 mDNS 广播和解析avahi-utils：辅助工具包（含avahi-resolve/avahi-browse等实用命令）
2. CentOS/RHEL 系列（CentOS 7/8/9、Rocky Linux、AlmaLinux 等）
CentOS 需先启用EPEL 源（Avahi 包在 EPEL 仓库），再安装：
bash
运行
# 安装EPEL源（已安装则跳过）
sudo yum install epel-release -y
# 安装Avahi核心包+工具包
sudo yum install avahi avahi-tools -y
3. Fedora 系列
bash
运行
sudo dnf install avahi-daemon avahi-utils -y
4. Arch Linux/Manjaro 系列
bash
运行
sudo pacman -S avahi avahi-utils -y
二、Avahi 服务管理（核心步骤，必须确保服务运行）
Avahi 依赖avahi-daemon进程，安装后需启动服务并设置开机自启，所有发行版均使用systemd命令（通用），一步到位：
bash
运行
# 1. 启动Avahi服务
sudo systemctl start avahi-daemon
# 2. 设置开机自启（重启系统后自动运行，避免每次手动启动）
sudo systemctl enable avahi-daemon
# 3. 验证服务状态（关键：显示active(running)即为正常）
sudo systemctl status avahi-daemon
服务状态正常输出示例
plaintext
● avahi-daemon.service - Avahi mDNS/DNS-SD Stack
Loaded: loaded (/lib/systemd/system/avahi-daemon.service; enabled; vendor preset: enabled)
Active: active (running) since Wed 2026-02-04 10:00:00 CST; 10s ago
Docs: man:avahi-daemon(8)
Main PID: 1234 (avahi-daemon)
Tasks: 2 (limit: 19000)
Memory: 1.2M
CGroup: /system.slice/avahi-daemon.service
├─1234 avahi-daemon: running [linux-server.local]
└─1235 avahi-daemon: chroot helper
从状态中能直接看到本机的解析域名：主机名.local（如上述linux-server.local）。
常见服务问题解决
若执行status显示failed，大概率是端口被占用（mDNS 默认用 UDP 5353），执行以下命令排查并释放端口：
bash
运行
# 查找占用5353端口的进程
sudo lsof -i :5353
# 杀死占用进程（替换PID为实际查到的进程号）
sudo kill -9 PID
# 重新启动Avahi
sudo systemctl restart avahi-daemon
三、防火墙放行（关键！否则局域网设备无法发现）
Avahi 基于UDP 5353 端口进行 mDNS 广播和解析，若 Linux 开启了防火墙（ufw/firewalld），必须放行该端口，否则局域网其他设备无法解析本机主机名.local，本机也无法解析其他设备。
1. Ubuntu/Debian 系列（用 ufw 防火墙）
bash
运行
# 放行UDP 5353端口
sudo ufw allow 5353/udp
# 重新加载防火墙规则
sudo ufw reload
# 验证放行结果
sudo ufw status
2. CentOS/RHEL/Fedora 系列（用 firewalld 防火墙）
bash
运行
# 永久放行UDP 5353端口（--permanent 表示重启防火墙生效）
sudo firewall-cmd --permanent --add-port=5353/udp
# 重新加载防火墙规则
sudo firewall-cmd --reload
# 验证放行结果
sudo firewall-cmd --list-ports
四、Avahi 核心使用方法（解析 / 查询 / 发现）
安装并配置完成后，无需任何额外配置，直接在局域网内使用主机名.local即可实现 IP 解析，支持ping/ssh/curl等所有网络命令，同时提供专属工具实现更灵活的查询。
基础使用：直接解析局域网主机名.local
1. 查看本机解析域名
先通过hostname查看本机主机名，拼接.local即为 Avahi 解析域名：
bash
运行
hostname # 输出示例：ubuntu-pc → 解析域名为ubuntu-pc.local
2. 局域网内解析 / 访问（核心功能）
-
ping 测试解析（最直接验证）：
在局域网另一台设备（Linux/Windows/macOS）上，直接 ping 本机的
主机名.local，会自动解析到对应 IP：bash
运行
# 示例：ping ubuntu-pc.local，-c 2 表示只发2个包 ping ubuntu-pc.local -c 2正常输出（已成功解析 IP）：
plaintext
PING ubuntu-pc.local (192.168.1.105) 56(84) bytes of data. 64 bytes from 192.168.1.105 (192.168.1.105): icmp_seq=1 ttl=64 time=0.520 ms 64 bytes from 192.168.1.105 (192.168.1.105): icmp_seq=2 ttl=64 time=0.480 ms -
ssh 远程连接（实用场景）：
无需记 IP，直接用
主机名.local连接局域网内的 Linux 设备：bash
运行
ssh root@ubuntu-pc.local # 替换为实际用户名和主机名.local -
Windows/macOS 兼容访问：
- Windows：打开命令提示符 / PowerShell，直接执行
ping ubuntu-pc.local -n 2即可解析； - macOS：打开终端，用法和 Linux 完全一致。
- Windows：打开命令提示符 / PowerShell，直接执行
进阶使用：Avahi 专属工具（精准查询 / 发现）
安装的avahi-utils/avahi-tools包含多个实用命令，可实现反向解析（IP 查主机名）、扫描局域网所有 Avahi 设备等功能。
1. avahi-resolve：精准解析（主机名→IP / IP→主机名）
（1）主机名转 IP（替代 ping，仅输出 IP，适合脚本）
bash
运行
# 语法：avahi-resolve -n 主机名.local
avahi-resolve -n ubuntu-pc.local
输出：ubuntu-pc.local 192.168.1.105
（2）IP 转主机名（反向解析，查局域网 IP 对应的设备名）
bash
运行
# 语法：avahi-resolve -a 目标IP
avahi-resolve -a 192.168.1.105
输出：192.168.1.105 ubuntu-pc.local
2. avahi-browse：扫描局域网所有 Avahi 设备
一次性列出局域网内所有开启了 mDNS/Avahi/Bonjour的设备（Linux/Windows 10+/macOS/ 智能家居），包含设备名、IP、服务类型：
bash
运行
# 扫描所有局域网设备（-a 表示所有类型）
avahi-browse -a
3. avahi-discover：图形化扫描（有桌面环境时使用）
若 Linux 安装了图形桌面（如 GNOME/KDE），可直接打开图形化工具，可视化查看局域网设备，操作更直观：
bash
运行
avahi-discover
五、Avahi 常用配置修改（可选，默认无需改）
Avahi 安装后默认配置即可满足 99% 的使用场景，无需修改配置文件；若有特殊需求（如修改主机名、禁用 IPv6、修改广播域），可编辑核心配置文件/etc/avahi/avahi-daemon.conf。
1. 编辑配置文件
bash
运行
sudo vim /etc/avahi/avahi-daemon.conf
2. 常用配置项修改（取消注释即可生效）
ini
[server]
host-name=linux-node # 修改本机Avahi解析的主机名（默认和系统主机名一致）
domain-name=local # 解析后缀（默认local，不建议改）
use-ipv4=yes # 启用IPv4（必开，局域网主要用IPv4）
use-ipv6=no # 禁用IPv6（避免解析干扰，可选）
allow-interfaces=eth0 # 仅在指定网卡广播（如eth0/ens33，默认所有网卡）
[wide-area]
enable-wide-area=no # 禁用广域网解析，仅局域网生效（推荐）
3. 配置生效
修改配置后，重启 Avahi 服务即可生效：
bash
运行
sudo systemctl restart avahi-daemon
六、Avahi 卸载（如需清理）
若后续无需使用，可一键卸载，清理所有相关包和配置：
Debian/Ubuntu 系列
bash
运行
sudo apt remove avahi-daemon avahi-utils -y && sudo apt autoremove -y
CentOS/RHEL 系列
bash
运行
sudo yum remove avahi avahi-tools -y
Arch Linux/Manjaro 系列
bash
运行
sudo pacman -Rns avahi avahi-utils -y
七、常见问题排查
1. 局域网设备 ping 主机名.local 提示未知的主机
- 检查本机 Avahi 服务是否正常运行（
systemctl status avahi-daemon）； - 检查防火墙是否放行 UDP 5353 端口（核心原因）；
- 确认两台设备在同一局域网（同一网段，如 192.168.1.x）。
2. 解析成功但延迟高
- 禁用 IPv6（修改
avahi-daemon.conf中use-ipv6=no）； - 关闭其他局域网解析服务（如 Samba 的 nmbd），避免冲突。
3. Windows 设备无法解析主机名.local
- Windows 10/11 需安装Bonjour 服务（微软商店搜索 Bonjour 或安装 iTunes，自带 Bonjour）；
- 确保 Windows 防火墙未拦截 mDNS 流量（允许 “Bonjour 服务” 的网络访问）。
核心总结
- Avahi 核心是安装 + 启动服务 + 放行 5353/UDP 端口，三步即可实现局域网零配置解析；
- 所有解析均为
主机名.local格式，无需记 IP，跨 Linux/Windows/macOS 兼容； - 轻量无依赖，仅占几百 KB 内存，比 Samba 更适合仅需局域网解析的场景，无多余功能冗余。
![clip_image001[1]](https://zhanghao1983.aichiao.com/wp-content/uploads/2021/02/clip_image0011.png "clip_image001[1]"){kind=small}
![clip_image001[2]](https://zhanghao1983.aichiao.com/wp-content/uploads/2021/02/clip_image0012.png "clip_image001[2]"){kind=small}
![clip_image001[3]](https://zhanghao1983.aichiao.com/wp-content/uploads/2021/02/clip_image0013.png "clip_image001[3]"){kind=small}