设置翻译后的子域名需要正确的 DNS、SSL/TLS 和源配置。为了方便故障排除， Linguise 现在提供了一个子域名翻译调试器，它可以检查您的设置并突出显示配置或连接问题。.
调试器可帮助您确定导致设置检查失败的原因，并提供相关的错误信息，以便您可以修复问题并再次验证您的配置。.
子域名翻译调试器检查哪些内容？
调试器会检查 DNS 配置、SSL/TLS 连接和原始网站（源）。它会验证域名所有权、已转换的子域名 CNAME 记录、A/AAAA 记录、证书以及 HTTPS 可用性。.
它还会检查源是否可公开访问，并返回可用的 HTTP 响应。每次检查都会返回一个状态，并在适用时返回一个错误代码。.
理解诊断结果
失败的
“失败”状态表示调试器检测到配置或连接问题，需要进行修复。请检查错误代码和诊断详情，以确定受影响的组件，例如 DNS、SSL/TLS 或源网站。修复问题后，请再次运行设置检查以验证结果。.
警告
警告状态表示网站可访问，但其响应可能导致翻译不可靠或存在潜在的配置问题。请查看诊断详情，并按指示检查源网站、服务器或网络配置。问题解决后，请重新运行设置检查。.
未知
“未知”状态表示调试器无法为检查建立可靠的结果。请先重试设置检查。如果状态仍然存在，请查看诊断信息，并调查是否存在底层 DNS、TLS 或连接问题导致此问题。.
跳过
“已跳过”状态表示由于先前必需的检查失败，因此无法运行此检查。例如，如果无法通过 DNS 解析转换后的主机名，则可能会跳过 TLS 检查。“已跳过”状态表示由于先前的检查失败，因此无法运行此检查。请先修复先前失败的检查，然后再重新运行设置检查。.
DNS错误
当连接已翻译的子域名或原始网站所需的记录缺失、不正确或无法解析时，就会发生 DNS 错误。.
子域名 CNAME 不正确或缺失
此错误表示翻译后的语言主机名无法解析为所需的 Linguise CNAME 目标。.
检查 DNS 配置 ，确保其 CNAME 记录指向 Linguise 目标。如果记录缺失或指向错误的目标，请联系您的 DNS 提供商进行更新。调试器可能会报告以下错误：
- DNS_CNAME_NXDOMAIN： 无法解析已转换的主机名。
- DNS_CNAME_MISMATCH： CNAME 指向错误的目标。
域名所有权验证
此错误表示所需的 _linguiselinguise 记录缺失，或其值与当前验证值不匹配。 当 TXT 记录不包含预期的验证值时，调试器可能会报告 DNS_TXT_MISMATCH 错误。
打开您的 DNS 提供商并检查 _linguise。<domain> TXT 记录。如果记录缺失，则添加该记录；否则，将其值更新为 Linguise提供的验证值。.
请勿从您的域名中删除无关的 TXT 记录。DNS 更改生效后，请再次运行设置检查。.
原始域名 DNS 错误
此错误表示原始域名无法解析到可用的公网 A 或 AAAA 记录。请检查您的 DNS 记录，确保该域名解析到正确的公网 IP 地址。.
如果记录缺失或错误，请联系您的 DNS 提供商进行更新。等待 DNS 更改生效后，再次运行设置检查。.
SSL/TLS 错误
当 Linguise 无法与翻译后的子域名或原始网站建立有效的安全 HTTPS 连接时，就会发生 SSL/TLS 错误。.
翻译子域名 SSL/TLS 错误
此错误表示 Linguise 无法与翻译后的主机名建立有效的 TLS 连接。.
检查主机名是否拥有有效且未过期的 SSL 证书，该证书必须与主机名完全匹配。同时验证证书链是否完整，以及 HTTPS 服务是否在 443 端口可用。.
如果您使用 CDN、反向代理或 WAF，请检查其 TLS 配置，确保其不会阻止连接。修复配置后，请再次运行设置检查。.
原始网站 SSL/TLS 错误
此错误表示 Linguise 无法与原始网站建立有效的 HTTPS 连接。.
检查源证书是否过期、主机名是否匹配、证书链是否完整或其他 TLS 配置问题。如果您的网站使用 CDN 或反向代理，还要验证源连接是否使用了正确的证书。修复证书或 TLS 配置问题后，重新运行设置检查。.
Origin网站错误
当 Linguise 无法正确连接到原始网站或未收到来自该网站的可用响应时，就会发生源错误。.
源目标错误
此错误表示配置的源解析到 Linguise 无法访问的目标地址。请确保该域名解析到可公开访问的目标地址。.
如果源地址使用私有地址、环回地址或链路本地地址，请更新源配置以使用公共可达的目标地址，然后再次运行设置检查。.
源 HTTP 错误
此错误意味着 Linguise 可以访问原始网站，但会收到一个 HTTP 响应，这可能会阻止可靠的翻译。.
常见原因包括请求超时、身份验证要求、速率限制、重定向或服务器错误。请直接检查源网站，并检查您的服务器、防火墙、Web 应用防火墙 (WAF)、身份验证和速率限制配置。.
确保原始网站能够对 Linguise的请求返回有效响应，然后重新运行设置检查。.
诊断和运行时错误
诊断错误和运行时错误与调试器或其诊断过程有关，并不一定表示 DNS、TLS 或源配置问题。.
核心检查器失败
此错误表示核心诊断程序未能成功完成检查。请重试设置检查，并查看诊断详情（如有）。如果错误仍然存在，请检查是否存在任何配置或连接问题影响了诊断过程。.
诊断配置已更改
此错误表示诊断配置在检查运行时发生了更改，因此结果可能不再有效。请使用当前配置重新运行诊断，以确保检查使用最新设置。.
诊断截止日期已过
此错误表示诊断操作未在允许的时间内完成。请重试设置检查并查看诊断详情，以确定检查是否因当前配置或连接问题而延迟。.
未找到诊断域
此错误表示诊断程序无法找到或解析已配置的域名。请检查域名是否配置正确，以及其 DNS 记录是否可公开访问。更正任何 DNS 或域名配置问题后，请再次运行设置检查。.
诊断无效请求
此错误表示诊断请求无效，因此无法处理。请重试设置检查，并确保诊断程序使用当前配置和有效的请求详细信息运行。.
诊断探针失败
此错误表示某个诊断探测未能成功完成。请重试诊断并查看可用详细信息，以确定是哪个探测失败，以及问题是否与当前配置或连接有关。.
诊断失败
此错误表示整个诊断过程未能产生有效结果。请重试设置检查，并查看所有可用的诊断详细信息，包括受影响的主机名、请求 ID 和时间戳，以帮助确定原因。.
如果重试并检查相关配置后错误仍然存在，请将错误代码和诊断请求详细信息提供给 Linguise 支持部门进行进一步调查。.
如何解决这个问题
在排查失败的设置检查问题时，请按照诊断结果指示的顺序修复问题：
- 域名所有权和 DNS：确保所需的 TXT、CNAME 和 A/AAAA 记录已正确配置且可公开解析。
- SSL/TLS：检查相关证书、主机名配置、证书链和HTTPS可用性。
- 来源：确保原始网站可公开访问，并且其服务器、防火墙、WAF、身份验证和速率限制配置允许 Linguise 访问它。
- 再次运行检查设置：应用必要的修复程序并等待 DNS 更改传播后，再次运行检查设置。
修复先前的 DNS 或连接错误也可能解决相关的 TLS 或源错误，以及先前标记为“已跳过”的检查。.
子域名转换调试器可以更轻松地识别和排查影响已转换子域名的 DNS、SSL/TLS 和源站问题。查看报告的错误，应用建议的修复方案，然后再次运行“检查设置”以确认配置是否正常工作。.
如果按照建议的故障排除步骤操作后问题仍然存在，请联系 Linguise 支持部门 以获得进一步帮助。
