---
url: /configuration/shared/udp.md
description: 代理出站的 UDP 承载选择
---

# udp

所有代理出站共用的 UDP 承载方式。不写时由协议能力和路径决定最佳方式。

```yaml check
outbounds:
  proxy:
    type: shadowsocks
    server: proxy.example:8388
    method: none
    password: ""
    udp: xudp

route:
  final: proxy

dns:
  servers:
    default: {type: udp, address: 127.0.0.1:53}
  final: default
```

## 字段

### udp

* 类型：字符串枚举。
* 必填：可选。
* 取值：`native`、`over-tcp`、`xudp`、`connect-udp`、`off`。
* `native`：协议自己的 datagram、SOCKS5 association 或 Imina POST。
* `over-tcp`：sing 的 UDP over TCP。
* `xudp`：每条数据报带对端的 XUDP 流。
* `connect-udp`：naive server 的 CONNECT-UDP。
* `off`：拒绝 UDP。
* 默认：有原生 UDP 且可达时用原生；Kyoukai/Mirage 用 `xudp`；其余用 `over-tcp`。
* 限制：`direct` 和分组没有这个字段；经 `detour` 或 transport 时不能强制 `native`（Imina 例外）。

## 说明

`mayami check` 在出站摘要中说明实际承载。全锥 UDP 要求出口能发往任意目标，因此 `native`（Imina 例外）、`over-tcp` 和 `xudp` 可用；`connect-udp` 只适合单目标请求。

## 相关

* [出站总览](/configuration/outbound/)
* [共享块总览](/configuration/shared/)