SuperAPI AI 工具集

alibabacloud-oss-static-website-diagnosis

前端与建站

查看项目

更新于 10-15 19:55

技能介绍

用途:诊断阿里云 OSS 静态网站托管相关问题,例如“静态网站打开变成下载”“打开 Bucket 地址不渲染 index.html”“首页与 404 规则是否配置正确”“未备案能否用作网站”“页面返回 403 或空白”。

主要能力:先校验调用者身份,再读取 Bucket 托管配置(GetBucketWebsite)、Bucket 元数据(GetBucketInfo:location/ACL)与绑定的自定义域名(ListBucketCname),并对默认域名发起一次匿名 HTTPS GET,记录浏览器可见的 HTTP 状态、Content-Type 与 OSS 错误码,据此把“下载还是渲染”的症状归因到具体原因(未配置托管、私有 ACL 阻断匿名访问、默认域名强制下载策略、缺少自定义域名),最后给出基于证据的结论与手动指引。

使用方式:所有诊断必须通过 scripts/ 下的脚本执行,入口为 static_website_diagnosis.py,身份检查用 sts_token.py;不要自行拼装 ossutil/SDK/curl 命令。示例:cd $SKILL_DIR && python3 scripts/static_website_diagnosis.py --bucket <name> [--endpoint <user-endpoint>] [--region <region>]。凭据仅由默认凭据链解析(OSS 用 ALIBABA_CLOUD_* 环境变量,身份检查用 aliyun CLI 默认凭据链,默认域名探测为匿名),不得读取、打印或传入 AK/SK/STS。aliyun CLI 需 3.3.3 或更新版本,可用 aliyun version 查看、aliyun upgrade --yes 升级。

限制:严格只读,禁止生成或执行任何变更类 OSS API(如 PutBucketWebsite、DeleteBucketWebsite、PutBucketPolicy、PutBucketAcl、PutObject*、DeleteBucket* 等),启用托管或改配置只能给控制台手动指引。不处理防盗链、域名绑定流程本身、通用默认域名直链问题与对象级错误,这些应转 alibabacloud-oss-direct-access-link-diagnosis。结论必须基于实际返回数据,查询失败或为空需如实记录;配置类问题需以 --question 调用脚本并引用 doc_verification.docs 返回的标题与 URL,离线时需说明无法与官方文档在线核对。退出码 0 表示有结论(OK/DEGRADED),1 表示无可用结论(缺输入),2 仅表示参数用法错误。具体收费、价格与平台支持情况暂未提供。