dnstrace 项目使用教程

dnstrace 项目使用教程

dnstraceDNS resolution tracing tool项目地址:https://gitcode.com/gh_mirrors/dn/dnstrace

1、项目的目录结构及介绍

dnstrace 项目的目录结构如下：

dnstrace/
├── .gitignore
├── .goreleaser.yml
├── .travis.yml
├── LICENSE
├── README.md
├── Taskfile.yml
├── demo.gif
├── go.mod
├── go.sum
├── ipify.go
├── main.go
├── resolver.go

目录结构介绍

• .gitignore: 用于指定 Git 版本控制系统忽略的文件和目录。
• .goreleaser.yml: Goreleaser 配置文件，用于自动化构建和发布。
• .travis.yml: Travis CI 配置文件，用于持续集成。
• LICENSE: 项目许可证文件，采用 MIT 许可证。
• README.md: 项目说明文档，包含项目的基本信息和使用方法。
• Taskfile.yml: Task 工具的配置文件，用于自动化任务管理。
• demo.gif: 项目演示动画。
• go.mod 和 go.sum: Go 模块依赖管理文件。
• ipify.go: 用于获取公共 IP 地址的代码文件。
• main.go: 项目的主入口文件。
• resolver.go: DNS 解析器相关的代码文件。

2、项目的启动文件介绍

项目的启动文件是 main.go，它是整个项目的入口点。以下是 main.go 的主要内容：

package main

import (
    "flag"
    "fmt"
    "os"

    "github.com/rs/dnstrace/resolver"
)

func main() {
    // 解析命令行参数
    var (
        qtype    = flag.String("qtype", "A", "Query type (e.g., A, MX, NS)")
        qname    = flag.String("qname", "", "Query name (e.g., example.com)")
        server   = flag.String("server", "", "DNS server to query")
        edns     = flag.Bool("edns", true, "Enable EDNS support in queries")
        fallback = flag.Bool("fallback", true, "Fallback to 4K UDP message buffer size and then to TCP")
        ignoresub = flag.Bool("ignoresub", false, "Ignore tracing sub-requests when missing glue")
        port     = flag.Int("port", 53, "Use to send DNS queries to non-standard ports")
        recurse  = flag.Bool("recurse", false, "Toggle RD (recursion desired) flag in queries")
        tcp      = flag.Bool("tcp", false, "Use TCP when querying DNS servers")
        client   = flag.String("client", "", "Sends EDNS Client Subnet option with specified IP address")
    )
    flag.Parse()

    // 检查必要的参数
    if *qname == "" {
        fmt.Fprintf(os.Stderr, "Error: query name is required\n")
        os.Exit(1)
    }

    // 创建解析器并执行查询
    r := resolver.NewResolver(*edns, *fallback, *ignoresub, *port, *recurse, *tcp, *client)
    r.Trace(*qtype, *qname, *server)
}

启动文件介绍

• main.go 文件定义了命令行参数的解析和处理逻辑。
• 通过 flag 包解析用户输入的参数，包括查询类型、查询名称、DNS 服务器等。
• 创建 resolver.Resolver 对象并调用 Trace 方法执行 DNS 查询。

3、项目的配置文件介绍

dnstrace 项目没有显式的配置文件，其配置主要通过命令行参数进行。以下是主要的命令行参数及其说明：

• -qtype: 查询类型，例如 A、MX、NS 等。
• -qname: 查询名称，例如 example.com。
• -server: 要查询的 DNS 服务器。
• -edns: 是否启用 EDNS 支持。
• -fallback: 是否回退到 4K UDP 消息缓冲区大小，然后回退到 TCP。
• -ignoresub: 是否忽略缺失胶水的子请求。
• -port: 用于发送 DNS 查询

dnstraceDNS resolution tracing tool项目地址:https://gitcode.com/gh_mirrors/dn/dnstrace