Сообщение Hiddify часто описывает результат сбоя, а не его истинную причину. Одна и та же «ошибка подключения» может быть связана с разрешениями клиента, содержимым подписки, DNS/TLS или удалённым узлом. Поэтому лучше не менять подряд все настройки, а за один раз изменять только одну переменную и записывать результат.

Симптомы: сначала выберите нужную инструкцию

Основной симптом	Что читать в первую очередь	Что проверить сначала
При импорте появляется `Failed to Add Profile`, `Unexpected Connection Error` или тип подписки не распознаётся	Ошибка импорта подписки	Ссылка, содержимое ответа, сертификат и разбор клиентом
Hiddify показывает подключение, но сайты и приложения не получают доступ к сети	Подключено, но интернета нет	Основная сеть, режим прокси, DNS и узел
Системный прокси работает, а режим VPN/TUN — нет	Режим TUN не запускается	Права администратора, виртуальный адаптер и конфликты маршрутов
Существующая конфигурация работает, но подписка не обновляется	Ошибка обновления подписки	Состояние подписки, HTTPS, перенаправления и ответ сервера
Подключение работает, но стало медленным, часто разрывается или сбоит только в одной сети	Низкая скорость или частые разрывы	Узел, сеть доступа, DNS и версия клиента

Диагностика за две минуты

Выполните следующие пять шагов по порядку. Не меняйте одновременно DNS, маршрутизацию, TUN и узел:

Зафиксируйте исходные данные: запишите версию Hiddify, операционную систему, режим подключения, точный текст ошибки и время. Версию можно сверить с официальными релизами.
Проверьте основную сеть: отключите Hiddify и откройте сайт, который обычно доступен напрямую. Если он тоже не открывается, сначала восстановите Wi-Fi, мобильную сеть или сетевые настройки системы.
Один раз смените сеть: переключитесь между Wi-Fi и мобильной точкой доступа. Если это помогло, в первую очередь проверяйте локальную сеть, DNS или ограничения сети доступа.
Один раз смените устройство или узел: если та же подписка работает на другом устройстве, весь сервис, вероятно, не отключён. Если на том же устройстве помогает смена узла, проблема скорее ограничена одним узлом.
Сравните режимы подключения: если системный прокси работает, а TUN/VPN — нет, откройте инструкцию по TUN. Если не работает ни один режим, проверяйте подписку и сервер.

URL подписки обычно содержит токен учётной записи. Не публикуйте полную ссылку, QR-код, файл конфигурации или журнал без удаления секретных данных на форумах, в чатах и GitHub Issues.

Поуровневая диагностика

Уровень 1: клиент

Полностью закройте приложение и откройте его снова. Простое закрытие окна может оставить фоновый процесс работающим.
Проверьте текущую версию и источник установки. Перед обновлением сохраните рабочую конфигурацию и не удаляйте единственный исправный профиль.
Приостановите другие VPN, прокси, фильтры трафика и программы с виртуальными сетевыми адаптерами, затем проведите один контрольный тест.
Верните дополнительные настройки к значениям по умолчанию и повторите проверку. Меняйте отдельные параметры только тогда, когда журнал указывает на конкретную настройку.
Для TUN в Windows нужны права администратора. Официальная инструкция также требует запускать приложение с правами администратора или root перед включением TUN.

Уровень 2: подписка

Убедитесь, что ссылка скопирована полностью, без пробелов по краям, и что вместо ссылки подписки не вставлен адрес обычной веб-страницы.
Проверьте срок действия учётной записи, остаток трафика и лимит устройств.
Если ссылка возвращает страницу входа, CAPTCHA, страницу ошибки или пустой ответ, клиент не сможет разобрать её как конфигурацию.
Clash, sing-box и ссылки на отдельные узлы содержат разные типы данных. Hiddify поддерживает несколько форматов, но возвращаемое содержимое всё равно должно быть корректным; см. официальную инструкцию.

Уровень 3: DNS и TLS

Проверьте дату, время и часовой пояс системы. Значительная ошибка часов может нарушить проверку сертификатов HTTPS.
Откройте домен подписки в браузере и проверьте, нет ли ошибки сертификата. Не обходите предупреждение о сертификате.
Если в журнале есть dns, certificate, TLS handshake или ошибка разрешения домена, сначала повторите тест в другой сети, затем верните DNS по умолчанию или используйте параметры, явно предоставленные сервисом.
Не заменяйте https:// на http://. В официальной истории изменений указано, что Hiddify 4.x отключил HTTP-ссылки подписок из-за проблем безопасности. Передача без шифрования также может раскрыть токен и параметры узлов. См. официальный файл HISTORY.

Уровень 4: сервер

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

Проверка результата

Не ограничивайтесь зелёной кнопкой подключения. Выполните как минимум следующие проверки:

Исходная ошибка не появляется в трёх последовательных попытках.
Подписка обновляется вручную и показывает ожидаемую конфигурацию или узлы.
Открываются сайты на разных доменах и обычные приложения, а не только один тестовый адрес.
После отключения Hiddify обычная сеть восстанавливается без оставшегося прокси или ошибочного маршрута.
Запишите состояние до изменения, единственное сделанное изменение и результат после него, чтобы повторить проверку при возврате проблемы.

Когда обращаться к поставщику или создавать Issue

Если одна подписка не работает на нескольких устройствах и в нескольких сетях, сначала обратитесь к поставщику. Если сбой стабильно возникает только в определённой версии Hiddify или операционной системе, а в других клиентах подписка работает, найдите похожее сообщение в официальном списке Issues, прежде чем создавать новое.

Укажите операционную систему и её версию, версию Hiddify, источник установки, режим подключения, кратчайшие шаги воспроизведения, время сбоя и очищенные журналы. Удалите личные пути из домена, токены, UUID, IP-адреса серверов и данные, по которым можно определить учётную запись.

Устранение неполадок Hiddify: подключение, подписка и TUN