讲师中心 微信公众号
AI工具推荐 视频效率加速

宝塔面板如何设置默认首页_网站首页文件配置方法【教程】

星强酱_1506

星强酱_1506

发布时间:2026-03-15 21:40:03

|

731人浏览过

|

来源于php中文网

原创

宝塔默认文档按列表顺序查找首个存在的文件作为首页,需确认文件真实存在、调整顺序、清除缓存;支持自定义首页名但须手动添加;伪静态可能劫持请求,需检查rewrite规则;多站点时IP访问由default_server配置决定。

宝塔面板如何设置默认首页_网站首页文件配置方法【教程】

默认文档顺序决定首页加载逻辑

宝塔不是靠“首页文件名”硬编码识别首页,而是按 默认文档 列表从上到下依次查找——第一个存在的文件就是实际打开的首页。比如列表是 index.html、index.php、default.html,而你的网站根目录只有 index.php 和 default.html,那最终加载的是 index.php,不是因为名字更“标准”,只因它排在前面且存在。

  • 进入站点设置 → 左侧点击 默认文档,直接拖拽调整顺序即可生效
  • 别只加文件名,要确认该文件真实存在于网站根目录(如 /www/wwwroot/your-site/index.html)
  • 如果改完顺序仍不生效,大概率是浏览器缓存或 CDN 缓存了 301 跳转,用隐身窗口或 curl -I 域名 查 HTTP 状态码验证

添加自定义首页文件(比如 1.html 或 home.php)

你完全可以用非传统名称做首页,比如把 1.html 设为默认,但必须显式添加进 默认文档 列表,否则宝塔不会主动找它。这个操作本身无风险,但要注意:一旦添加,它就参与从左到右的匹配流程,位置太靠前可能意外覆盖掉本该执行的 index.php(比如 Laravel 或 WordPress 入口)。

  • 在 默认文档 页面底部输入框填入 1.html,点 添加
  • 拖到最顶端,才能确保优先级最高
  • 若同时存在 index.php 和 1.html,且 1.html 在前,访问域名将直接返回 1.html 的内容,index.php 不会运行

伪静态规则可能悄悄劫持首页请求

很多 CMS(如 Typecho、WordPress)或框架(如 ThinkPHP)启用了伪静态后,Nginx/Apache 会把所有请求重写到入口文件(如 index.php)。这时候即使你把 index.html 拖到第一位,实际访问仍走 PHP 路由——因为请求根本没落到静态文件匹配阶段,早在 rewrite 规则里就被拦截了。

  • 临时关闭伪静态(站点设置 → 伪静态 → 选 纯静态),测试是否能正确加载 index.html
  • 如果关闭后正常,说明问题出在 rewrite 规则对 / 的处理逻辑,需检查规则中是否有类似 try_files $uri $uri/ /index.php?$args; 这类兜底语句
  • 不要盲目删规则,应针对性补充例外:例如在 Nginx 配置中加 location = / { try_files /index.html /index.php; }

多个站点共存时,默认站点行为易被忽略

当服务器绑定了多个域名,但用户直接访问 IP 或未匹配域名时,Nginx 会启用“默认 server”。这个默认行为不由单个站点的 默认文档 控制,而是由虚拟主机配置文件的 default_server 标志和文件加载顺序决定。很多人调好了某个站点的首页,却在浏览器输 IP 时看到宝塔默认页或 403,就是这个原因。

  • 想让某个站点响应 IP 访问?添加新站点时,域名栏留空或填 0.0.0.0,并确保其配置文件名以 0_ 开头(如 0_default.conf)
  • 检查 /www/server/panel/vhost/nginx/ 下文件排序,Nginx 按字母序读取,0_ 开头的会最先加载
  • 已有站点想设为默认?不建议手动改 listen 80 default_server,容易和宝塔自动管理冲突;优先用“留空域名 + 文件名前置”方式

真正麻烦的不是设哪个文件是首页,而是搞清请求到底经过了哪一层:DNS 解析 → Nginx server 匹配 → location 路由 → 默认文档查找。漏掉任意一环,页面就可能和你预期的完全不同。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

40

2026.10.22

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。

20

2026.10.22

Golangci-lint检查器使用教程
Golangci-lint检查器使用教程

本专题整理Golangci-lint常用Linters的用途与配置方法,覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查,帮助项目合理选规则。

20

2026.10.22

Gradle怎么构建Java项目
Gradle怎么构建Java项目

本专题介绍Gradle Java项目构建方法,涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查,帮助你理解各阶段的任务关系,逐步完成项目构建。

0

2026.10.22

PHP时间戳漏洞修复教程
PHP时间戳漏洞修复教程

本专题汇总PHP常见时间戳漏洞,包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等,并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案,帮助开发者快速排查和加固时间相关代码。

20

2026.10.22

Golangci-lint配置文件与规则设置
Golangci-lint配置文件与规则设置

本专题聚焦Golangci-lint YAML配置文件,讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置,便于团队统一检查标准。

20

2026.10.22

Golangci-lint安装与入门教程
Golangci-lint安装与入门教程

本专题讲解Golangci-lint的安装、初始化、基础命令和首次代码检查,覆盖本地环境、Docker及多平台用法,帮助Go开发者快速上手。

20

2026.10.22

PHP2Shell高危漏洞修复教程
PHP2Shell高危漏洞修复教程

PHP2Shell漏洞是什么,哪些PHP版本和运行环境会受到影响,服务器应该如何检测与修复?本专题提供版本自查脚本、Linux与Docker升级命令、PHP-FPM和Apache排查步骤,以及修复验证、临时缓解和应急响应方案。

140

2026.10.22

剧云人物设定与关系管理教程
剧云人物设定与关系管理教程

本专题介绍剧云人物设定与关系管理,讲解角色小传、性格职业、人物目标、背景资料和关系网络的创建及维护方法。

20

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn