---
url: /configuration/inbound/socks.md
description: SOCKS4、SOCKS4a 和 SOCKS5 服务端入站
---

# socks

接受 SOCKS TCP 与 SOCKS5 UDP association。

```yaml check
inbounds:
  socks:
    type: socks
    listen: 127.0.0.1:1080
    users:
      alice: secret

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

## 字段

### type

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

### listen

* 类型：`SocketAddr`。
* 必填：是。

### tls

* 类型：[TLS 服务端块](/configuration/shared/tls-server)。
* 必填：可选。
* 默认：明文。
* 行为：有 TLS 时在 SOCKS 之前终止 TLS。

### users

* 类型：名字到密码的映射。
* 必填：可选。
* 默认：空；空表示不认证。
* SOCKS4 没有密码，只要求用户名已在表中。

## 说明

支持 TCP 和 UDP；`network`、`udp_timeout`、`full_cone` 都可用。可以套 TCP stream 的 `transport`，此时未通过该 transport 的请求可以交给 `fallback`。

## 相关

* [共享 listen](/configuration/shared/listen)
* [共享 users](/configuration/shared/users)
* [共享 fallback](/configuration/shared/fallback)