TinyDOH 项目使用教程

TinyDOH 项目使用教程

tinydohMinimal DNS-Over-HTTPS Server项目地址:https://gitcode.com/gh_mirrors/ti/tinydoh

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

TinyDOH 项目的目录结构如下：

tinydoh/
├── cmd/
│   └── tinydoh/
│       └── main.go
├── config/
│   └── config.go
├── dns/
│   ├── client.go
│   ├── message.go
│   ├── server.go
│   └── types.go
├── go.mod
├── go.sum
└── README.md

目录结构介绍

• cmd/: 包含项目的入口文件。
  • tinydoh/: 具体的入口文件目录。
    • main.go: 项目的启动文件。
• config/: 包含项目的配置文件。
  • config.go: 配置文件的定义和处理逻辑。
• dns/: 包含 DNS 相关的处理逻辑。
  • client.go: DNS 客户端逻辑。
  • message.go: DNS 消息处理逻辑。
  • server.go: DNS 服务器逻辑。
  • types.go: DNS 相关的数据类型定义。
• go.mod 和 go.sum: Go 模块文件，用于管理项目的依赖。
• README.md: 项目说明文档。

2. 项目的启动文件介绍

项目的启动文件位于 cmd/tinydoh/main.go。该文件主要负责初始化配置、启动 DNS 服务器等操作。以下是 main.go 的主要内容：

package main

import (
    "log"
    "tinydoh/config"
    "tinydoh/dns"
)

func main() {
    // 加载配置
    cfg, err := config.LoadConfig()
    if err != nil {
        log.Fatalf("Failed to load config: %v", err)
    }

    // 启动 DNS 服务器
    server := dns.NewServer(cfg)
    if err := server.Start(); err != nil {
        log.Fatalf("Failed to start server: %v", err)
    }
}

启动文件介绍

• main 函数：项目的入口函数，负责加载配置和启动 DNS 服务器。
• config.LoadConfig()：加载配置文件并返回配置对象。
• dns.NewServer(cfg)：根据配置创建 DNS 服务器实例。
• server.Start()：启动 DNS 服务器。

3. 项目的配置文件介绍

项目的配置文件定义在 config/config.go 中。该文件主要定义了配置的结构体和加载配置的方法。以下是 config.go 的主要内容：

package config

import (
    "encoding/json"
    "os"
)

type Config struct {
    ListenAddress string `json:"listen_address"`
    UpstreamDNS   string `json:"upstream_dns"`
}

func LoadConfig() (*Config, error) {
    file, err := os.Open("config.json")
    if err != nil {
        return nil, err
    }
    defer file.Close()

    var cfg Config
    decoder := json.NewDecoder(file)
    if err := decoder.Decode(&cfg); err != nil {
        return nil, err
    }

    return &cfg, nil
}

配置文件介绍

• Config 结构体：定义了配置的结构，包括 ListenAddress（监听地址）和 UpstreamDNS（上游 DNS 地址）。
• LoadConfig 函数：负责从 config.json 文件中读取配置并解析为 Config 结构体。

以上是 TinyDOH 项目的目录结构、启动文件和配置文件的详细介绍。希望这份文档能帮助你更好地理解和使用该项目。

tinydohMinimal DNS-Over-HTTPS Server项目地址:https://gitcode.com/gh_mirrors/ti/tinydoh