返回托管常见问题
帮助中心 · 常见问题托管1 分钟阅读

为什么静态网站部署需要 index.html 文件?

访客打开网站根路径时,托管服务需要提供一个入口文档。IaGenify 的静态部署要求包含 `index.html`;如果缺少该文件,部署会被拒绝,无法发布为可用网站。

托管

提供网站入口文件

浏览器请求不带文件路径的主机名时,托管服务需要返回默认文档。静态网站通常使用 `index.html` 作为入口,并由它引用或加载页面的其他资源。

仅上传图片、脚本或嵌套页面,并不能说明根路径应显示什么内容。

请将 `index.html` 以正确名称放在部署文件集的根目录。如果构建工具把文件输出到 `dist` 或 `out` 等目录,请部署该目录的内容,并确认入口文件位于最上层。

上传项目的父目录可能多出一级目录,导致入口文件无法被找到。

检查已部署根目录和资源路径

部署前检查文件列表,确保入口文档引用的资源在上传后确实存在。本地可用的路径如果带有本机目录前缀,或假设了不同的基础 URL,发布后可能失效。已部署目录结构应与 HTML 中的引用相匹配。

部署后打开网站根 URL,并在失败时检查浏览器响应。根路径返回 404 可能表示入口文件缺失或位置错误;页面能打开但没有样式,则可能是资源路径失效。

修正构建输出或所选部署目录后重新部署,并同时检查根页面和一个有代表性的资源 URL。

返回托管常见问题