页面静态化
校对日期:2026-11-16。适用于社区版及全部商业版;用定时任务定期重新生成需要商业版标准版及以上。
开启静态化后,首页、栏目页和文章页会事先生成为 HTML 文件,访问时直接发送文件,不再查询数据库和渲染模板。 适合访问量大、内容更新不太频繁的站点;默认不开启。本文说明怎样开启、生成的文件放在哪里,以及哪些改动之后要手动重新生成。
一、开启静态化
静态化按站点设置,有多个站点时先在右上角切换到要设置的站点。进入 配置 → 站点设置 → 静态化:

| 设置 | 说明 |
|---|---|
| 是否开启 | 静态化的开关,默认关闭 |
| 是否自动生成 | 开启时,新增、修改、删除文章和栏目会自动重新生成有关的页面;关闭时全部靠手动生成。默认开启 |
| 栏目静态化路径 | 栏目页的文件路径,默认 /channels/ |
| 文章静态化路径 | 文章页的文件路径,默认 /articles/ |
| 栏目列表静态化页数 | 栏目的文章列表生成前几页(1、3、10、100、1000 或全部),默认 1;后面的分页仍然是动态页面 |
点击 保存 后,系统随即在后台重新生成本站的全部静态页,进度在 系统 → 生成管理 的任务列表里(见“自动生成与手动生成”一节)。 页面中栏目和文章的链接在保存后立刻变成静态地址,生成完成之前点开会是 404,文章多的站点请等任务完成后再检查。
关闭 是否开启 并保存,已生成的静态页会被删除,栏目和文章的链接恢复为动态地址;以前的静态地址不再能访问。
二、静态页的地址与存放位置
静态页的地址就是文件的路径。按默认设置:
| 页面 | 地址 | 文件 |
|---|---|---|
| 首页 | / | /index.html |
| 栏目页 | /channels/news/ | /channels/,第 2 页为 /channels/ |
| 文章页 | /articles/ | /articles/ |
文件保存在 静态页存储点 里,默认是程序目录本身:Jar 部署为 <部署目录>/static,Tomcat 部署为 webapps/ROOT。 例如 Tomcat 装在 /opt/tomcat,上表的文章页就是 /opt/。 存储点在 配置 → 全局设置 → 存储设置 里修改,见存储点。在 文件 → HTML文件 里可以直接查看本站已经生成的文件。
以下情况路径前面会多出一段:
- 站点设置了子目录:文件在子目录之下,如
/en/index.html、/en/。articles/ 123456. html - 打开了多域名(配置 → 全局设置 → 基础设置 → 多域名):各站点的文件放在以站点域名命名的目录里,如
/www., 这样不同域名的站点不会互相覆盖首页。地址里并不带这一段,需要由 Nginx 把每个域名的example. com/ index. html root指到各自的目录,见“由谁发送静态页”一节。 - 站点的手机端模板主题与模板主题不同:另外生成一套手机端页面,放在
/m目录下,如/m/index.html。
路径的写法:
- 路径中可以使用变量,生成时替换为实际的值。栏目路径可用
{channel_id}(栏目 ID)、{channel_slug}(栏目别名); 文章路径另外可用{article_id}(文章 ID)、{article_slug}(文章别名,没有别名时为文章 ID), 以及文章创建时间的{year}、{month}、{day}。例如/{channel_。slug}/ {year}{month}/ {article_ id} - 扩展名
.html自动加上,不用填写。路径以/index结尾时,地址显示为以/结尾的目录形式。 - 只能使用字母、数字、下划线、中划线、斜杠和上面的变量,不能出现
..,最长 100 个字符。 - 个别栏目或文章要用特别的地址(如
/about)时,可以在栏目的 栏目静态路径、文章的 独立静态化路径 里单独填写。 这两项默认不显示,在 配置 → 模型管理 相应模型的系统字段里打开,见模型管理。 - 修改路径并保存后全部静态页会按新路径重新生成,旧地址随之失效;已经被搜索引擎收录的站点不要轻易改动。
不生成静态页的内容:
- 只有已发布的文章有静态页。文章下线或放入回收站之后,重新生成时(自动或手动)它的静态页即被删除。
- 类型为转向链接的栏目和填写了转向链接的文章,链接直接指向目标地址。
- 栏目列表超出 栏目列表静态化页数 的分页、文章正文第 2 页及之后的分页,使用动态地址。
- 专题、搜索、标签、会员中心等其它页面始终是动态页面。
三、自动生成与手动生成
自动生成(是否自动生成 开启时):
- 新增、修改、删除文章,或文章审核通过、到点上线下线时,重新生成这篇文章、同栏目中它的上一篇和下一篇、所属栏目及其各级上级栏目,以及首页。
- 新增、修改栏目时,重新生成该栏目、它的各级上级栏目和首页;栏目下的文章页不会重新生成。
其它改动不会触发生成,包括修改模板和主题设置、站点设置、区块内容。这些改动之后需要手动重新生成,页面才会更新。
手动生成:进入 系统 → 生成管理,使用 页面静态化 一行的按钮。操作只针对当前站点。

