用途
troubleshoot-website 用于诊断 Hostinger 托管网站的具体故障:网站宕机、访问缓慢、页面报错、证书不安全或构建失败。它的原则是「输入一个网站和一个症状,输出一个有名字的原因、对应证据和修复方案」,并在说明原因、获得用户同意之前保持只读,不擅自改动站点。
调用方式
该技能通过 Hostinger Connector 暴露的操作完成检查。首次调用每个操作前,应先读取 search 返回的 inputSchema;如果某个操作名被判定为未知,可改为按步骤用途搜索(例如「ssl status」)。多个读取操作可用 multi-execute 批量执行,并通过 $steps.<i>.<path> 在步骤间传值(如 "$steps.0.data.0.username"),批量执行遇到第一个失败即停止。由于 Connector 将各产品作为独立 MCP 服务器(hosting、wordpress、agency-hosting、domains、dns),一个批次只能串联同一服务器内的操作;搜索不到某操作时,说明该产品组在 Connector 中被关闭,需请用户启用。
主要能力与检查流程
1. 定位网站:对 Shared/Cloud 计划调用 hosting_websites_list(按 domain 过滤,因是子串匹配,需取域名完全一致的条目),保留 username、order_id 和 website_type;对 Agency 计划调用 agency-hosting_websites_list-plan,保留 details.uid、type、ipv4 和 domains。两者都找不到时,说明该域名不属于此账户下的网站,并展示其解析指向。
2. 从外部探测:并行执行 curl 获取 HTTP 状态码、TTFB 和重定向地址,curl -sSI 查看响应头,dig 查询 NS、A、CAA 记录。若响应中不含 platform: hostinger 和 panel: hpanel,或 DNS 指向别处,说明流量未到达该主机,应转交 connect-domain 技能。证书或 TLS 错误转 SSL 分支;5xx、空白页或错误页按网站类型分支;返回 200 但内容陈旧则清理缓存(hosting_cache_clear-website,WordPress 另加 wordpress_litespeed-cache_purge-lite-speed,Agency 用 agency-hosting_cache_clear-website);首字节慢则进入慢站检查,若在 Hostinger CDN 之后,x-hcdn-upstream-rt 表示源站自身响应时间,数值小说明瓶颈不在服务器。
3. 按网站类型分支:builder 和 horizons 类型站点不由这些操作管理,应引导用户到 hPanel。
- Node.js:批量读取最近构建、运行日志(1 小时内 ERROR/WARN)和环境变量键(值始终掩码)。最新构建失败时调用 hosting_nodejs_analyse-failed-build(每分钟限 5 次,返回空则读构建日志);常见原因是框架、输出目录或 entry_file 识别错误,可对比构建设置后修正并重新构建,同时用 hosting_nodejs_update-build-settings 保存,使后续 Git 推送也正确构建。构建成功但应用报错时读运行日志,早于 last_deployed_at 的条目属于上一次部署;代码读取但键列表中缺失的变量用 deploy-to-hosting 技能的环境变量步骤修复;出现「Access denied for user '…'@'::1'」说明应用连的是 localhost,DB_HOST 应为 127.0.0.1。进程挂起可用 hosting_nodejs_restart-application 重启(不重新构建)。
- WordPress:用 wordpress_installations_list 取 install id,批量执行有效性检查(force: true)、已安装插件列表和维护状态。安装无效时 validation_error 会指明问题;插件或主题变更后出错,可逐个停用可疑项(操作有队列延迟,需等待数秒),每次停用后重跑第 2 步检查,排除后重新启用;维护页卡住可用 wordpress_maintenance_toggle(enabled: false)关闭。出现「Error establishing a database connection」时用 hosting_databases_list 查看,表损坏可用 hosting_databases_repair 后台修复;由于含密钥的文件被拒绝,API 无法读取 wp-config.php,凭据检查需向用户提供 hosting_databases_phpmyadmin-link。内存或上传大小错误转 PHP 分支。
- 静态或 PHP:根路径 403/404 时用 hosting_files_list-website-and-directories(max_depth: 1)检查,index.html 或 index.php 必须位于文档根目录,若在下一级目录说明压缩包多套了一层,应用 deploy-to-hosting 技能平铺重新部署;.htaccess 等配置可用 hosting_files_website-content 读取;PHP 错误转 PHP 分支。
- PHP:hosting_php_get 返回全部扩展和选项(约 25 KB),仅在 PHP 问题时调用;hosting_php_update-version 可切换版本;hosting_php_update-options 会把值静默截断到计划上限(即 hosting_php_get 中的 max),因此需回读实际生效值。Agency 站点用 agency-hosting_php_list-options-for-website,再以 agency-hosting_php_replace-website-options 整体替换,需提交所有应保留的自定义选项。
- Agency 计划:agency-hosting_websites_get 显示状态与配额,agency-hosting_websites_list-processes 显示失败任务(SSL 设置、备份),agency-hosting_wordpress_settings 显示核心版本、LiteSpeed、对象缓存和维护模式;若 wordpress_installations_list 未返回该站点,插件需从 wp-admin 管理。
4. SSL:Shared/Cloud 用 hosting_ssl_status;not_installed 或 failed(last_error 说明原因)时,域名须解析到 Hostinger 且 CAA 记录允许 letsencrypt.org,hosting_ssl_install 才可能成功,之后轮询状态直到 active 或 failed;installing 或 waiting_for_retry 时需等待,重复请求会返回 422;免费 *.hostingersite.com 子域使用平台证书,安装按设计返回 422。证书已激活但浏览器仍警告时,若 is_https_redirect_enabled 为 false,可用 hosting_ssl_toggle-https-redirect 开启跳转,否则页面会加载 http:// 资源造成混合内容。Agency 站点对每个域名用 agency-hosting_ssl_website-status 检查;每个域名每七天允许三次证书设置、每分钟一次请求,安装或重装前先查进程列表,不得循环重试。
5. 慢站:WordPress 检查 LiteSpeed 缓存和 Memcached 对象缓存状态,开启 Memcached 通常是快速见效的手段。其他站点可能未开服务器缓存或仍处于开发模式,且两者均无读取操作;hosting_cache_toggle-website(enabled: true)在缓存已开时无效果,hosting_cache_toggle-cacheless(enabled: false)可关闭开发模式。PHP 7.x 明显慢于 8.x,应用兼容时可建议升级到受支持的 8.x。Agency 用 agency-hosting_metrics_list-order-resource-usage(time_frame_hours: 24)查看每个网站的 CPU、内存和进程占用与计划配额。Shared 和 Cloud 的 API 不提供 CPU/内存指标,证据指向资源限制时应引导用户到 hPanel 的资源使用页面。
应用修复
说明原因、证据和拟执行的单项变更,只有在用户同意后才执行;随后重跑第 2 步检查(先轮询队列任务)以确认症状消失。若修复需要 API 无法完成的动作,应明确说明并指出对应的 hPanel 页面。
限制
以下内容无法通过 API 完成:网站备份与恢复(hPanel 备份页)、Shared 和 Cloud 计划的 CPU/内存/进程使用情况、PHP 错误日志与访问日志。builder 和 horizons 类型站点不在这套操作的管理范围内。