Для настройки транслируемых поддоменов требуется правильная конфигурация DNS, SSL/TLS и источника. Для упрощения поиска и устранения неисправностей Linguise теперь предоставляет отладчик трансляции поддоменов, который проверяет вашу настройку и выделяет проблемы с конфигурацией или подключением.
Отладчик помогает определить причину сбоя проверки настроек и предоставляет соответствующую информацию об ошибке, чтобы вы могли устранить проблему и повторно проверить конфигурацию.
Что проверяет отладчик трансляции поддоменов?
Отладчик проверяет конфигурацию DNS, SSL/TLS-соединения и исходный веб-сайт (источник). Он проверяет право собственности на домен, транслированные записи CNAME поддоменов, записи A/AAAA, сертификаты и доступность HTTPS.
Также проверяется, доступен ли источник извне, и возвращается пригодный для использования HTTP-ответ. Каждая проверка возвращает статус и, если применимо, код ошибки.
Понимание результатов диагностики
Отладчик использует различные статусы для отображения результата каждой проверки.
Неуспешный
Статус «Сбой» означает, что отладчик обнаружил проблему с конфигурацией или подключением, которую необходимо устранить. Проверьте код ошибки и диагностические данные, чтобы определить затронутый компонент, например, DNS, SSL/TLS или исходный веб-сайт. После устранения проблемы повторно запустите проверку настроек, чтобы убедиться в результате.
Предупреждение
Статус «Предупреждение» означает, что веб-сайт доступен, но его ответ может препятствовать надежному переводу или указывать на потенциальную проблему с конфигурацией. Просмотрите диагностические данные и проверьте исходный веб-сайт, сервер или конфигурацию сети, как указано. После устранения проблемы повторно запустите проверку настройки.
Неизвестный
Статус «Неизвестно» означает, что отладчик не смог получить достоверный результат проверки. Сначала повторите проверку настройки. Если статус сохраняется, просмотрите диагностическую информацию и выясните, не является ли причиной проблемы проблема с DNS, TLS или подключением.
Пропущено
Статус «Пропущено» означает, что проверка не могла быть выполнена, поскольку предыдущая необходимая проверка завершилась неудачей. Например, проверка TLS может быть пропущена, если преобразованное имя хоста не может быть разрешено через DNS. Статус «Пропущено» означает, что проверка не могла быть выполнена, поскольку предыдущая проверка завершилась неудачей. Сначала исправьте предыдущую неудачную проверку, а затем повторно запустите проверку настройки.
Ошибки DNS
Ошибки DNS возникают, когда записи, необходимые для связи ваших переведенных поддоменов или исходного веб-сайта, отсутствуют, некорректны или не могут быть разрешены.
Неверная или отсутствующая запись CNAME поддомена
Эта ошибка означает, что имя хоста переведенного языка не разрешается в требуемый целевой объект CNAME Linguise .
Проверьте конфигурацию DNS для имени хоста соответствующего языка и убедитесь, что его запись CNAME указывает на Linguise указанный при настройке. Если запись отсутствует или указывает на неправильный целевой язык, обновите ее у своего DNS-провайдера. Отладчик может сообщить о следующих ошибках:
- DNS_CNAME_NXDOMAIN: не удается разрешить преобразованное имя хоста.
- DNS_CNAME_MISMATCH: запись CNAME указывает на неверный целевой объект.
Проверка права собственности на домен
Эта ошибка означает, что необходимая запись _linguiselinguise отсутствует или её значение не соответствует текущему значению проверки. Отладчик может сообщить об ошибке DNS_TXT_MISMATCH, если запись TXT не содержит ожидаемого значения проверки.
Откройте своего DNS-провайдера и проверьте разделlinguise.<domain> TXT-запись. Добавьте запись, если она отсутствует, или обновите ее значение на значение проверки, предоставленное Linguise.
Не удаляйте из домена лишние TXT-записи. После того, как изменения DNS распространятся, повторно запустите проверку настройки.
Исходная ошибка DNS домена
Эта ошибка означает, что исходный домен не разрешается в пригодную для использования публичную запись A или AAAA. Проверьте свои DNS-записи и убедитесь, что домен разрешается в правильный публичный IP-адрес.
Если запись отсутствует или некорректна, обновите ее у своего DNS-провайдера. Дождитесь распространения изменений DNS, затем снова запустите проверку настройки.
Ошибки SSL/TLS
Ошибки SSL/TLS возникают, когда Linguise не может установить действительное защищенное HTTPS-соединение с переведенным поддоменом или исходным веб-сайтом.
Ошибка SSL/TLS при переводе поддомена
Эта ошибка означает, что Linguise не удалось установить действительное TLS-соединение с переведенным именем хоста.
Убедитесь, что имя хоста имеет действительный, непросроченный SSL-сертификат, точно соответствующий имени хоста. Также убедитесь, что цепочка сертификатов полна и что HTTPS доступен на порту 443.
Если вы используете CDN, обратный прокси или WAF, проверьте их конфигурацию TLS и убедитесь, что она не препятствует подключению. После исправления конфигурации повторно запустите проверку настроек.
Исходная ошибка SSL/TLS на веб-сайте
Эта ошибка означает, что Linguise не удалось установить действительное HTTPS-соединение с исходным веб-сайтом.
Проверьте исходный сертификат на предмет истечения срока действия, несоответствия имени хоста, неполной цепочки сертификатов или других проблем с конфигурацией TLS. Если ваш веб-сайт использует CDN или обратный прокси-сервер, также убедитесь, что для исходного соединения предоставляется правильный сертификат. Исправьте сертификат или конфигурацию TLS, а затем повторно запустите проверку настройки.
Ошибки исходного веб-сайта
Ошибки источника возникают, когда Linguise не может корректно связаться с исходным веб-сайтом или не получает от него приемлемого ответа.
Ошибка источника и пункта назначения
Эта ошибка означает, что настроенный источник указывает на адрес назначения, к которому Linguise не имеет доступа. Убедитесь, что домен указывает на общедоступный адрес назначения.
Если в качестве источника используется частный, замыкающий или локальный адрес, обновите конфигурацию источника, указав общедоступный адрес назначения, а затем снова выполните проверку настройки.
Исходные HTTP-ошибки
Эта ошибка означает, что Linguise может связаться с исходным веб-сайтом, но получает HTTP-ответ, который может препятствовать надежному переводу.
К распространённым причинам относятся тайм-ауты запросов, требования к аутентификации, ограничения скорости запросов, перенаправления или ошибки сервера. Проверьте непосредственно исходный веб-сайт и просмотрите конфигурацию вашего сервера, брандмауэра, WAF, аутентификации и ограничения скорости запросов.
Убедитесь, что исходный веб-сайт может возвращать корректный ответ на запросы от Linguise, а затем повторно запустите проверку настройки.
Диагностические и ошибки во время выполнения
Диагностические и ошибки времени выполнения связаны с отладчиком или его диагностическим процессом, а не обязательно указывают на проблему с DNS, TLS или конфигурацией источника.
CORE_CHECKER_FAILED
Эта ошибка означает, что основной диагностический инструмент не смог успешно завершить проверку. Повторите проверку настройки и, если доступны, просмотрите подробные диагностические данные. Если ошибка повторяется, проверьте, не влияют ли на процесс диагностики какие-либо проблемы с конфигурацией или подключением.
DIAGNOSTIC_CONFIG_CHANGED
Эта ошибка означает, что конфигурация диагностики изменилась во время выполнения проверки, поэтому результат может быть уже недействительным. Запустите диагностику еще раз, используя текущую конфигурацию, чтобы убедиться, что проверка использует последние настройки.
ПРЕВЫШЕН СРОК ДИАГНОСТИКИ
Эта ошибка означает, что диагностическая операция не завершилась в отведенное время. Повторите проверку настроек и просмотрите подробные диагностические данные, чтобы определить, не задерживает ли проверка текущую конфигурацию или проблемы с подключением.
DIAGNOSTIC_DOMAIN_NOT_FOUND
Эта ошибка означает, что диагностика не смогла найти или разрешить настроенный домен. Убедитесь, что домен правильно настроен и что его DNS-записи общедоступны. После исправления любых проблем с конфигурацией DNS или домена запустите проверку настройки еще раз.
DIAGNOSTIC_INVALID_REQUEST
Эта ошибка означает, что диагностический запрос не может быть обработан, поскольку запрос недействителен. Повторите проверку настроек и убедитесь, что диагностика выполняется с текущей конфигурацией и действительными данными запроса.
DIAGNOSTIC_PROBE_FAILED
Эта ошибка означает, что отдельный диагностический зонд не завершился успешно. Повторите диагностику и просмотрите доступные сведения, чтобы определить, какой зонд не прошел проверку и связана ли проблема с текущей конфигурацией или подключением.
ДИАГНОСТИЧЕСКАЯ НЕУДАЧА
Эта ошибка означает, что общий процесс диагностики не дал достоверного результата. Повторите проверку настройки и просмотрите все доступные диагностические данные, включая имя затронутого хоста, идентификатор запроса и метку времени, чтобы помочь определить причину.
Если ошибка сохраняется после повторной попытки и проверки соответствующей конфигурации, предоставьте код ошибки и подробные сведения о диагностическом запросе в службу поддержки Linguise для дальнейшего расследования.
Как решить проблему
При устранении неполадок, возникших в результате неудачной проверки настройки, исправляйте проблемы в порядке, указанном в результатах диагностики:
- Владение доменом и DNS: Убедитесь, что необходимые записи TXT, CNAME и A/AAAA правильно настроены и доступны для публичного доступа.
- SSL/TLS: Проверьте соответствующие сертификаты, конфигурацию имени хоста, цепочку сертификатов и доступность HTTPS.
- Источник: Убедитесь, что исходный веб-сайт общедоступн и что его сервер, брандмауэр, WAF, аутентификация и конфигурация ограничения скорости позволяют Linguise получить к нему доступ.
- Повторите проверку настроек: после применения необходимых исправлений и предоставления времени для распространения изменений DNS, повторно запустите проверку настроек.
Исправление ранее возникшей ошибки DNS или проблемы с подключением может также устранить зависимые ошибки TLS или ошибки источника, а также проверки, которые ранее были помечены как пропущенные.
Отладчик трансляции поддоменов упрощает выявление и устранение неполадок DNS, SSL/TLS и проблем с источником, влияющих на транслируемые поддомены. Просмотрите сообщение об ошибке, примените рекомендуемое исправление и снова запустите проверку настроек, чтобы убедиться в правильности вашей конфигурации.
Если проблема сохраняется после выполнения рекомендованных шагов по устранению неполадок, обратитесь в Linguise службу поддержки за дополнительной помощью.
