Начало работы

Эта страница проведёт вас через первый запуск: как добавить конфигурацию в Chute, выбрать её, запустить прокси и убедиться, что трафик идёт. Всё остальное в этом руководстве опирается на работающую настройку.

Chute iOS

1. Получите конфигурацию

При первом запуске без конфигураций Chute открывает мастер настройки («Добро пожаловать в Chute») с тремя путями: Ссылка подписки для URL, выданного провайдером, Сканировать QR-код и Ручная настройка, которая запрашивает данные вашего сервера, сайты для проксирования и выбор DNS, после чего создаёт конфигурацию с именем «По умолчанию» и подключается.

Чтобы добавить конфигурацию позже, нажмите панель Конфигурация вверху главного экрана, затем Добавить конфигурацию из...:

• Пустая конфигурация — открывает встроенный редактор с пустой конфигурацией (что в неё вписать, см. минимальный пример ниже).
• Добавить подписку — загружает конфигурацию по URL подписки и поддерживает её в актуальном состоянии: нативный профиль сохраняется как управляемая конфигурация, которая повторно загружается каждые 24 часа — или с интервалом, заданным собственной строкой #!MANAGED-CONFIG профиля. Подписка Clash или sing-box преобразуется по пути и сохраняется статическим снимком без заголовка обновления, поэтому сама она не обновляется никогда — чтобы обновить её, импортируйте заново.
• Импорт из локального файла — импортирует файл Chute (.conf), sing-box (.json) или Clash/mihomo (.yaml); ненативные форматы преобразуются автоматически.
• Синхронизация из iCloud, Загрузить по URL, Загрузить файл по Wi-Fi, Загрузить по QR-коду — дополнительные способы доставки того же самого.

Без лицензии iPhone или iPad хранит одну конфигурацию. Как только она есть, любой из перечисленных выше каналов вызывает предложение купить лицензию — как и выбор другой конфигурации, см. Лицензия и активация.

2. Выберите её

В списке конфигураций нажмите на конфигурацию, чтобы появилась галочка, затем нажмите Готово. Chute всегда запускает выбранную конфигурацию — если ничего не выбрано, главный переключатель откажется включаться («Пожалуйста, сначала выберите конфигурацию»).

3. Запустите и разрешите

Нажмите круглый переключатель на главном экране. При самом первом запуске iOS попросит добавить конфигурацию VPN — разрешите и подтвердите с помощью Face ID / Touch ID / код-пароля. Если вы отклонили запрос, просто переключите ещё раз; если профиль VPN когда-нибудь застрянет, пункт Сброс конфигурации VPN в настройках приложения удалит его, и следующий запуск создаст его заново.

4. Проверьте

Когда переключатель включён, оставьте режим исходящих соединений в положении По правилам (режимы Напрямую / Глобальный целиком обходят прокси или направляют в него весь трафик), затем откройте какой-нибудь сайт. Кнопка Панель мониторинга показывает трафик в реальном времени и детали каждого соединения — это самый быстрый способ убедиться, что конфигурация ведёт себя как задумано.

Chute Mac

Chute Mac живёт в строке меню (по умолчанию значка в Dock нет). Щёлкните значок в строке меню:

