Troubleshooting ru

Диагностика

🌐 English · Русский · 中文

Что означают типовые ситуации и что делать. При обращении в поддержку скриншот Логов вокруг момента подключения/импорта полезнее любого описания.

Нода «пингуется», но страницы не грузятся

Тест задержки идёт из ядра напрямую до тест-URL, минуя туннель — поэтому зелёный пинг доказывает лишь, что ядро достаёт сервер, а не что работает трафик через TUN. Обычные причины:

• Не работает DNS. Если резолв не проходит, в Логах будет dns resolve failed: couldn't find ip — и для прокси-серверов, и для прямых сайтов. Сначала попробуй Настройки → Соединение → Smart DNS fallback: домены, идущие через прокси, начнут резолвиться через прокси, а это закрывает самый частый случай — медленный, заблокированный или подменённый резолвер провайдера. Сменить сами резолверы можно только правкой блока dns: в профиле — поля для DNS-серверов в настройках нет.
• Сломан IPv6. Ошибки вида dial tcp [2600:…]: The requested address is not valid in its context означают, что у машины нет рабочего IPv6-маршрута, а конфиг возвращает IPv6-адреса. Проверь, что Настройки → Соединение → Enable IPv6 DNS выключен — это значение по умолчанию, и оно держит выключенными и верхнеуровневый флаг ipv6, и dns.ipv6. Включай только если в твоей сети IPv6 действительно работает.
• Списки правил тянутся через мёртвую ноду. Если подписка тянет провайдеры правил proxy: через недоступную ноду — режиму Rule не с чем сопоставлять. Выбери рабочую ноду или уточни у провайдера.
• MTU / UDP. Протоколы на QUIC (Hysteria2, TUIC) могут пинговаться, но реальный трафик встаёт, если MTU у TUN слишком большой. Попробуй Настройки → TUN → MTU = 1408 или проверь в режиме системного прокси, чтобы подтвердить, что дело в TUN-пути.

Импорт прошёл, но после подключения ничего не работает

Почти всегда это случай с провайдером правил через мёртвую ноду выше или проблема DNS. Открой Логи и ищи initial rule provider … error или dial … i/o timeout — адрес в строке dial подскажет, какая нода недоступна. Выбери другую ноду и переподключись.

TUN не поднимается / подключается и падает

• SlothClash проверяет TUN-адаптер после поднятия и один раз перезапустит ядро, если он поднялся некорректно; дай пару секунд.
• Убедись, что служба-помощник установлена и жива — если приложение показывает баннер переустановки службы, следуй ему (см. раздел ниже). Устаревшая служба может блокировать TUN.
• На Windows могут мешать сторонние сетевые фильтры. На macOS ошибка utun … Operation not permitted обычно означает, что другой сетевой фильтр (например Cisco AnyConnect) блокирует туннель — закрой его и повтори.

Баннер «переустановить службу-помощник»

SlothClash показывает этот баннер в трёх разных ситуациях. Лечатся все три одинаково: нажать кнопку на баннере и подтвердить UAC.

1. Служба старее, чем требует приложение. Версии приложения и привилегированной службы должны совпадать, а после обновления приложения они расходятся.

2. «Нужно переустановить служебный сервис, чтобы разрешить обновлённое ядро». Служба запускает только то ядро Mihomo, чей SHA-256 совпадает с хэшем, записанным при её установке — именно это не даёт никому подменить бинарник ядра. Когда с обновлением приложения приезжает новое ядро, старый пин перестаёт совпадать, служба отказывается его запускать, и подключение не проходит.

Обычно инсталлятор сам обновляет пин при апгрейде, поэтому большинство этого баннера не увидит. Если он всё же появился — кнопка переустановки запишет новый хэш, и подключение заработает.

3. «Служебный сервис недоступен — переустановите, чтобы восстановить». Служба зарегистрирована, но не отвечает. Старые версии держали бинарник службы во временной папке, которую система могла вычистить — после этого служба не стартовала. Переустановка возвращает его на место, а версии начиная с 2.4.0 ставят его рядом с приложением в Program Files, поэтому после одной переустановки проблема уходит навсегда.

После обновления на версию, требующую службу 2.4.0, увидеть этот баннер один раз — нормально: этот релиз как раз переносит бинарник службы из временной папки в папку, куда пишет только администратор. Переустанови один раз, и он больше не вернётся.

Windows: среда выполнения Visual C++

SlothClash нужен runtime Microsoft Visual C++. Инсталлятор сам определяет, что его нет, и ставит молча — видно только строку прогресса, никаких запросов.

Если эта загрузка не удалась (нет интернета во время установки, корпоративный прокси, заблокированный домен), инсталлятор об этом скажет. Поставь руками с aka.ms/vs/17/release/vc_redist.x64.exe и запусти установщик SlothClash заново.

Другие устройства в сети не могут ходить через этот компьютер

По умолчанию SlothClash слушает только localhost, поэтому прописать на телефоне IP этого ПК недостаточно — ничего не произойдёт. Включи Настройки → Соединение → Allow LAN binding, и локальный прокси станет доступен из твоей сети. (Если профиль жёстко задаёт loopback-адрес в bind-address, приложение перепишет его, иначе настройка бы не сработала.)

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

Чтение Логов

Логи показывают собственные сообщения ядра. Полезные строки:

Строка	Что значит
dns resolve failed: couldn't find ip	DNS не смог зарезолвить — см. раздел про DNS выше
dial tcp [2600:…]: … not valid in its context	Сломан IPv6 — выключи Enable IPv6 DNS в Настройки → Соединение
[TCP] dial <group> … i/o timeout	Нода <ip> недоступна
initial rule provider <name> error	Список правил не скачался (часто через мёртвую ноду)

Связанное

• Настройки — стек TUN, MTU, DNS
• Профили и ноды — смена нод