| 按钮 | 作用 |
|---|---|
| 全部更新 | 重新生成本站的全部文章页、栏目页和首页 |
| 更新首页 | 立即重新生成本站首页 |
| 更新栏目页 | 重新生成本站的全部栏目页 |
| 更新文章页 | 重新生成本站的全部文章页 |
除 更新首页 外,生成都在后台进行,下方的 任务列表 显示每个任务的完成数、耗时和状态(等待、运行中、出错、停止、完成)。 状态为出错时,点 详情 查看错误信息;删除一个运行中的任务会让它中止。站点没有开启静态化时,这些按钮不会生成任何页面。
定时生成(标准版):在 系统 → 定时任务 里新增一个类型为 更新全部静态页 的任务,按设定的时间定期重新生成当前站点的全部静态页。
权限:在 用户 → 角色管理 的权限树里,保存静态化设置对应“站点设置”下的 静态化,在生成管理里手动生成对应“生成管理”下的 页面静态化。
四、由谁发送静态页
- 程序自己发送。 不需要任何额外配置:静态页在程序目录里,程序会直接把文件发送出去,访问
/、/channels/news/这样的目录地址时发送其中的index.html。 - 由 Nginx 直接发送。 把 Nginx 的
root指向静态页所在的目录,文件不存在时再转发给程序, 配置见 Nginx 反向代理的“由 Nginx 直接发送静态文件”一节。站点地图、robots.txt等地址没有对应的文件,仍然要转发给程序, 见站点地图与搜索引擎提交的“静态化站点与反向代理”一节。 - 静态页存储点改到了程序目录之外,或者 打开了多域名 时,程序不会从这些位置发送静态页,必须由 Nginx 等 Web 服务器发送。 多域名时每个域名各写一个
server,root指向静态页存储点下与域名同名的目录。 - 多个节点的集群部署见集群部署。
五、使用静态化要注意的地方
- 需要登录才能浏览的栏目不生成静态页。 静态页是事先生成的文件,访问时不再判断栏目的浏览权限,所以游客组不能浏览的 栏目及其中的文章不生成静态页,链接用动态地址,访问时照常判断;页面里的文章列表、区块也只列游客能浏览的文章。 修改游客组的浏览权限后要全部更新一次静态页,见栏目浏览权限。
- 页面里不能有因人而异的内容。 所有访客拿到的是同一个文件,登录状态这类内容要在页面打开后用脚本加载。 默认主题已经这样处理;自己开发主题时见主题开发和前台表单与 AJAX 的 CSRF 令牌的“静态页与被缓存的页面”一节。
- 固定链接的设置不影响静态地址。 开启静态化后,文章地址以 文章静态化路径 为准。
六、常见问题
- 在服务器上找不到静态页文件。 先确认站点已经开启静态化(默认是关闭的),并且生成任务已经完成; 再按“静态页的地址与存放位置”一节确认查找的位置:静态页存储点的目录,加上子目录、域名或
/m这几段前缀。 - 开启静态化后,点栏目或文章出现 404。 静态页还没有生成完。到 系统 → 生成管理 的任务列表查看进度; 任务状态为出错时在 详情 里看错误信息,处理后点 全部更新 重新生成。
- 改了模板或站点设置,前台页面没有变化。 这些改动不会自动重新生成静态页,到 系统 → 生成管理 点 全部更新。
- 多个域名的站点首页显示成了另一个站点的内容。 没有打开多域名时,各站点的首页都生成为同一个
/index.html,互相覆盖。 到 配置 → 全局设置 → 基础设置 打开 多域名,再到各站点重新生成,并按“由谁发送静态页”一节配置 Nginx。