1. Импортируйте конфигурацию — Импортировать конфигурацию... открывает вкладку Профили главного окна, где есть Импорт из файла… для файла на диске и Импорт из URL или ссылки для обмена… для URL подписки или ссылки для обмена (ss://, vmess://, ...; из четырёх приложений ссылки для обмена импортирует только Chute Mac). Помощник настройки... вместо этого собирает конфигурацию шаг за шагом. Оба пункта меню доступны, только пока прокси остановлен. Профили подписок и преобразованные профили хранятся в ~/Library/Application Support/<bundle id>/Profiles/; файлы, импортированные с диска, используются по месту.
2. Выберите её — Выбрать файл конфигурации или Переключить конфигурацию, пока прокси работает. При первом запуске движка Chute устанавливает привилегированный помощник, который выставляет системный прокси и создаёт интерфейс Расширенного режима: сначала объясняет зачем (Chute требуется помощник), затем macOS просит его авторизовать. В macOS 13 и новее помощник, возможно, придётся ещё разрешить в Системные настройки > Основные > Объекты входа и расширения; Chute сообщает об этом окном Требуется разрешение или Разрешите Chute в объектах входа.
3. Включите — два независимых переключателя служат разным задачам:
   • Системный прокси — переключатель вверху меню. Регистрирует Chute как системный HTTP/SOCKS-прокси; приложения, соблюдающие системный прокси, идут через Chute.
   • Расширенный режим (⌘E) — захватывает весь трафик на сетевом уровне, включая приложения, игнорирующие системный прокси. Его тип по умолчанию, Helper utun (устаревший), перед включением показывает уведомление и больше ничего одобрять не требует; одобрить сетевое расширение и конфигурацию VPN Chute просит только тип PacketTunnel (рекомендуется). О выборе типа и процессе одобрения см. Расширенный режим.
4. Проверьте — заголовок меню показывает «Системный прокси: активен», а вкладки Трафик и Лог главного окна показывают, что проходит и почему.

Внимание: эти шаги описывают новое главное окно. Chute Mac включает его сам только для установки, в которой ещё нет ни одной конфигурации; установка, где конфигурации уже были, сохраняет прежний интерфейс: в его меню вместо Открыть панель мониторинга... есть Настройки..., и в том окне нет вкладок Трафик и Лог. Чтобы переключиться, отметьте в меню Использовать новый интерфейс главного окна — этот пункт показан, пока прокси работает.

Chute tvOS

Chute tvOS добавляет конфигурацию по-своему. В списке конфигураций Добавить конфигурацию из... предлагает Пустая конфигурация, Загрузить файл через Wi-Fi или Chute iOS и Загрузить по URL. Загрузка по Wi-Fi поднимает по адресу телевизора обычную страницу HTTP, на которую может отправить файл любой браузер в той же сети; открытая с iPhone, эта страница передаёт дело Chute iOS через URL-схему chute://tv — отсюда и представление удалённого импорта конфигурации. Ограничение в одну конфигурацию здесь то же, что на iOS.

Chute Android

Первый запуск на Android — добавление конфигурации, согласие на VPN, режим службы и режим для отдельных приложений, где проверять — описан на отдельной странице: Начало работы на Android. Минимальная конфигурация ниже работает там без изменений.

Минимальная конфигурация

Полная работающая конфигурация для одного сервера Shadowsocks — трафик локальной сети и Китая идёт напрямую, всё остальное через прокси:

[General]
loglevel = notify
dns-server = 1.1.1.1, 8.8.8.8
skip-proxy = 127.0.0.1, 192.168.0.0/16, 10.0.0.0/8, 172.16.0.0/12, 100.64.0.0/10, localhost, *.local

[Proxy]
MyProxy = ss, example.com, 8388, aes-256-gcm, "password"

[Proxy Group]
MainGroup = select, MyProxy, DIRECT

[Rule]
IP-CIDR,192.168.0.0/16,DIRECT
IP-CIDR,10.0.0.0/8,DIRECT
IP-CIDR,172.16.0.0/12,DIRECT
IP-CIDR,127.0.0.0/8,DIRECT
GEOIP,CN,DIRECT
FINAL,MainGroup

Замените строку в [Proxy] протоколом и параметрами вашего сервера — все поддерживаемые протоколы описаны в разделе Прокси-сервер. Дальше:

• Конфигурация — формат файла и все разделы.
• Правила — как обрабатываются правила и полный перечень их типов.
• Группа политик — автоматический выбор (url-test, fallback, load-balance).
• Устранение неполадок — когда что-то не работает.