核心概念
你需要理解 DedeCMS 的首页生成机制:

- 动态首页 (
index.php): 这是网站的默认首页,它通过 PHP 代码从数据库中实时读取内容并生成页面,每次访问,服务器都需要执行数据库查询,速度相对较慢。 - 静态首页 (
index.html): 这是 DedeCMS 的核心功能之一,你可以通过后台的“生成”功能,将动态的index.php页面处理成一个静态的 HTML 文件,这个文件直接存储在网站根目录下,当用户访问时,Web 服务器(如 Nginx, Apache)会直接将这个 HTML 文件发送给浏览器,无需 PHP 解析和数据库查询,速度极快。
我们的目标就是让用户访问 你的域名/ 或 你的域名/index.html 时,都能看到并访问到这个静态的 index.html 文件。
后台直接生成(最简单、最推荐)
这是最直接的方法,适用于绝大多数情况。
操作步骤:
- 登录 DedeCMS 后台:使用你的管理员账号登录。
- 进入“生成”页面:在左侧菜单栏中找到并点击 “生成” 选项。
- 选择“主页”:在“生成”页面中,你会看到几个选项,点击 “主页”。
- 开始生成:点击页面上的 “开始生成主页” 按钮。
- 完成:系统会处理你的网站数据,并在网站根目录下生成一个名为
index.html的文件,生成成功后,你会看到提示信息。
如何访问:

生成完成后,你就可以通过浏览器直接访问 http://你的域名/index.html 来查看效果。
优点:
- 操作简单:只需在后台点击一下即可。
- 效果直接:生成的
index.html就是纯静态文件,访问速度最快。
缺点:
- 内容更新不及时:如果你的网站首页内容需要频繁更新,你需要手动或通过计划任务定期重新生成
index.html,否则用户看到的将是旧版本。
设置网站默认首页(服务器配置)
这个方法能实现输入域名 http://你的域名/ 时,服务器默认返回 index.html 文件,这是服务器级别的配置,非常高效。

重要提示:请务必先使用【方法一】在后台成功生成 index.html 文件,再进行此操作。
对于 Apache 服务器
-
找到配置文件:通常位于网站根目录下的
.htaccess文件中,如果不存在,你可以自己创建一个。 -
编辑文件:在
.htaccess文件中添加或修改以下内容:# 如果目录或文件存在,则直接访问目录或文件 DirectoryIndex index.html index.php index.htm
这行代码的含义是:当用户访问一个目录时(),服务器会按照
index.html->index.php->index.htm的顺序查找并返回第一个找到的文件,因为我们把index.html放在最前面,所以服务器会优先返回它。 -
保存文件:将修改后的
.htaccess文件上传到网站根目录。
对于 Nginx 服务器
-
找到配置文件:通常是
nginx.conf或你网站对应的虚拟主机配置文件(your_domain.conf)。 -
编辑
server块:在server块中找到index指令,并修改它:server { listen 80; server_name 你的域名; root /网站根目录路径; # 将 index.html 放在最前面 index index.html index.php; # ... 其他配置 ... # PHP 路由处理(确保 PHP 文件能正常工作) location ~ \.php$ { # ... PHP 配置 ... } } -
重启 Nginx:保存配置文件后,你需要重启或重载 Nginx 服务以使配置生效。
# 使用 systemctl (CentOS 7+/Ubuntu 16+) sudo systemctl restart nginx # 或使用 service sudo service nginx restart
优点:
- 无缝切换:用户输入域名后,服务器直接提供静态文件,体验极佳。
- SEO 友好:搜索引擎爬虫访问时直接抓取静态内容,效率高。
缺点:
- 需要服务器权限:需要修改服务器配置文件,对新手有一定门槛。
使用 JavaScript 自动跳转(不推荐,但可作为备选)
这种方法不推荐作为主要方案,因为它是在客户端(浏览器)执行的,不如服务器端跳转高效,但可以在某些特定情况下(如服务器配置权限受限时)作为临时解决方案。
操作步骤:
-
编辑模板文件:登录 DedeCMS 后台,进入 “模板” -> “默认模板管理”。
-
修改首页模板:找到你的首页模板文件(通常是
index.htm)。 -
添加 JavaScript 代码:在
<head>和</head>标签之间,添加以下 JavaScript 代码:<script> // 检查 URL 中是否包含 "index.html",如果没有,则跳转到它 if (!/index\.html/.test(window.location.pathname)) { window.location.href = "/index.html" + window.location.search; } </script> -
更新首页并生成:保存模板文件,然后回到后台 “生成” -> “主页”,重新生成你的首页。
工作原理:
当用户访问 http://你的域名/ 时,这个页面(由 index.php 动态生成)会加载并执行 JavaScript 代码,代码检测到当前地址不是 index.html,于是立即将浏览器地址重定向到 index.html。
优点:
- 无需服务器配置:只修改网站文件即可。
缺点:
- 首次访问慢:用户第一次访问时,仍然需要加载动态页面
index.php,然后才会触发跳转,体验不佳。 - 对搜索引擎不友好:搜索引擎可能会认为这是一个“重定向”页面,而不是直接的内容页面,可能会影响抓取效率。
- 依赖 JavaScript:如果用户禁用了 JavaScript,跳转将不会发生。
总结与最佳实践
| 方法 | 优点 | 缺点 | 推荐度 |
|---|---|---|---|
| 后台生成 | 简单直接,纯静态访问 | 内容更新需手动重新生成 | ⭐⭐⭐⭐⭐ (基础必备) |
| 服务器配置 | 服务器优先返回,速度最快,SEO最佳 | 需要服务器权限,操作稍复杂 | ⭐⭐⭐⭐⭐ (强烈推荐配合方法一使用) |
| JS跳转 | 无需服务器权限 | 首次访问慢,对SEO不友好 | ⭐ (仅作为备选方案) |
最佳实践流程:
-
首选组合:【方法一】+【方法二】。
- 在 DedeCMS 后台生成
index.html。 - 根据你的服务器类型(Apache 或 Nginx),修改相应的配置文件,将
index.html设为第一优先级的默认首页。 - 这样,你的网站既能享受静态页面的极致速度,又能通过简单的后台生成操作来更新内容。
- 在 DedeCMS 后台生成
-
内容更新策略:如果你的首页内容不常变,手动生成即可,如果内容更新频繁,可以考虑使用 DedeCMS 的 “计划任务” 功能,设置定时自动生成首页,实现内容的准实时静态化。
