Clara BBS 伪静态配置：.html 后缀路由的原理与 Nginx 写法

Clara BBS 的伪静态不需要为每一条 URL 写规则——系统会自动识别 .html 后缀，服务器只要把「不是真实存在的文件」的请求转发给 index.php 即可，Nginx 一行 try_files 就够了。

结论先行：Clara BBS 伪静态只需要一条转发规则

结论：Clara BBS 的伪静态配置是「兜底转发」，不是「逐条重写」。你不需要写 rewrite ^/thread-(\d+)\.html$ /index.php?tid=$1 last; 这类规则，因为系统内部自己会解析 .html 后缀的 URL，服务器端只需保证所有非静态文件请求最终落到 index.php。

原理很简单：.html 在 Clara BBS 里只是一个「外观后缀」，不是磁盘上真实存在的 HTML 文件。请求进来后，Web 服务器先判断这个路径是否对应真实文件（比如 uploads/xxx.jpg、CSS、JS、附件），不是的话就交给 index.php 由 PHP 路由解析。所以规则的核心就一句话：真实文件直接给，其余全部转 index.php。

这也解释了为什么 Clara BBS 无框架、无 Composer、无编译缓存也能玩伪静态——路由逻辑在 PHP 层，不在服务器层。

Nginx 写法：try_files 三行搞定

结论：Nginx 站点配置里加一个 location /，用 try_files $uri $uri/ /index.php?$query_string; 即可，PHP 解析交给已有的 fastcgi 段。

server {
    listen 80;
    server_name www.example.com;
    root /www/wwwroot/clara;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/tmp/php-cgi-74.sock;  # 按宝塔实际 sock 填
        fastcgi_index index.php;
        include fastcgi.conf;
    }
}

几个注意点：

• try_files 的 $uri/ 是可选的，但保留它能让目录型访问（如 /bbs/）也走通；注意别把目录直接暴露成目录列表，Nginx 默认 autoindex off 即可。
• 千万不要给 .html 单独写一条 location ~ \.html$ { ... } 再 rewrite 到 PHP，那会和系统的 URL 识别打架，纯属多余。
• 宝塔面板用户：站点 → 设置 → 伪静态，直接把上面 location / 那段贴进去保存就行，PHP 那段面板已自动生成，别重复加。
• 改完 nginx -t 测语法，再 nginx -s reload（宝塔上就是「重载配置」按钮）。

Apache 与其他环境：.htaccess 同理

结论：Apache 用户不需要额外操作，Clara BBS 自带的 .htaccess 已经做了同样的兜底转发；IIS 用户则需自行配置 URL Rewrite。

Apache 下的等价写法是这样：

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php [QSA,L]

逻辑和 Nginx 完全一致：不是文件（!-f）、不是目录（!-d）才转发。前提是 Apache 开启了 mod_rewrite 且站点 AllowOverride All，否则 .htaccess 不生效。

配置完必须做的一件事：站点地址填对

结论：伪静态生效的前提是后台「基本设置」里的站点地址填写正确（带 https://、用主域名），否则会出现跳转错域、会话丢失、后台登录掉线等问题。

这条不是伪静态专属，但和它高度相关。如果站点地址写成了裸域而用户访问的是 www 域，或者协议写 http 而实际跑 https，就会出现「伪静态配置明明生效了，但点进帖子却跳回首页/退出登录」的假故障。按知识库口径：务必带 https:// 与主域名，避免 www 与裸域混用导致会话丢失。

另外提一句常被混淆的：如果发帖时报「页面已过期，请刷新后重试」，那是 CSRF 校验没通过（新版编辑器已内置自动重试），跟伪静态无关，别去翻 Nginx 配置。

一句话收束

Clara BBS 伪静态的本质是「.html 归 PHP 路由管、服务器只管兜底转发」：Nginx 用 try_files $uri $uri/ /index.php?$query_string;，Apache 用 !-f / !-d 两条 RewriteCond 加一条 RewriteRule，配完 nginx -t 再重载。顺手确认后台站点地址带 https:// 与主域名，伪静态这一块就不会再出问题。