【憨小狗】 AI 设计稿

Xunruicms 增加独立 PHP 程序被路由接管 404 问题排查与解决全记录

一、问题描述

在 Xunruicms 网站根目录下新建文件夹，放入独立的 PHP 程序文件，通过完整 URL 访问时，请求被 Xunruicms 路由接管，显示 404 错误页面。具体表现为：新建的 zhengshu 目录下的 index.php 无法正常访问。

二、环境信息

项目	配置
网站域名	www.ccc.cn
CMS 系统	Xunruicms
网站根目录	/www/wwwroot/www.ccc.cn/public
PHP 版本	8.0
PHP 套接字	unix:/tmp/php-cgi-80.sock
Web 服务器	Nginx 1.24.0
服务器面板	宝塔面板

三、排查过程

第 1 步：分析伪静态规则

原始伪静态规则如下：

location / {
    if (-f $request_filename) {
        break;
    }
    if ($request_filename ~* "\.(js|ico|gif|jpe?g|bmp|png|css)$") {
        break;
    }
    if (!-e $request_filename) {
        rewrite . /index.php last;
    }
}

该规则逻辑：

• 文件存在 → 放行
• 静态资源（ js/css/图片等）→ 放行
• 文件/目录不存在 → 重写到 index.php 由 CMS 处理

初步判断：规则中只放行了静态资源扩展名，没有放行 PHP 文件，导致 PHP 请求被重写。

第 2 步：尝试方案一——在规则中添加 PHP 扩展名

将 php 加入放行列表：

if ($request_filename ~* "\.(js|ico|gif|jpe?g|bmp|png|css|php)$") {
    break;
}

结果：问题依旧。

第 3 步：尝试方案二——单独排除目录

添加 location /zhengshu/ 块：

location /zhengshu/ {
    try_files $uri $uri/ =404;
}

结果：目录可以访问，能看到文件列表，但 PHP 文件仍不执行，返回空白内容。

第 4 步：发现运行目录问题

Xunruicms 专业版/安全版的网站运行目录是 public 子目录。确认网站根目录为 /www/wwwroot/www.ccc.cn/public，而 zhengshu 文件夹建在了 public 外面，导致 Nginx 找不到。

解决：将 zhengshu 文件夹移到 public 目录内。

结果：目录可正常访问，但 PHP 文件仍无法解析执行。

第 5 步：发现缺少 PHP 处理块

根本原因： Nginx 配置中缺少 location ~ \.php$ 块，没有告诉 Nginx 如何将 PHP 文件转发给 PHP-FPM 进程解析。

第 6 步：配置 PHP 处理块

在宝塔面板的网站主配置文件（非伪静态规则文件）中，添加 PHP 处理块：

location ~ \.php$ {
    try_files $uri =404;
    fastcgi_pass unix:/tmp/php-cgi-80.sock;
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
}

放置位置：在 server 块中，include extension 之后、include rewrite 之前。

注意：该配置必须放在主配置文件（/www/server/panel/vhost/nginx/www.ccc.cn.conf）的 server 块中，不能放在伪静态规则文件（/www/server/panel/vhost/rewrite/www.ccc.cn.conf）中，否则会报错 "server" directive is not allowed here。

四、最终解决方案

完整 Nginx 配置（关键部分）

