---
url: /configuration/shared/listen.md
description: 监听 socket、接口、keepalive、PROXY 协议和入站承载选项
---

# listen

会监听 socket 的入站共用的监听与承载字段。`tap`、`tun`、`capture` 没有普通监听 socket，不使用这里的字段。

```yaml check
inbounds:
  proxy:
    type: mixed
    listen: 127.0.0.1:7890
    interface: lo
    tcp_keep_alive: 5m
    tcp_keep_alive_interval: 75s
    tcp_multi_path: false
    proxy_protocol: false
    network: tcp
    udp_timeout: 5m
    full_cone: false

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

## 字段

### listen

* 类型：`SocketAddr`。
* 必填：是。
* 取值：IP 字面量和端口，例如 `127.0.0.1:7890`、`[::]:443`。
* 行为：不在这里解析主机名。

### interface

* 类型：接口名。
* 默认：不限定。
* 行为：监听 socket 绑定到该接口。

### tcp_keep_alive

* 类型：时长。
* 默认：不主动设置。

### tcp_keep_alive_interval

* 类型：时长。
* 默认：系统默认。

### tcp_multi_path

* 类型：布尔值。
* 默认：`false`。

### tcp_congestion

* 类型：字符串。
* 默认：系统拥塞控制。
* 限制：显式设置只在 Linux 上可用。

### proxy_protocol

* 类型：布尔值。
* 默认：`false`。
* 行为：每条 TCP 连接先读取 PROXY v1 或 v2 头，并用头里的客户端地址作为来源。
* 限制：只接 UDP 的配置不能依赖它；头不完整或不合法时连接失败。

### network

* 类型：字符串枚举。
* 默认：同时接受 TCP 和 UDP。
* 取值：`tcp`、`udp`。
* 限制：`udp` 只适用于 Shadowsocks 这类能直接接数据报的入站；其他代理只在流里承载 UDP。

### udp_timeout

* 类型：时长。
* 默认：`5m`。
* 限制：`dns` 和 `direct` 入站不接受。

### full_cone

* 类型：布尔值。
* 默认：`false`。
* 行为：同一客户端、同一路径的 UDP 对外共用一个映射。
* 限制：`dns` 和 `direct` 入站不接受。

## 说明

字段与入站自己的 `type`、协议字段平铺在一个映射里。解析器先取出监听和承载字段，再把剩余字段交给协议。

## 相关

* [入站总览](/configuration/inbound/)
* [共享块总览](/configuration/shared/)