Golang FQDN列表打包与解包工具 - hostutils使用指南

hostutils是一个用于处理FQDN(完全限定域名)列表打包与解包的Golang工具库，适用于域名批量处理、网络配置管理等场景。

安装

go get github.com/example/hostutils

核心功能

1. FQDN列表打包

将多个FQDN打包成紧凑格式，减少存储空间和传输带宽。

package main

import (
	"fmt"
	"github.com/example/hostutils/pkg/packer"
)

func main() {
	fqdns := []string{
		"www.example.com",
		"api.example.com",
		"blog.example.org",
		"static.example.net",
	}

	// 打包FQDN列表
	packedData, err := packer.PackFQDNs(fqdns)
	if err != nil {
		fmt.Printf("打包失败: %v\n", err)
		return
	}

	fmt.Printf("打包后数据(%d字节): %x\n", len(packedData), packedData)
}

2. FQDN列表解包

将打包后的数据还原为原始FQDN列表。

package main

import (
	"fmt"
	"github.com/example/hostutils/pkg/packer"
)

func main() {
	// 假设这是之前打包的数据
	packedData := []byte{0x03, 0x77, 0x77, 0x77, 0x07, 0x65, 0x78, 0x61, 0x6d, 0x70, 0x6c, 0x65, 0x03, 0x63, 0x6f, 0x6d, 0x00}

	// 解包数据
	fqdns, err := packer.UnpackFQDNs(packedData)
	if err != nil {
		fmt.Printf("解包失败: %v\n", err)
		return
	}

	fmt.Println("解包后的FQDN列表:")
	for _, fqdn := range fqdns {
		fmt.Println(fqdn)
	}
}

3. FQDN验证与规范化

package main

import (
	"fmt"
	"github.com/example/hostutils/pkg/validator"
)

func main() {
	testDomains := []string{
		"example.com",
		"sub.example.com",
		"invalid-.domain.com",
		"toolongdomainnamethatiswaybeyondthemaximumallowedlengthof63characters.com",
	}

	for _, domain := range testDomains {
		normalized, err := validator.NormalizeFQDN(domain)
		if err != nil {
			fmt.Printf("'%s' 验证失败: %v\n", domain, err)
		} else {
			fmt.Printf("'%s' -> 规范化: '%s'\n", domain, normalized)
		}
	}
}

4. 批量处理工具

package main

import (
	"fmt"
	"github.com/example/hostutils/pkg/batch"
)

func main() {
	processor := batch.NewFQDNProcessor()

	// 添加处理函数
	processor.AddHandler(func(fqdn string) string {
		return "https://" + fqdn + "/api"
	})

	// 批量处理
	fqdns := []string{"api.example.com", "service.example.org"}
	results := processor.Process(fqdns)

	fmt.Println("处理结果:")
	for _, result := range results {
		fmt.Println(result)
	}
}

高级功能

1. 差异比较

package main

import (
	"fmt"
	"github.com/example/hostutils/pkg/diff"
)

func main() {
	oldList := []string{"a.example.com", "b.example.com", "c.example.com"}
	newList := []string{"b.example.com", "c.example.com", "d.example.com"}

	added, removed := diff.CompareFQDNLists(oldList, newList)

	fmt.Println("新增的FQDN:")
	for _, fqdn := range added {
		fmt.Println(fqdn)
	}

	fmt.Println("\n移除的FQDN:")
	for _, fqdn := range removed {
		fmt.Println(fqdn)
	}
}

2. 通配符支持

package main

import (
	"fmt"
	"github.com/example/hostutils/pkg/wildcard"
)

func main() {
	matcher := wildcard.NewMatcher([]string{"*.example.com", "api.*.org"})

	testDomains := []string{
		"www.example.com",
		"api.service.org",
		"blog.example.net",
	}

	for _, domain := range testDomains {
		if matcher.Match(domain) {
			fmt.Printf("'%s' 匹配通配符规则\n", domain)
		} else {
			fmt.Printf("'%s' 不匹配任何规则\n", domain)
		}
	}
}

性能优化建议

1. 对于大规模FQDN列表(10万+)，建议使用流式处理
2. 打包时启用压缩可减少30-70%的体积
3. 使用对象池重用内存减少GC压力

// 流式处理示例
streamProcessor := packer.NewStreamPacker()
for _, fqdn := range hugeFQDNList {
    streamProcessor.Write(fqdn)
}
packedData := streamProcessor.Finalize()

hostutils库提供了灵活高效的FQDN处理能力，适用于DNS工具、网络配置管理、安全扫描等各种场景。