server
{
    listen 80;
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    listen [::]:80;
    server_name www.ccc.cn;
    index index.php index.html index.htm default.php default.htm default.html;
    root /www/wwwroot/www.ccc.cn/public;
    include /www/server/panel/vhost/nginx/extension/www.ccc.cn/*.conf;

    # ===== 添加 PHP 处理块 =====
    location ~ \.php$ {
        try_files $uri =404;
        fastcgi_pass unix:/tmp/php-cgi-80.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
    # ============================

    # ... 其他 SSL 、 rewrite 等配置保持不变 ...
}

操作步骤

1. 将独立 PHP 文件夹放在 public 目录内（如 /public/zhengshu/）
2. 在宝塔面板 → 网站 → 设置 → 配置文件 中添加 location ~ \.php$ 块
3. 保存配置，重载 Nginx ：nginx -t && nginx -s reload
4. 访问测试

五、问题根因总结

问题	原因
文件夹找不到	文件夹建在了 public 外面，而运行目录是 public
PHP 文件不执行	Nginx 配置中缺少 location ~ \.php$ 块，未配置 PHP-FPM 转发
配置保存失败	误将 server 级别的指令写入了伪静态规则文件（rewrite 目录）

六、经验教训

1. Xunruicms 运行目录：专业版/安全版的运行目录是 public，独立文件需放在 public 内
2. 伪静态规则文件 vs 主配置文件：
   • 伪静态规则文件（rewrite 目录）：只放 location / { ... } 内的规则
   • 主配置文件（nginx 目录）：放 server 块、location ~ \.php$ 等全局配置
3. PHP 处理块必不可少：即使伪静态规则中放行了 PHP 文件，如果没有 location ~ \.php$ 块， Nginx 不知道如何将 PHP 请求转发给 PHP-FPM 解析

一、朱雀到底在检测什么

绝大多数人以为朱雀在查"这段话是否抄袭了 AI 的回答"——不是。朱雀检测的是文本的统计指纹。

检测维度	含义	AI 文本的特征
困惑度	文本有多可预测。给定前几个词后，下一个词有多大概率被猜到	倾向选高概率词，困惑度极低
爆发性	句子长度和结构的变化幅度	句子长度均匀，结构规整
语义连贯性	段落间过渡有多丝滑	过度丝滑，教科书级逻辑链
词汇分布	高频词、低频词的出现模式	部分 AI 模型有专属高频词指纹

一句话：并非抓"AI 写了什么"，而是抓"写得有多像 AI"。

这意味着：

• 换同义词没用。朱雀不看词，看概率分布。
• 增加"活人感"口癖没用——如果口癖的投放位置和频率是规律化的。
• 规则越多越像 AI 。 如果你给文本制定了严格的改写规则，文本的统计分布会反过来变得更可预测。

问： 建设一个网站，初步 PC+H5 即可，然后做成 skill 技能，技术上要极简，支持 .md 格式的直接上传，每次跟 AI 智能体沟通完，调用技能即可自动上传到服务器，方便汇总浏览，合适的时候再做成 app 以及小程序，可以在手机中随时记录自己的想法碎片，然后发网址给 workbuddy 聊天时，可以实时调用全站历史信息，来支撑我的个性化要求。你会使用什么程序栈？目前服务器用的宝塔面板，部署要极简。

答： 推荐程序栈： PHP 8.x + SQLite + 原生前端（极简三件套）——宝塔原生支持零环境安装、 SQLite 单文件数据库备份即复制、与现有创业者引擎同栈维护心智一致。产品定位"个人知识碎片沉淀站"：内容为 AI 对话记录与想法碎片，两个核心集成——WorkBuddy skill 一键上传对话、全文搜索 API 供 AI 聊天时实时检索全站。随后一轮确认四个关键决策：使用范围=公开+个人混合（公开部分当作品集，写入仅自己）；检索深度=先关键词（ FTS5 ）架构预留 RAG 升级位；技术栈=PHP+SQLite ；内容形态=md+图片附件。

问： （三文档确认后）继续。

答： 专家团按六阶段流程完成建设并交付。 Phase 1 调研： PM 定位"为 AI 工作流而生的个人内容底座"，差异化=AI 原生双通道+数据绝对自有+公开私密一体，竞品差评验证为真实市场空白；架构师攻克最关键技术难题 SQLite FTS5 中文全文搜索——trigram 分词主选（ SQLite 3.34+ 内置零部署摩擦）， 1-2 字符查询走 LIKE 降级路由（ trigram 对 3 字符以下查询静默返空是已知坑）；设计师定调 Linear 式冷峻骨架+钢青墨 #0E7490 主色（刻意避开 indigo 模板味）+Lucide 图标库+浅色单主题全 Token 化。 Phase 1.5 冻结 Spec （ 13 章节、 21 条 EARS 验收标准、 10 条内嵌坑）。 Phase 2-3 产出 openapi.yaml （ 9 端点契约）+schema.sql （ 6 表）+前后端实现（ PHP 零框架分层+SSR 服务端渲染）。 Phase 4 ：独立 QA 测试 181/181 全绿（抓出并修复 pangu 中英文混排全站静默失效、 PHP ini 与上传契约错位两项 P1 ），千条压测搜索 20ms （ 15 倍预算余量），安全攻击面（ XSS/SQLi/爆破/限流/越权）全部实测防住；运维产出部署四件套（ 0.31MB zip+nginx 配置+每日备份脚本+宝塔手册），解压冒烟 53/53 实证通过。同步交付 note-archiver skill ，实现"归档对话+检索全站"双能力闭环。

问： 归档这次对话。

答： 执行 note-archiver 首次真实归档。站点 my.shizhan.vip 探针全绿： PHP 8.2.28 （锚定版本）+ SQLite 3.46.1 + FTS5 trigram 全功能模式（无降级）+ data 可写。本篇即站点建成后的第一条 ai_conversation 归档。