如何将index.html设为网站主页？-html教程-PHP中文网

服务器默认优先查找index.html作为首页，但需确保其位于网站根目录、权限正确且大小写准确；若未生效，应检查Web服务配置中默认索引文件顺序、文件路径与权限，并排除缓存或大小写问题。

如何将index.html设为网站主页？

服务器默认会查找特定文件名作为首页，index.html 正是绝大多数 Web 服务器（如 Nginx、Apache、Caddy）的默认索引文件之一——只要它存在且权限正确，通常无需额外配置就能被自动加载。

不同服务器默认行为略有差异：

Apache：默认启用 DirectoryIndex 指令，值通常包含 index.html（查看 .htaccess 或主配置中的 DirectoryIndex 行）
Nginx：默认 index 指令已包含 index.html（检查 server 块中是否有类似 index index.html index.htm;）
Vercel / Netlify / GitHub Pages：原生支持 index.html，无需配置，但需确保它位于项目根目录（不是 src/ 或 public/ 子目录下，除非构建后已输出到根）
本地开发服务（如 python -m http.server）：只识别 index.html，不识别 Index.html 或 INDEX.HTML（大小写敏感）

即使文件名为 index.html，仍可能无法访问主页，重点排查以下几点：

实现 Markdown↔ HTML 互转，支持导出 PDF，用于用户请求的文档格式转换。

下载

文件实际路径是否在 Web 根目录下？例如 Nginx 的 root /var/www/html;，则 index.html 必须放在 /var/www/html/index.html
文件权限是否允许读取？运行 ls -l /path/to/index.html，确保 web 用户（如 www-data 或 nginx）有读权限（至少 -rw-r--r--）
是否误传了 Index.html（首字母大写）？Linux 文件系统区分大小写，index.html ≠ Index.html
浏览器是否缓存了 403/404 响应？尝试用隐身窗口或 curl -I http://localhost/ 直接看 HTTP 状态码
是否启用了 SPA 路由（如 React Router）却未配置服务端 fallback？此时访问子路径（如 /about）会 404，但根路径 / 仍应返回 index.html

以下情况才需修改服务器配置：

想把默认首页换成其他文件（如 home.html），Apache 需改 DirectoryIndex home.html，Nginx 需改 index home.html;
根目录下同时存在 index.html 和 index.php，而你希望优先用 HTML：确保 index.html 在 index 指令中排在前面（Nginx）或 DirectoryIndex 列表靠前（Apache）
使用 Caddy v2：默认已支持 index.html，但若自定义了 file_server，需显式加 index index.html
静态托管平台（如 GitHub Pages）启用了 gh-pages 分支，但 index.html 不在该分支的根目录——必须把它推送到 gh-pages 分支的最外层