Ошибка при получении конфигурации из API Amnezia: коды 1100, 1103, 1104 и способы решения

Что означает ошибка при получении конфигурации из API Amnezia

Ошибка при получении конфигурации из API Amnezia — это общее описание сбоя, при котором приложение не может загрузить данные для подключения с серверов Amnezia. В интерфейсе она может появляться в виде кода 1100 (ApiConfigDownloadError), 1103 (ApiConfigTimeoutError) или 1104 (ApiConfigSslError). Эти коды относятся к группе ошибок импорта и API (диапазон 900–1104) и возникают, когда клиент пытается получить конфигурацию из облачного API вендора, а не со своего собственного сервера.

Важно понимать: ошибка 1100 не связана с превышением лимита устройств. За лимит отвечает отдельный код 1108 (ApiConfigLimitError), который появляется, когда все разрешённые слоты подписки заняты. Смешение этих кодов — распространённое заблуждение, которое приводит к неправильной диагностике. Если вы видите 1100, проблема скорее всего в сети, доступности API или статусе подписки, а не в количестве подключённых устройств.

Ошибка может возникать как в бесплатной версии Amnezia Free, так и в платной Amnezia Premium. В бесплатной версии конфигурация обычно создаётся через встроенный сервис «VPN от Amnezia», а в Premium — через личный кабинет. В обоих случаях клиент обращается к API, и любой сбой на этом пути приводит к появлению кода из группы 1100.

Код 1100 (ApiConfigDownloadError): причины и первые шаги

Код 1100 — это самая частая ошибка при получении конфигурации из API. Она означает, что приложению не удалось подключиться к серверу и скачать конфигурацию. Основные причины:

• Отсутствие интернета — устройство не имеет доступа к сети, или соединение нестабильно.
• Блокировка доступа к API — некоторые сети (рабочие, публичные Wi-Fi, отдельные провайдеры) могут блокировать запросы к серверам Amnezia.
• Неактивная подписка — если срок Premium истёк, API отказывает в выдаче конфигурации. В этом случае код может быть 1112 (подписка истекла), но иногда возвращается 1100.
• Временный сбой на стороне API — серверы Amnezia могут быть недоступны из-за технических работ или перегрузки.

Первые шаги при коде 1100:

1. Проверьте интернет: откройте любой обычный сайт без VPN. Если сайт не грузится, проблема в сети.
2. Смените источник интернета: переключитесь с Wi-Fi на мобильный интернет или наоборот. Это помогает, если сеть блокирует API.
3. Убедитесь, что подписка активна: зайдите в личный кабинет Amnezia Premium и проверьте статус. Если срок истёк, продлите подписку.
4. Перезапустите приложение: закройте его полностью и откройте снова. Иногда это снимает временный сбой.
5. Если ошибка остаётся на любой сети, попробуйте пересоздать конфигурацию: в приложении удалите текущее подключение и создайте новое через «VPN от Amnezia» или импортируйте ключ заново.

Код 1103 (ApiConfigTimeoutError): таймаут при получении конфигурации

Код 1103 означает, что приложение не получило ответ от API в течение установленного времени. Это разновидность ошибки 1100, но с акцентом на задержку, а не на полный отказ. Причины могут быть те же: медленный интернет, перегруженные серверы Amnezia, блокировка запросов на уровне сети или проблемы с DNS.

Таймаут часто возникает при использовании нестабильного мобильного интернета или при подключении через VPN-сервисы, которые сами замедляют трафик. Также это может быть следствием того, что устройство пытается обратиться к API через прокси, который не настроен должным образом.

Что делать при коде 1103:

• Смените сеть: если вы на Wi-Fi, попробуйте мобильный интернет, и наоборот. Это самый эффективный шаг.
• Проверьте подписку: если срок Premium истёк, API может не отвечать вовремя, возвращая таймаут.
• Перезагрузите конфигурацию: в приложении удалите подключение и создайте его заново. Иногда это помогает сбросить зависшее состояние.
• Подождите несколько минут и повторите попытку: если проблема на стороне сервера, она может решиться сама.
• Если таймаут повторяется постоянно, обратитесь в поддержку Amnezia, указав код ошибки и описание ситуации.

Код 1104 (ApiConfigSslError): ошибка SSL и проблема с временем на устройстве

Код 1104 (ApiConfigSslError) — это ошибка SSL при получении конфигурации. Она возникает, когда приложение не может установить защищённое соединение с API из-за проблем с сертификатами или, что чаще всего, из-за неверно установленного времени на устройстве.

Когда время на устройстве отличается от реального (например, на несколько часов или даже минут), SSL-сертификаты сервера считаются недействительными, и соединение отклоняется. Это классическая причина, которую легко исправить.

Пошаговое решение для кода 1104:

1. Проверьте дату и время на устройстве: зайдите в настройки системы и убедитесь, что установлено автоматическое определение времени и часового пояса. Если автоматический режим выключен, включите его.
2. Если время было неправильным, исправьте его и перезапустите приложение.
3. Если автоматическая синхронизация не помогает, попробуйте вручную установить правильный часовой пояс и время, затем снова включите автоматический режим.
4. Перезапустите приложение после изменения времени.
5. Если ошибка остаётся, проверьте, не используется ли на устройстве сторонний VPN или прокси, который перехватывает SSL-трафик. Отключите его и повторите попытку.

Если после всех шагов код 1104 не исчезает, возможно, проблема на стороне API — в этом случае обратитесь в поддержку.

Отличие ошибок API от ошибок SSH (300, 305) и Android (1000)

Ошибки при получении конфигурации из API (1100, 1103, 1104) часто путают с другими кодами, но их природа принципиально разная.

Коды 300 и 305 относятся к SSH-подключению приложения к вашему собственному серверу (self-hosted). Код 300 (SshRequestDeniedError) означает, что SSH-запрос отклонён: неверные учётные данные или недостаточно ресурсов на сервере. Код 305 (SshTimeoutError) — таймаут подключения: сервер не ответил вовремя, возможно, заблокирован SSH-порт. Эти ошибки возникают только при настройке своего VPS, а не при использовании облачного API Amnezia.

Код 1000 (AndroidError) — это ошибка VPN-подключения на Android, которая возникает уже после получения конфигурации, при попытке установить VPN-соединение. Она связана с форматом конфигурационного файла или ключа: проверьте, что файл имеет расширение .vpn, .conf, .ovpn или .json, а ключ начинается с vpn:// или ss://.

Таким образом, если вы видите 1100, проблема в доступе к API, а не в вашем сервере или конфиге. Если вы используете self-hosted, коды 1100, 1103, 1104 и 1108 вообще не должны появляться, потому что обмена с API вендора нет — все ошибки будут связаны с SSH или самим сервером.

Как проверить подписку и лимит устройств (код 1108)

Если вы используете Amnezia Premium, ошибка при получении конфигурации может быть связана с подпиской. Код 1108 (ApiConfigLimitError) означает, что превышен лимит разрешённых конфигураций на подписку. В Premium одновременно можно подключить до 7 устройств. Когда все слоты заняты, новая конфигурация не выдаётся, и приложение возвращает 1108.

Это не поломка, а сработавшее ограничение тарифа. Чтобы исправить:

1. Откройте личный кабинет Amnezia Premium (раздел «Устройства» / «Devices»).
2. Посмотрите список активных конфигураций. Если их больше 7, отвяжите неиспользуемые устройства (например, старый телефон или тестовый ключ).
3. После освобождения слота сгенерируйте новый ключ или конфиг для нужного устройства.
4. Переподключитесь — освободившийся слот примет новое устройство.

Если вы используете собственный сервер (self-hosted), лимит устройств задаёте вы сами в конфигурации сервера, а не вендор. В этом случае код 1108 не появится, а проблема будет в количестве пиров WireGuard/AmneziaWG — их максимум 254. Решение — удалить неактивных пиров или добавить новых в конфигурацию.

Также помните: если подписка истекла, API может вернуть код 1112 (подписка истекла). В этом случае нужно продлить подписку в личном кабинете.

Пошаговая диагностика: универсальный алгоритм для кодов 1100–1104

Если вы столкнулись с ошибкой при получении конфигурации из API, следуйте этому алгоритму. Он покрывает большинство случаев и помогает систематизировать диагностику.

Шаг 1. Проверьте интернет. Откройте любой сайт без VPN. Если сайт не грузится, проблема в сети. Перезагрузите роутер или переключитесь на мобильный интернет.

Шаг 2. Смените сеть. Если интернет есть, но ошибка остаётся, попробуйте другую сеть: с Wi-Fi на мобильный или наоборот. Это особенно важно, если вы находитесь в офисе или в публичной сети, где могут быть блокировки.

Шаг 3. Проверьте подписку. Зайдите в личный кабинет Amnezia Premium и убедитесь, что подписка активна. Если срок истёк, продлите её.

