NestingDNS 项目启动与配置教程

1. 项目目录结构及介绍

NestingDNS项目的目录结构如下：

NestingDNS/
├── bin/             # 存放可执行文件
│   ├── nestingdns   # NestingDNS的主程序
│   └── ...
├── contrib/         # 社区贡献的代码或工具
├── doc/             # 文档目录，包含项目文档和API文档
├── examples/        # 例子和示例配置文件
│   └── example.conf  # 示例配置文件
├── include/         # 包含项目所需的头文件
├── lib/             # 存放项目的库文件
├── scripts/         # 脚本文件，用于项目的安装、启动等操作
├── src/             # 源代码目录
│   ├── main.c       # 主程序文件
│   └── ...
└── test/            # 测试目录，包含单元测试和集成测试

• bin/：存放编译后生成的可执行文件。
• contrib/：社区贡献的代码或者工具。
• doc/：包含项目文档和API文档，方便开发者查阅。
• examples/：包含示例配置文件和示例使用方法。
• include/：项目的头文件，可能包含一些接口定义和宏定义。
• lib/：项目的库文件，可能包含一些基础功能模块。
• scripts/：包含项目启动、安装、配置等操作的脚本文件。
• src/：项目的源代码，是项目的核心部分。
• test/：包含对项目进行单元测试和集成测试的代码。

2. 项目的启动文件介绍

项目的启动文件位于bin/目录下，主程序为nestingdns。启动项目时，需要运行以下命令：

./bin/nestingdns

该命令会启动NestingDNS服务，默认情况下，它会监听本地端口并等待客户端的请求。

3. 项目的配置文件介绍

NestingDNS项目的配置文件位于examples/目录下，名为example.conf。配置文件采用标准的配置文件格式，如下所示：

[General]
# 设置监听的IP地址和端口
listen = 127.0.0.1:53

# 设置上级DNS服务器地址
upstreamDNS = 8.8.8.8
upstreamDNS = 8.8.4.4

# 设置日志文件路径
logFile = nestingdns.log

[Cache]
# 开启缓存功能
enable = true
# 设置缓存大小
size = 1000

[Filter]
# 设置过滤规则
blockList = domains.txt
allowList = domains.txt

开发者可以根据自己的需要修改配置文件中的参数。配置文件包含以下几个主要部分：

• [General]：通用设置，包括监听地址、端口、上级DNS服务器地址和日志文件路径等。
• [Cache]：缓存设置，可以开启或关闭缓存功能，并设置缓存大小。
• [Filter]：过滤规则设置，可以设置黑名单和白名单来过滤请求。

修改完配置文件后，可以使用以下命令启动项目，并加载新的配置：

./bin/nestingdns -c examples/example.conf

这样，NestingDNS就会根据提供的配置文件进行启动和运行。