---
url: /configuration/dns/server/h3.md
description: 通过 DNS over HTTP/3 询问上游
---

# HTTP/3

用 HTTP/3 上的 POST 询问 DoH 服务器。

```yaml check
dns:
  servers:
    up:
      type: h3
      address: 127.0.0.1:443
      path: /dns-query
      tls:
        server_name: dns.example
      headers:
        X-Asked-By: mayami
  final: up
```

## 字段

### type

* 类型：字符串。
* 必填：是，第一项。
* 取值：`h3`。

### address

* 类型：地址，可带端口。
* 必填：是。
* 默认端口：`443`。

### path

* 类型：字符串。
* 默认：`/dns-query`。
* 范围：必须以 `/` 开头，例如 `/dns-query`；配置检查会拒绝相对路径。

### via

* 类型：出站名或 `RULES`。
* 必填：可选。
* 行为：使用出站 UDP 承载 QUIC。

### tls

* 类型：[TLS 客户端占位页](/configuration/shared/tls-client)。
* 默认：公共根证书。

### headers

* 类型：字符串到字符串的映射。
* 默认：空。

### domain_resolver

* 类型：DNS 服务器名。
* 必填：可选。

## 说明

HTTP/3 使用 rustls 的 QUIC TLS，并固定自己的 ALPN；不会接受 BoringSSL/cronet 的 Chrome 指纹选项。

## 相关

* [DNS 服务器总览](/configuration/dns/server/)
* [共享 TLS 客户端](/configuration/shared/tls-client)