sing-box/docs/configuration/shared/listen.zh.md

---

icon: material/delete-clock

!!! quote "sing-box 1.11.0 中的更改"

:material-delete-clock: [sniff](#sniff)  
:material-delete-clock: [sniff_override_destination](#sniff_override_destination)  
:material-delete-clock: [sniff_timeout](#sniff_timeout)  
:material-delete-clock: [domain_strategy](#domain_strategy)  
:material-delete-clock: [udp_disable_domain_unmapping](#udp_disable_domain_unmapping)

结构

{
  "listen": "::",
  "listen_port": 5353,
  "tcp_fast_open": false,
  "tcp_multi_path": false,
  "udp_fragment": false,
  "udp_timeout": "5m",
  "detour": "another-in",
  "sniff": false,
  "sniff_override_destination": false,
  "sniff_timeout": "300ms",
  "domain_strategy": "prefer_ipv6",
  "udp_disable_domain_unmapping": false
}

字段	可用上下文
listen	需要监听 TCP 或 UDP。
listen_port	需要监听 TCP 或 UDP。
tcp_fast_open	需要监听 TCP。
tcp_multi_path	需要监听 TCP。
udp_timeout	需要组装 UDP 连接。

字段

listen

==必填==

监听地址。

listen_port

监听端口。

tcp_fast_open

启用 TCP Fast Open。

tcp_multi_path

!!! warning ""

需要 Go 1.21。

启用 TCP Multi Path。

udp_fragment

启用 UDP 分段。

udp_timeout

UDP NAT 过期时间。

默认使用 5m。

detour

如果设置，连接将被转发到指定的入站。

需要目标入站支持，参阅 注入支持。

sniff

!!! failure "已在 sing-box 1.11.0 废弃"

入站字段已废弃且将在 sing-box 1.12.0 中被移除，参阅 [迁移指南](/migration/#migrate-legacy-inbound-fields-to-rule-actions).

启用协议探测。

参阅 协议探测

sniff_override_destination

!!! failure "已在 sing-box 1.11.0 废弃"

入站字段已废弃且将在 sing-box 1.12.0 中被移除。

用探测出的域名覆盖连接目标地址。

如果域名无效（如 Tor），将不生效。

sniff_timeout

!!! failure "已在 sing-box 1.11.0 废弃"

入站字段已废弃且将在 sing-box 1.12.0 中被移除，参阅 [迁移指南](/migration/#migrate-legacy-inbound-fields-to-rule-actions).

探测超时时间。

默认使用 300ms。

domain_strategy

!!! failure "已在 sing-box 1.11.0 废弃"

入站字段已废弃且将在 sing-box 1.12.0 中被移除，参阅 [迁移指南](/migration/#migrate-legacy-inbound-fields-to-rule-actions).

可选值： prefer_ipv4 prefer_ipv6 ipv4_only ipv6_only。

如果设置，请求的域名将在路由之前解析为 IP。

如果 sniff_override_destination 生效，它的值将作为后备。

udp_disable_domain_unmapping

!!! failure "已在 sing-box 1.11.0 废弃"

入站字段已废弃且将在 sing-box 1.12.0 中被移除，参阅 [迁移指南](/migration/#migrate-legacy-inbound-fields-to-rule-actions).

如果启用，对于地址为域的 UDP 代理请求，将在响应中发送原始包地址而不是映射的域。

此选项用于兼容不支持接收带有域地址的 UDP 包的客户端，如 Surge。