Shadowsocks

Сервер Shadowsocks описывается шифром и паролем, а при необходимости еще и плагином, который маскирует соединение. Potatso подключается к серверу, если поддерживает его шифр и, при наличии, плагин. Используйте таблицы ниже, чтобы проверить настройки своего сервера, показанные провайдером или в его ссылке ss://.

Сервер Shadowsocks можно добавить вручную, с помощью ссылки ss:// или импортом:

• подписки Clash или Mihomo,
• онлайн-конфигурации SIP008 из файла или по ссылке,
• config.json от shadowsocks-rust или shadowsocks-libev,
• конфигурации Surge либо конфигурации Xray или V2Ray.

Шифры

Если сервер предлагает шифр 2022, выбирайте его, затем шифр AEAD. У потоковых шифров есть известные слабости: используйте их только с серверами, которые не предлагают ничего другого.

Регистр в названиях не важен, поэтому AES-256-GCM работает так же, как aes-256-gcm.

none отправляет ваш трафик без шифрования. Используйте его только с плагином, который сам шифрует соединение, например v2ray-plugin с TLS.

Каждый поддерживаемый шифр проверен как минимум на одном настоящем сервере Shadowsocks: shadowsocks-rust, sing-box или оригинальном сервере на Python. Из перечисленных выше шифров AEAD aes-*-ccm, aes-*-gcm-siv и sm4-* предлагают только серверы shadowsocks-rust, и пользуются ими немногие провайдеры.

Ключи 2022

Шифры 2022 (SIP022) используют не пароль, а ключ: случайные байты в кодировке Base64 той длины, которая нужна шифру. Для 2022-blake3-aes-128-gcm нужен 16-байтовый ключ, а для остальных шифров 2022 — 32-байтовый. Используйте ключ точно таким, как он записан на вашем сервере.

Potatso не подключается с ключом неверной длины или с паролем, который не в Base64. Чтобы создать новый ключ для сервера, выполните openssl rand -base64 16 для 2022-blake3-aes-128-gcm или openssl rand -base64 32 для остальных шифров 2022.

Серверы с несколькими пользователями

Сервер 2022 может делить один порт между несколькими пользователями (SIP023). У каждого пользователя свой ключ. Для таких серверов задайте в качестве пароля ключ сервера и свой ключ пользователя через двоеточие:

server-key:user-key

Серверы с несколькими пользователями поддерживают только 2022-blake3-aes-128-gcm и 2022-blake3-aes-256-gcm.

Плагины

Плагин оборачивает соединение Shadowsocks, чтобы его было труднее обнаружить. Эти плагины встроены в Potatso, так что больше ничего устанавливать не нужно.

Potatso не импортирует сервер, которому нужен другой плагин:

• Cloak, xray-plugin и другие плагины — это программы, которые устройству пришлось бы запускать рядом с Potatso, а iOS этого не позволяет.
• kcptun и ech-tls-tunnel в Potatso пока недоступны.

Настройка плагина

В настройках сервера выберите плагин в поле Плагин, затем введите его параметры в Параметр плагина. Параметры — это пары key=value, разделенные точками с запятой, как в этом примере для Simple Obfs:

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

Ключ без значения, например tls, включает этот параметр. Опускайте параметры, которые вам не нужны; значения по умолчанию указаны в таблицах ниже.

При импорте сервера Potatso сам задает плагин и его параметры:

• Ссылка ss:// содержит их в параметре plugin после имени плагина: simple-obfs;obfs=tls;obfs-host=cdn.example.com.
• Подписка Clash или Mihomo содержит их в plugin и plugin-opts.
• Конфигурация SIP008 или config.json от shadowsocks-rust либо shadowsocks-libev содержит их в plugin и plugin_opts.

Во всех видах это одни и те же параметры. Если провайдер перечисляет их по одному в строке, как в plugin-opts Clash, запишите каждый как key=value и соедините точками с запятой.

Параметры плагинов

Simple Obfs

v2ray-plugin

gost-plugin

ShadowTLS

Restls

JLS

Potatso не подключается к серверу, если не хватает обязательного параметра или значение недопустимо.

UDP

Для серверов Shadowsocks UDP включен по умолчанию и работает со всеми поддерживаемыми шифрами. Выключите его в настройках сервера, если ваш сервер не ретранслирует UDP.

UDP не отправляется через плагин, поэтому с любым плагином, кроме Simple Obfs, сервер передает только TCP. Potatso не поддерживает UDP-over-TCP (udp-over-tcp или uot в ссылке или подписке) и не импортирует сервер, которому он нужен.

Поддержка возможностей

Некоторые возможности shadowsocks-rust — это настройки его собственной клиентской программы sslocal, а Potatso решает ту же задачу по-своему:

• Локальные серверы SOCKS5, HTTP, tunnel, redir, DNS и TUN: Potatso сам перехватывает трафик вашего устройства.
• Списки контроля доступа (ACL): используйте правила в своем профиле.
• Выбор самого быстрого из нескольких серверов: используйте группу прокси в своем профиле.

Ссылки ss://

Ссылка ss:// содержит весь сервер в одной строке (SIP002):

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

Potatso также импортирует старую форму, где всё до # закодировано в Base64:

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

Potatso принимает стандартный Base64 и Base64 для URL, с дополнением = и без него. Когда Potatso делится сервером, он предлагает формы Base64 и с процентным кодированием по SIP002, а также старую форму.

Примеры

В каждом примере показана ссылка для импорта. Пароль в примерах с AEAD — secret.

Обычный сервер с aes-256-gcm:

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

Сервер 2022 с 16-байтовым ключом MTIzNDU2Nzg5MDEyMzQ1Ng==:

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

Сервер 2022 с несколькими пользователями: ключ сервера и ключ пользователя разделены двоеточием (%3A):

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

Simple Obfs с TLS, имя сервера — cdn.example.com:

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

Старая форма обычного сервера:

ss://YWVzLTI1Ni1nY206c2VjcmV0QHNzLmV4YW1wbGUuY29tOjgzODg#Legacy

Сервер с адресом IPv6:

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