Avahi 配置与使用教程

1. 项目目录结构及介绍

在 https://github.com/avahi/avahi.git 中下载或克隆 Avahi 项目后，您会看到以下主要目录结构：

.
├── autotools   # 自动构建工具相关脚本
├── configure.ac    # Autoconf 主配置文件
├── doc          # 文档与示例
│   ├── api      # API 文档
│   └── examples # 示例代码
├── po           # 多语言翻译文件
├── src          # 源代码目录
│   ├── avahi     # 核心库与组件源码
│   ├── client    # 客户端库
│   ├── common    # 共享组件
│   ├── daemon    # 服务守护进程
│   ├── tools     # 辅助工具
└── tests        # 单元测试与集成测试

• autotools 和 configure.ac 用于配置和构建 Avahi。
• doc/api 包含了 Avahi 的 API 文档。
• doc/examples 提供了如何使用 Avahi 的示例代码。
• src/* 目录包含了 Avahi 各个部分的源代码。
• po 存放多语言支持文件。
• tests 用于验证 Avahi 功能的测试用例。

2. 项目启动文件介绍

Avahi 的核心服务由一个守护进程（daemon）管理，主要的启动文件是 avahi-daemon。此程序负责监听网络流量，发布和发现服务。在大多数 Linux 系统中，可以通过以下方式启动 Avahi：

systemctl start avahi-daemon.service  # 对于使用 systemd 的系统
/etc/init.d/avahi-daemon start       # 对于使用 SysV init 的旧系统

要让 Avahi 在系统启动时自动运行，可以执行：

systemctl enable avahi-daemon.service  # 对于使用 systemd 的系统
chkconfig avahi-daemon on             # 对于使用 SysV init 的旧系统

此外，还有其他辅助工具，如 avahi-browse 可以用来浏览网络上的服务。

3. 项目的配置文件介绍

Avahi 的主要配置文件通常位于 /etc/avahi 目录下，包括：

• avahi-daemon.conf：这是 Avahi 守护进程的主要配置文件，定义了 Avahi 的行为，例如监听的接口、域名、日志级别等。

[server]
domain-name=my.local
log-facility=daemon
log-level=info
use-systemd=yes
allow-interfaces=eth0,wlan0
browse-domains=workgroup

• avahi-resolver.conf: 这个文件配置了 Avahi 的 DNS 解析器，但通常不需要修改。

配置文件的更改可能需要重启 Avahi 守护进程才能生效：

systemctl restart avahi-daemon.service

请注意，不同发行版可能会有所不同，具体配置细节应参考您的操作系统文档或 Avahi 的官方指南。如果您想进一步了解这些配置选项，可以在 /usr/share/doc/avahi*（或相应路径）中找到更详细的说明文档。

这个简单的教程应该帮助您了解 Avahi 的基本结构和配置。深入了解 Avahi 并充分利用其功能，建议查阅官方文档和示例代码。