Unbound DNS服务器中IPv4/IPv6解析配置的正确使用方式

在配置Unbound DNS服务器时，管理员经常需要控制DNS查询的IPv4/IPv6协议栈使用。近期有用户反馈在配置do-ipv4和do-ipv6参数时遇到语法错误，这实际上是一个常见的配置误区。

正确参数名称解析

Unbound的配置文件中，控制协议栈使用的参数名称应为：

• do-ip4（而非do-ipv4）
• do-ip6（而非do-ipv6）

这两个核心参数用于控制DNS服务器是否启用对应的IP协议栈：

• 设置为yes时启用该协议栈
• 设置为no时禁用该协议栈

相关扩展参数

除了基础协议栈开关外，Unbound还提供了两个重要的优先级控制参数：

1. prefer-ip4：当两种协议都可用时优先使用IPv4
2. prefer-ip6：当两种协议都可用时优先使用IPv6

这些参数在双栈网络环境中特别有用，可以帮助管理员优化DNS查询路径。

典型配置示例

server:
    # 协议栈控制
    do-ip4: yes
    do-ip6: no
    
    # 查询优化参数
    prefer-ip4: yes
    
    # 网络接口配置
    interface: 192.168.204.1
    access-control: 192.168.0.0/16 allow

配置验证要点

1. 使用unbound-checkconf工具验证配置文件语法
2. 注意参数名称的准确性（特别是ip4/ip6的缩写形式）
3. 确保参数层级正确（这些参数应位于server:部分下）

通过正确使用这些参数，管理员可以精确控制Unbound DNS服务器的网络协议行为，满足不同网络环境下的部署需求。对于需要禁用IPv6的环境，将do-ip6设为no即可完全禁用IPv6 DNS查询功能。