Последнее обновление

Hiddify не импортирует подписку: ошибка Failed to Add Profile

Устранение ошибок Failed to Add Profile, Unexpected Connection Error и неизвестного типа подписки при импорте в Hiddify.

Сообщения Failed to Add Profile, Unexpected Connection Error или «не удалось определить тип ссылки подписки» при импорте не обязательно означают, что все узлы недоступны. Сбой мог произойти при загрузке подписки, проверке HTTPS, распознавании формата содержимого или сохранении конфигурации.

Пользователи Windows уже сообщали о таких ошибках в официальном репозитории. В Issue #1661 записана ошибка Failed to Add Profile / Unexpected Connection Error, а в Issue #2037 — нераспознанная подписка в формате Clash. Это отдельные пользовательские случаи, а не доказательство одной общей причины на всех устройствах.

Симптомы

  • Ошибка появляется сразу после выбора добавления из буфера обмена.
  • После ручного ввода URL возникает неожиданная ошибка подключения.
  • Ссылка импортируется в старой версии или на другом устройстве, но не работает на текущем.
  • Приложение не может определить тип подписки или после импорта не показывает ни одного узла.
  • Проверка обновлений и добавление профиля одновременно завершаются сетевой ошибкой.

Если профиль уже добавлен и не удаётся только его обновление, перейдите к инструкции Ошибка обновления подписки.

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

  1. Снова скопируйте адрес подписки из панели поставщика. Убедитесь, что он начинается с https:// или поддерживаемой схемы отдельного узла и не содержит пробелов, переносов строк и пропущенных символов.
  2. Не публикуйте ссылку. Откройте HTTPS-адрес в доверенном браузере и посмотрите, возвращает ли он конфигурацию или перенаправляет на страницу входа, CAPTCHA, ошибки либо предупреждения о сертификате.
  3. Один раз переключитесь между Wi-Fi и мобильной точкой доступа. Если ошибка возникает только в одной сети, сначала проверяйте DNS, TLS и ограничения этой сети.
  4. Импортируйте ту же ссылку на другом устройстве или другую заведомо исправную подписку на текущем. Перекрёстная проверка поможет отличить проблему устройства от проблемы подписки.
  5. Запишите полный текст ошибки и время. Не переустанавливайте приложение многократно, не переключайте ядро и не меняйте сразу все дополнительные настройки.

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

Клиент: проверьте способ ввода и версию

В официальной документации описаны два основных способа: добавление из буфера обмена и ручной ввод имени и URL. Шаги приведены в официальной инструкции HiddifyApp.

  • Вставьте ссылку в локальный текстовый редактор, проверьте начало, конец и случайные переносы строк, а затем сразу удалите временный текст.
  • Если добавление из буфера не работает, введите тот же полный URL вручную. Этот тест нужен только для исключения ошибки содержимого буфера обмена.
  • Сверьте актуальную стабильную версию и пакет для своей платформы с официальными релизами.
  • Перед обновлением сохраните существующие рабочие профили. Не начинайте с очистки данных приложения: она может удалить единственную пригодную локальную конфигурацию.
  • Совет включить режим отладки из отдельных комментариев в Issues не является универсальным исправлением. Основная польза отладки — более точный журнал ошибки.

Подписка: убедитесь, что ответ содержит конфигурацию, а не веб-страницу

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

DNS/TLS: сохраните безопасность HTTPS

  • Проверьте дату, время и часовой пояс операционной системы.
  • Посмотрите, не сообщает ли браузер о несовпадении домена, истёкшем сертификате, недоверенной цепочке или ошибке рукопожатия TLS.
  • Сначала повторите тест в другой сети, а затем исправляйте DNS по данным журнала. Не принимайте проблему сертификата за неисправность узла.
  • Не отключайте системную проверку сертификатов и не устанавливайте корневые сертификаты из неизвестного источника.

Никогда не меняйте https:// на http:// в ссылке подписки. Даже если отдельный комментарий описывает это как временное решение, HTTP открытым текстом раскрывает токен подписки и данные узлов. В официальном HISTORY Hiddify также зафиксировано решение отключить HTTP-ссылки подписок в версии 4.x: посмотреть историю изменений.

Сервер: попросите поставщика проверить фактический ответ

Если одна ссылка не импортируется на нескольких устройствах и в нескольких сетях, попросите поставщика проверить:

  • действителен ли сертификат HTTPS и полна ли его цепочка;
  • возвращается ли код 200 вместо цикла 3xx, кода 401, 403, 404 или 5xx;
  • остаётся ли адрес после перенаправления безопасно доступным;
  • содержит ли тело ответа корректную конфигурацию Clash, sing-box или отдельного узла;
  • действительны ли токен, учётная запись, трафик и лимит устройств.

При переносе домена подписки поставщик может использовать механизм moved-permanently-to из официальной документации URL Scheme Hiddify вместо требования перейти на HTTP.

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

После исправления должны выполняться все условия:

  1. Удалите дубликаты профилей, созданные во время тестов, но сохраните подтверждённый рабочий профиль.
  2. Импортируйте или обновите одну и ту же HTTPS-ссылку три раза подряд без исходной ошибки.
  3. Профиль показывает узлы, а хотя бы один узел проходит проверку задержки и открывает настоящий сайт.
  4. После перезапуска приложения профиль остаётся на месте.
  5. В журнале больше не появляется та же ошибка загрузки, сертификата или разбора.

Если импорт прошёл, но после подключения интернета нет, продолжите с инструкцией Hiddify подключён, но интернета нет.

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

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

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