---
title: "Shadowsocks"
description: "Potatso қолдайтын Shadowsocks шифрлары, плагиндері, сілтемелері және мүмкіндіктері."
---

> Documentation Index
> Fetch the complete documentation index at: https://potatso.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Shadowsocks

Shadowsocks серверін **шифр** және **құпиясөз**, сондай-ақ қосылымды жасыратын қалауыңызша **плагин** сипаттайды. Potatso шифрды және, егер болса, плагинді қолдаса, серверге қосылады. Серверіңіздің параметрлерін, провайдеріңіз көрсеткендей не оның `ss://` сілтемесіндегідей, тексеру үшін төмендегі кестелерді пайдаланыңыз.

Shadowsocks серверін қолмен, [`ss://` сілтемесімен](#links) не мыналарды импорттау арқылы қосуға болады:

- Clash не Mihomo жазылымы,
- файлдан не сілтемеден [SIP008](https://shadowsocks.org/doc/sip008.html) онлайн конфигурациясы,
- shadowsocks-rust не shadowsocks-libev `config.json` файлы,
- Surge конфигурациясы не Xray немесе V2Ray конфигурациясы.

## Шифрлар {#ciphers}

Сервер ұсынса, 2022 шифрын, одан кейін AEAD шифрын таңдаңыз. Ағындық шифрлардың белгілі осалдықтары бар: оларды басқа ештеңе ұсынбайтын серверлермен ғана пайдаланыңыз.

| Шифр | Түрі | Қолдау |
| --- | --- | --- |
| `2022-blake3-aes-128-gcm`, `2022-blake3-aes-256-gcm` | 2022 | ✅ [Көп пайдаланушылы](#multi-user) |
| `2022-blake3-chacha20-poly1305`, `2022-blake3-chacha8-poly1305` | 2022 | ✅ |
| `aes-128-gcm`, `aes-192-gcm`, `aes-256-gcm` | AEAD | ✅ |
| `chacha20-ietf-poly1305`, `xchacha20-ietf-poly1305` | AEAD | ✅ |
| `aes-128-ccm`, `aes-256-ccm`, `aes-128-gcm-siv`, `aes-256-gcm-siv` | AEAD | ✅ |
| `sm4-gcm`, `sm4-ccm` | AEAD | ✅ |
| `aes-128-ctr`, `aes-192-ctr`, `aes-256-ctr` | Ағындық | ✅ |
| `aes-128-cfb`, `aes-192-cfb`, `aes-256-cfb` (`-cfb128` деп те жазылады) | Ағындық | ✅ |
| `aes-128-cfb1`, `aes-192-cfb1`, `aes-256-cfb1` | Ағындық | ✅ |
| `aes-128-cfb8`, `aes-192-cfb8`, `aes-256-cfb8` | Ағындық | ✅ |
| `aes-128-ofb`, `aes-192-ofb`, `aes-256-ofb` | Ағындық | ✅ |
| `camellia-128-ctr`, `camellia-192-ctr`, `camellia-256-ctr` | Ағындық | ✅ |
| `camellia-128-cfb`, `camellia-192-cfb`, `camellia-256-cfb` (`-cfb128` деп те жазылады) | Ағындық | ✅ |
| `camellia-128-cfb1`, `camellia-192-cfb1`, `camellia-256-cfb1` | Ағындық | ✅ |
| `camellia-128-cfb8`, `camellia-192-cfb8`, `camellia-256-cfb8` | Ағындық | ✅ |
| `camellia-128-ofb`, `camellia-192-ofb`, `camellia-256-ofb` | Ағындық | ✅ |
| `chacha20-ietf`, `chacha20`, `salsa20` | Ағындық | ✅ |
| `bf-cfb`, `rc4-md5`, `rc4`, `table` | Ағындық | ✅ |
| `none` (`plain` деп те жазылады) | Шифрлаусыз | ✅ |
| `cast5-cfb`, `des-cfb`, `idea-cfb`, `rc2-cfb`, `seed-cfb`, `rc4-md5-6` | Ағындық | ❌ Тек ShadowsocksR үшін |
| `xchacha20`, `xsalsa20` | Ағындық | ❌ |

Атаулар регистрге сезімтал емес, сондықтан `AES-256-GCM` дәл `aes-256-gcm` сияқты жұмыс істейді.

`none` трафигіңізді шифрламай жібереді. Оны тек қосылымды өзі шифрлайтын плагинмен, мысалы, TLS бар v2ray-plugin-мен пайдаланыңыз.

Қолдау көрсетілетін әр шифр кемінде бір нақты Shadowsocks серверінде сыналған: [shadowsocks-rust](https://github.com/shadowsocks/shadowsocks-rust), [sing-box](https://sing-box.sagernet.org/) не түпнұсқа Python сервері. Жоғарыдағы AEAD шифрларының ішінде `aes-*-ccm`, `aes-*-gcm-siv` және `sm4-*` шифрларын тек shadowsocks-rust серверлері ұсынады, ал оларды пайдаланатын провайдерлер аз.

### 2022 кілттері {#2022-keys}

2022 шифрлары ([SIP022](https://shadowsocks.org/doc/sip022.html)) құпиясөзді пайдаланбайды. Олар кілтті пайдаланады: шифр талап ететін ұзындықтағы, Base64 кодталған кездейсоқ байттар. `2022-blake3-aes-128-gcm` үшін 16 байттық кілт, ал басқа 2022 шифрлары үшін 32 байттық кілт қажет. Кілтті серверіңізде қандай болса, дәл солай пайдаланыңыз.

Potatso ұзындығы қате кілтпен не Base64 емес құпиясөзбен қосылмайды. Серверіңіз үшін жаңа кілт жасау үшін `2022-blake3-aes-128-gcm` үшін `openssl rand -base64 16`, ал басқа 2022 шифрлары үшін `openssl rand -base64 32` пәрменін іске қосыңыз.

### Көп пайдаланушылы серверлер {#multi-user}

2022 сервері бір портты бірнеше пайдаланушы арасында бөлісе алады ([SIP023](https://shadowsocks.org/doc/sip023.html)). Әр пайдаланушының өз кілті бар. Мұндай серверлер үшін құпиясөзді сервер кілті мен өз пайдаланушы кілтіңіз ретінде, қос нүктемен бөліп орнатыңыз:

```text
server-key:user-key
```

Көп пайдаланушылы серверлерді тек `2022-blake3-aes-128-gcm` және `2022-blake3-aes-256-gcm` қолдайды.

## Плагиндер {#plugins}

Плагин Shadowsocks қосылымын анықтауды қиындату үшін орап тастайды. Potatso-да бұл плагиндер кірістірілген, сондықтан басқа ештеңе орнатудың қажеті жоқ.

| Плагин | Плагин атаулары | Қолдау | UDP |
| --- | --- | --- | --- |
| Simple Obfs | `obfs-local`, `simple-obfs`, `obfs` | ✅ `obfs=http` және `obfs=tls` | Серверге плагинсіз жіберіледі |
| v2ray-plugin | `v2ray-plugin` | ✅ WebSocket, TLS-пен не онсыз. QUIC режиміне қолдау көрсетілмейді. | ❌ |
| gost-plugin | `gost-plugin` | ✅ WebSocket, TLS-пен не онсыз | ❌ |
| ShadowTLS | `shadow-tls` | ✅ 1, 2 және 3 нұсқалар | ❌ |
| Restls | `restls` | ✅ | ❌ |
| JLS | `jls` | ✅ | ❌ |

Potatso басқа плагинді қажет ететін серверді импорттамайды:

- Cloak, xray-plugin және басқа плагиндер — құрылғыңыз Potatso-мен қатар іске қосуы тиіс бағдарламалар, ал iOS бұған рұқсат етпейді.
- kcptun және ech-tls-tunnel Potatso-да әлі жоқ.

### Плагинді орнату {#set-plugin}

Сервер параметрлерінде **Плагин** астында плагинді таңдап, оның опцияларын **Плагин параметрі** ішіне енгізіңіз. Опциялар нүктелі үтірмен бөлінген `key=value` жұптары, мысалы, Simple Obfs үшін:

```text
obfs=tls;obfs-host=cdn.example.com
```

`tls` сияқты жеке кілт сол опцияны қосады. Қажет емес опцияларды қалдырып кетіңіз; төмендегі кестелерде әрқайсысының әдепкі мәні берілген.

Серверді импорттағанда, Potatso плагинді және оның опцияларын өзі орнатады:

- [`ss://` сілтемесі](#links) оларды `plugin` параметрінде, плагин атауынан кейін сақтайды: `simple-obfs;obfs=tls;obfs-host=cdn.example.com`.
- Clash не Mihomo жазылымы оларды `plugin` және `plugin-opts` ішінде сақтайды.
- SIP008 конфигурациясы не shadowsocks-rust немесе shadowsocks-libev `config.json` файлы оларды `plugin` және `plugin_opts` ішінде сақтайды.

Бұлар әр пішімде бірдей опциялар. Провайдеріңіз оларды Clash `plugin-opts` сияқты бір жолға бір-бірден тізімдесе, әрқайсысын `key=value` деп жазып, нүктелі үтірмен біріктіріңіз.

### Плагин опциялары {#plugin-options}

**Simple Obfs**

| Опция | Сипаттама |
| --- | --- |
| `obfs` | Міндетті. `http` не `tls`. |
| `obfs-host` | `Host` тақырыбы (`http`) не TLS қол алысуында жіберілетін сервер атауы (`tls`). Бос болса, Potatso сервердің мекенжайын пайдаланады. |
| `obfs-uri` | Тек `http` үшін. Сұраныс жолы. Әдепкі `/`. |
| `http-method` | Тек `http` үшін. Сұраныс әдісі. Әдепкі `GET`. |

**v2ray-plugin**

| Опция | Сипаттама |
| --- | --- |
| `mode` | `websocket`, әдепкі. QUIC режиміне қолдау көрсетілмейді. |
| `tls` | TLS арқылы қосылады. Әдепкіде өшірулі. |
| `host` | `Host` тақырыбы және TLS үшін сервер атауы. Бос болса, Potatso сервердің мекенжайын пайдаланады. |
| `path` | WebSocket жолы. Әдепкі `/`. |
| `mux` | Мультиплекстеу. Әдепкіде өшірулі. Оны тек серверіңіз пайдаланса қосыңыз. |
| `skip-cert-verify` | Кез келген сервер сертификатын қабылдайды. Оны тек сенетін серверіңізбен пайдаланыңыз. |
| `header` | Қосымша сұраныс тақырыбы, `header=Name:Value` ретінде. Көбірек тақырып үшін қайталаңыз. |

**gost-plugin**

| Опция | Сипаттама |
| --- | --- |
| `mode` | Міндетті. `websocket`. |
| `tls` | TLS арқылы қосылады. Әдепкіде өшірулі. |
| `host` | `Host` тақырыбы және TLS үшін сервер атауы. Әдепкі `bing.com`, gost-тағыдай. |
| `path` | WebSocket жолы. Әдепкі `/`. |
| `mux` | Мультиплекстеу. Әдепкіде қосулы. |
| `skip-cert-verify` | Кез келген сервер сертификатын қабылдайды. Оны тек сенетін серверіңізбен пайдаланыңыз. |
| `fingerprint` | Тек сол сертификатты қабылдау үшін сервер сертификатының SHA-256 саусақ ізі. |
| `header` | Қосымша сұраныс тақырыбы, `header=Name:Value` ретінде. Көбірек тақырып үшін қайталаңыз. |

**ShadowTLS**

| Опция | Сипаттама |
| --- | --- |
| `host` | Міндетті. Жабын сайттың сервер атауы, мысалы, `www.example.com`. |
| `version` | Міндетті. `1`, `2` не `3`. |
| `password` | Құпиясөз. 2 және 3 нұсқаларға қажет. |
| `alpn` | ALPN тізімі, үтірмен бөлінген. Әдепкі `h2,http/1.1`. |
| `skip-cert-verify` | Жабын сайттың кез келген сертификатын қабылдайды. |

**Restls**

| Опция | Сипаттама |
| --- | --- |
| `host` | Міндетті. Жабын сайттың сервер атауы. |
| `password` | Міндетті. Құпиясөз. |
| `version-hint` | Міндетті. Серверіңіз қалай бапталса, солай `tls13` не `tls12`. |
| `restls-script` | Провайдеріңіз берсе, жазба скрипті. |

**JLS**

| Опция | Сипаттама |
| --- | --- |
| `host` | Міндетті. Жабын сайттың сервер атауы. |
| `username` | Міндетті. Пайдаланушы аты. |
| `password` | Міндетті. Құпиясөз. |
| `alpn` | ALPN тізімі, үтірмен бөлінген. Әдепкі `h2,http/1.1`. |

Міндетті опция жоқ не мән жарамсыз болғанда, Potatso серверге қосылмайды.

## UDP {#udp}

UDP Shadowsocks серверлері үшін әдепкіде қосулы және қолдау көрсетілетін әр шифрмен жұмыс істейді. Серверіңіз UDP-ді жеткізбесе, сервер параметрлерінде оны өшіріңіз.

UDP плагин арқылы жіберілмейді, сондықтан Simple Obfs-тен басқа плагинмен сервер тек TCP тасымалдайды. Potatso UDP-over-TCP (сілтемедегі не жазылымдағы `udp-over-tcp` немесе `uot`) мүмкіндігін қолдамайды және оны талап ететін серверді импорттамайды.

## Мүмкіндіктерге қолдау {#features}

| Мүмкіндік | Қолдау |
| --- | --- |
| [SIP002](https://shadowsocks.org/doc/sip002.html) `ss://` сілтемелері | ✅ Ескі Base64 пішімін қоса |
| [SIP003](https://shadowsocks.org/doc/sip003.html) плагиндері | Тек [кірістірілген плагиндер](#plugins) |
| SIP003u (плагин арқылы UDP) | ❌ |
| [AEAD шифрлары](https://shadowsocks.org/doc/aead.html) (SIP004) | ✅ |
| [SIP008](https://shadowsocks.org/doc/sip008.html) онлайн конфигурациясы | ✅ |
| [SIP022](https://shadowsocks.org/doc/sip022.html) 2022 шифрлары | ✅ TCP және UDP |
| [SIP023](https://shadowsocks.org/doc/sip023.html) көп пайдаланушылы сәйкестендіру тақырыптары | ✅ AES 2022 шифрлары үшін |
| [Ағындық шифрлар](https://shadowsocks.org/doc/stream.html) | ✅ [Шифрлар](#ciphers) бөлімін қараңыз |
| UDP-over-TCP | ❌ |
| TCP Fast Open, MPTCP | ❌ |

shadowsocks-rust-тың кейбір мүмкіндіктері оның өз клиент бағдарламасының — `sslocal` — параметрлері болып табылады, ал Potatso сол жұмысты өз жолымен істейді:

- Жергілікті SOCKS5, HTTP, туннель, redir, DNS және TUN серверлері: Potatso құрылғыңыздың трафигін өзі ұстайды.
- Қатынасты басқару тізімдері (ACL): профиліңіздегі ережелерді пайдаланыңыз.
- Бірнеше серверден ең жылдамын таңдау: профиліңіздегі прокси тобын пайдаланыңыз.

## `ss://` сілтемелері {#links}

`ss://` сілтемесі бүкіл серверді бір жолда сақтайды ([SIP002](https://shadowsocks.org/doc/sip002.html)):

```text
ss://userinfo@host:port/?plugin=…#name
```

| Бөлік | Сипаттама |
| --- | --- |
| `userinfo` | Шифр мен құпиясөз `cipher:password` ретінде, Base64 не пайыздық кодталған. 2022 шифры пайыздық кодталған пішімді пайдалануы керек. |
| `host` | Сервер мекенжайы. IPv6 мекенжайын шаршы жақшаға алыңыз, мысалы, `[2001:db8::1]`. |
| `port` | Сервер порты. |
| `plugin` | Міндетті емес. Плагин атауы және оның опциялары, нүктелі үтірмен бөлінген және пайыздық кодтаумен, мысалы, `simple-obfs;obfs=tls;obfs-host=cdn.example.com`. |
| `name` | Міндетті емес. Сервердің Potatso-дағы атауы. |

Potatso `#` белгісіне дейінгінің бәрі Base64 кодталған ескі пішімді де импорттайды:

```text
ss://base64(cipher:password@host:port)#name
```

Potatso стандартты және URL-қауіпсіз Base64-ті, `=` толтырғышымен де, онсыз да қабылдайды. Potatso серверімен бөліскенде, SIP002-нің Base64 және пайыздық кодталған пішімдерін және ескі пішімді ұсынады.

### Мысалдар {#link-examples}

Әр мысалда импортталатын сілтеме көрсетілген. AEAD мысалдарындағы құпиясөз — `secret`.

`aes-256-gcm` бар қарапайым сервер:

```text
ss://YWVzLTI1Ni1nY206c2VjcmV0@ss.example.com:8388#Basic
```

16 байттық `MTIzNDU2Nzg5MDEyMzQ1Ng==` кілті бар 2022 сервері:

```text
ss://2022-blake3-aes-128-gcm:MTIzNDU2Nzg5MDEyMzQ1Ng%3D%3D@ss.example.com:8388#2022
```

Сервер кілті мен пайдаланушы кілті қос нүктемен (`%3A`) бөлінген көп пайдаланушылы 2022 сервері:

```text
ss://2022-blake3-aes-256-gcm:MTIzNDU2Nzg5MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTI%3D%3AYWJjZGVmZ2hpamtsbW5vcHFyc3R1dnd4eXowMTIzNDU%3D@ss.example.com:8388#Multi-user
```

Сервер атауы ретінде `cdn.example.com` пайдаланатын TLS бар Simple Obfs:

```text
ss://YWVzLTI1Ni1nY206c2VjcmV0@ss.example.com:443/?plugin=simple-obfs%3Bobfs%3Dtls%3Bobfs-host%3Dcdn.example.com#Obfs
```

Қарапайым сервердің ескі пішімі:

```text
ss://YWVzLTI1Ni1nY206c2VjcmV0QHNzLmV4YW1wbGUuY29tOjgzODg#Legacy
```

IPv6 мекенжайы бар сервер:

```text
ss://YWVzLTI1Ni1nY206c2VjcmV0@[2001:db8::1]:8388#IPv6
```

Source: https://potatso.com/docs/kk/protocols/shadowsocks/index.mdx