Шаг 4. Перезапустите приложение. Закройте Amnezia полностью (убедитесь, что оно не работает в фоне) и откройте снова. На Android можно также очистить кеш приложения в настройках системы.

Шаг 5. Пересоздайте конфигурацию. В приложении удалите текущее подключение и создайте новое: для Amnezia Free — через «VPN от Amnezia», для Premium — через импорт ключа из личного кабинета. Убедитесь, что ключ скопирован полностью, без лишних пробелов.

Шаг 6. Проверьте время на устройстве. Особенно актуально для кода 1104. Убедитесь, что дата и время установлены автоматически.

Шаг 7. Обновите приложение. Скачайте последнюю версию с официального сайта amnezia.org или из репозитория GitHub. Сторонние сборки могут содержать ошибки.

Шаг 8. Обратитесь в поддержку. Если ничего не помогло, напишите на support@amnezia.org или в Telegram-чат, приложив код ошибки, платформу, протокол и описание действий.

Особенности для Amnezia Free и Amnezia Premium

Ошибка при получении конфигурации из API может проявляться по-разному в зависимости от версии Amnezia.

Amnezia Free — бесплатная версия, которая предоставляет доступ к серверам Amnezia через встроенный сервис «VPN от Amnezia». В этой версии конфигурация создаётся автоматически, и ошибка 1100 может возникать из-за перегрузки бесплатных серверов или блокировок в сети. Решение: попробуйте создать подключение заново, смените сеть или подождите некоторое время.

Amnezia Premium — платная подписка, которая даёт доступ к более стабильным серверам и личному кабинету. Здесь ошибка 1100 чаще связана с истекшей подпиской или превышением лимита устройств. Проверьте статус подписки в личном кабинете и количество активных конфигураций.

Важно: если вы используете self-hosted (свой сервер), коды 1100, 1103, 1104 и 1108 не должны появляться, потому что приложение не обращается к API вендора. В этом случае все ошибки будут связаны с SSH-подключением (300, 305) или с самим сервером (200–206). Если вы видите код из группы 1100 при self-hosted, это может указывать на то, что вы случайно импортировали конфигурацию из облачного сервиса, а не со своего сервера.

Профилактика: как избежать ошибок при получении конфигурации

Чтобы минимизировать вероятность появления ошибок 1100–1104, следуйте простым рекомендациям.

• Используйте официальное приложение. Скачивайте Amnezia только с amnezia.org или из репозитория GitHub. Сторонние сборки могут содержать вредоносный код и вызывать сбои.
• Регулярно обновляйте приложение. Новые версии исправляют ошибки и улучшают совместимость с API.
• Следите за подпиской. Если вы используете Premium, продлевайте подписку заранее, чтобы избежать перерывов в работе.
• Контролируйте лимит устройств. Не подключайте больше 7 устройств одновременно. Периодически проверяйте список активных конфигураций в личном кабинете и удаляйте неиспользуемые.
• Проверяйте время на устройстве. Неправильное время — частая причина SSL-ошибок. Включите автоматическую синхронизацию.
• Используйте стабильный интернет. Для получения конфигурации требуется доступ к API. Избегайте сетей с жёсткими блокировками (например, корпоративных).
• Сохраняйте резервные копии конфигураций. Если вы используете self-hosted, храните файлы конфигураций в надёжном месте, чтобы быстро восстановить подключение.

Соблюдение этих правил снизит вероятность ошибок и упростит диагностику, если они всё же возникнут.

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

Если вы выполнили все шаги диагностики, но ошибка при получении конфигурации из API не исчезает, пора обращаться в поддержку Amnezia. Чтобы обращение было эффективным, подготовьте следующую информацию:

• Код ошибки — точный номер (например, 1100, 1103, 1104).
• Платформа — Windows, Android, iOS, Linux, macOS.
• Версия приложения — номер сборки (можно найти в настройках).
• Протокол — какой протокол вы используете (AmneziaWG, OpenVPN, WireGuard и т.д.).
• Описание действий — что вы делали перед ошибкой: создавали подключение, импортировали ключ, меняли сеть.
• Скриншоты — если возможно, приложите скриншот экрана с ошибкой.
• Логи приложения — в Amnezia есть функция экспорта логов, которая помогает разработчикам.

Куда обращаться:

• Электронная почта: support@amnezia.org
• Telegram-чат: ссылка есть на официальном сайте Amnezia.

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

Вопросы и ответы