---
url: /configuration/inbound/shadowsocks.md
description: Shadowsocks TCP/UDP 服务端入站
---

# shadowsocks

接受 Shadowsocks 客户端，每个目标连接由规则决定去向。

```yaml check
inbounds:
  ss:
    type: shadowsocks
    listen: 0.0.0.0:8388
    method: 2022-blake3-aes-128-gcm
    password: AAECAwQFBgcICQoLDA0ODw==

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

## 字段

### type

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

### listen

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

### method

* 类型：Shadowsocks cipher 名。
* 必填：是。
* 取值：`2022-blake3-aes-128-gcm`、`2022-blake3-aes-256-gcm`、`2022-blake3-chacha20-poly1305`、`aes-128-gcm`、`aes-256-gcm`、`chacha20-ietf-poly1305`、`none`。

### password

* 类型：字符串。
* 必填：是。
* 取值：AEAD-2022 要求标准 Base64 的对应长度密钥；其他方法按其 key 长度接受。

有 `users` 时，`password` 是服务器自己的密钥。

### users

* 类型：名字到密码的映射。
* 必填：可选。
* 默认：空。
* AEAD-2022 AES 的用户客户端写 `服务器密钥:用户密钥`。

### replay

* 类型：字符串枚举。
* 必填：可选。
* 默认：旧方法接受重放，AEAD-2022 始终拒绝。
* 取值：`detect`、`reject`。
* `detect` 只记录并继续；`reject` 拒绝。

### plugin

* 类型：字符串。
* 必填：可选。
* 默认：无。
* 取值：SIP003 插件程序。

### plugin_opts

* 类型：字符串。
* 必填：可选。
* 默认：无。
* 取值：原样交给 SIP003 插件。

## 说明

Shadowsocks 是唯一允许 `network: udp` 的代理入站。它天然同时承载 TCP 与 UDP；`udp_timeout` 和 `full_cone` 可用。`plugin` 与 `transport` 互斥。

公共字段见 [入站总览](/configuration/inbound/)，下载/分享链接的公共块先见 [users](/configuration/shared/users) 和 [transport](/configuration/shared/transport) 占位页。

## 相关

* [共享 users](/configuration/shared/users)
* [共享 UDP](/configuration/shared/udp)