Work Report · 2026.10

Joe 主题定制与站点安全加固
工作总结报告

周期:2026-10-12 至 2026-10-31 | 对象:qfsyj.com(Typecho 1.3.0 + Joe 7.7.1)

活跃工作日 12 天 需求指令 123 条 主题交付 Joe.zip(287 文件 / 3.35 MB) 备份版本 bak12 → bak42 共 31 个
12活跃工作日
123需求指令
16项修复安全漏洞 / 风险
9类主题模块重构

01工作总览

本期两项并行工程:对外改善站点视觉与交互,对内修补 Typecho 核心与线上配置的安全短板。

整个周期的工作可以拆成两条互相独立、但共用同一套代码基座的主线。主题线目标是让 Joe 主题从「默认换皮」走向「完全自有形态」——去掉不用的功能、重做评论区、统一配色与排版。安全线起因于对站点做代码审计,发现 Typecho 核心存在鉴权绕过与 SSRF 链,随后扩展为对线上配置、插件、服务器的一次系统性加固。

主线核心目标主要产出改动量
主题定制 功能裁剪、评论区重构、配色统一、UA 识别与图标系统 Joe.zip 完整主题包 约 70 条指令
安全加固 核心漏洞修补、线上配置收敛、服务器与面板加固 typecho_patched.zip + 4 个热补丁 + 配置清单 约 40 条指令
站点运维 SEO 收录清理、日志与备份文件脱敏、插件治理 清理脚本、robots/nginx 规则 约 13 条指令

工作量分布

日期指令数当天主题
10-126主题结构摸底、评论数跳转、那年今日上线、按年归档页
10-136那年今日多篇自适应、最新回复定位、删除点赞体系
10-177草地绿配色、评论滑动验证上线
10-1814删转发、图片宽 800 自适应、评论层层嵌套与头像分侧
10-1916标签云改 2D、边栏精简、代码清理提速、安全查杀
10-202缩略图随机问题跟进
10-254全文检索与关键词高亮
10-2610段首缩进体系、评论改微信气泡
10-2720缩进补全、相关推荐随机、数字分页、标签云 8 轮改色、Logo 换色
10-2811Typecho 核心审计(CVE-2026-7025、SSRF、CSRF)
10-2913那年今日全站显示、内联滑动日期、线上 11 项加固
10-3114评论区 11 轮重构、UA 图标系统、表情面板修复

空白日:10-14~16、10-21~24,共 7 天无需求记录。

02主题定制:做过的修改

九个模块的最终形态,以及每个模块走过的弯路。

2.1 功能裁剪

模块处置
点赞体系删除全部点赞代码与样式,含 HTML、CSS、JS 及后台统计入口
转发功能移除转发按钮、图标与相关脚本
边栏挂件下线舔狗日记、天气、倒计时、直播四个模块
开发源文件删除 8 个开发期源文件与死 JS/CSS,文件数 294 → 286
「查看更多」首页改为固定数字分页,手机端 12 页自动折两行居中

2.2 评论区重构(迭代 11 轮,本期最重工作量)

评论区的形态经历了完整的一轮「发散—收敛」:微信气泡 → 卡片框 → 左右两列 → 回退单列 → 加投影 → 两列瀑布流 → 画布白卡 → 全透明无底 → UA 图标 → 真品牌 logo → 表情面板 → 层叠修复。最终方案要点:

  • 每层评论一张独立卡片,透明底 + 1px 描边(亮色 .14 / 夜间 .17)+ 双层柔和投影,圆角 16px
  • 两列瀑布流:column-width:320px + column-fill:balance + break-inside:avoid,卡片高度不齐也不会留空洞
  • 嵌套只保留缩进:子级 14px、再深 12px,去掉了引导竖线;窄屏压到 12px(需 html 前缀才生效)
  • 头像分侧:管理员头像、昵称、作者徽章整体靠右,访客靠左
  • 正文引用块:左侧 3px 主题绿细条 + 浅灰底 + 圆角 + 深色字,夜间单独压回边框色
  • 表情面板:定位基准由 70px 的按钮改为整条底栏,格子宽度 1/16(手机 1/7),不再挤成 4px
方向性推翻 3 次

「左右两列」被否,回到上下排列;「画布铺底 + 白卡」被否,全部改透明;卡片悬停上移效果因引发层叠 bug 被移除。三次推翻都源于第一版「视觉更强烈」的判断与站点整体克制的调性不符——后续改为先确认基调再落细节。

2.3 UA 识别与图标系统

把原先只输出「Windows / Chrome」两个字符串的逻辑重写为 _getAgentPlatform(),一次解析出系统、手机品牌、浏览器三份信息,用 static $cache 按 UA 的 md5 缓存,避免重复正则。图标改用 Simple Icons 的真实品牌 path,以 CSS mask-image 裁形状 + background-color 上色,做到「形状一次、颜色交给主题变量」。

类别数量覆盖
操作系统7Windows / macOS / iOS / Android / HarmonyOS / Linux / Ubuntu
手机品牌17Apple / 三星 / 华为 / 荣耀 / 小米 / OPPO / vivo / 一加 / 魅族 / 摩托罗拉 / 谷歌 / 索尼 / 诺基亚 / 联想 / HTC / LG / 华硕
浏览器12Chrome / Edge / Firefox / Safari / Opera / IE / QQ / 微信 / 百度 / Vivaldi / UC / 360
兜底2通用浏览器、通用手机轮廓

品牌判定顺序经过专门设计:荣耀 → 华为 → Redmi/POCO → 小米 → OPPO → vivo → 一加,避免小米的 MI 规则误吞荣耀与 Redmi;Build/HONOR、Build/HUAWEI 前缀优先于正则,HarmonyOS 必须排在 Android/Linux 之前。

2.4 排版与配色

模块最终方案
正文段首缩进注入两个全角空格,保护 pre/code/figure/table,<br> 分行与 blockquote、li 也补
摘要与搜索片段_joeIndentText 兜底,接入 abstract、搜索片段与 4 处 archive
搜索高亮仅标题命中的文章也标 <mark>;只改文本节点,不动 title="" 属性
相关推荐同标签 PHP 端 shuffle 随机取 4 篇,不依赖 MySQL RAND()
标签云8 轮改色,最终主题绿同色系 8 档底(#319b53~#2bc54c)+ 深绿字 #0b3d1c
那年今日全站显示(aside + 9 个模板)、「X年前」徽章、右侧 hdate 滑动展开、去掉原生 title 气泡
Logo蓝改草地绿,通过 alpha 通道重着色保留原图形细节
图片统一 800px 宽自适应(含 aligncenter),小于 800 不放大
评论链接发布 30 天后仅管理员可见

03安全加固:修复的漏洞

从核心代码审计延伸到线上配置与服务器,共处置 16 项漏洞与风险。

3.1 Typecho 核心漏洞(10-28)

漏洞成因修法
严重
CVE-2026-7025
鉴权绕过
sha1(...) == $token 使用松散比较,提交 {"token":true} 即可通过 is_string + 长度 40 校验 + hash_equals
严重
RCE 跳板
与上一条同链:do=async → Service::asyncHandle,可调用任意插件的任意 public 方法 强制请求结构校验(必须为 [string, array] 二元组)
严重
SSRF ×3
pingback 两跳 + trackback;后两处连协议都不校验,可直接打 file:// 新增 isSafeOutboundUrl,三处出站统一走它
中危
内网探测盲点
filter_var 放行 100.64.0.0/10(云 VPC / K8s 真实可达) 补 15 个 IPv4 保留段 + 6 个 IPv6 前缀 + 映射地址还原
中危
任意协议出站
curl 封装未限制协议 CURLOPT_PROTOCOLS 限 HTTP/HTTPS
中危
CSRF 弱比较
Security::protect 用 != 比较令牌 改 hash_equals,覆盖全部后台表单

实证方式:内网搭靶机 python -m http.server,原版打出请求、修复版零请求;token:true 原版返回 200、修复版返回 403。

3.2 站点与线上配置(10-28 ~ 10-30)

风险项实际情况处置
邮箱批量泄露155 个真实邮箱可公开下载(Comment2Mail/log.txt 951KB、LoveKK debug.txt 521KB、ZhiNian log.txt 52KB),其中一个还泄露服务器路径全部移出 Web 目录
主题/插件源码包Joe.zip 3.4MB、LoveKKCommentModify-main.zip 可下载移入 /www/backup/site-zips/
上传目录可执行实测探针返回 WBTEST_EXEC_64,/usr/uploads/ 下 PHP 可执行nginx 内层 deny php;全局禁 zip/tar/sql/bak/log
XML-RPC 爆破allowXmlRpc 只控制 discover 标签,/action/xmlrpc 永远可达nginx 硬拦,location 必须插在 enable-php 之前
模板任意包含contents.template 无白名单 + Archive.php 直接 require_once3 处双层校验,6 种载荷全部 BLOCK
登录无限流可无限暴力尝试typecho_login_guard 表,5 次失败锁 15 分钟;实测第 6 次 0.02s 拒绝
滑块令牌可复用令牌为纯时间戳,可重放改 ts.rand.IP指纹.HMAC + 一次性消费表
邮件正文未转义10 处插值点直接输出用户内容htmlspecialchars 后再渲染表情
PHP 运行时open_basedir 空、display_errors=On、session 未设 HttpOnly三项全补;.user.ini 有 chattr +i,先解锁再上锁
资源耗尽pageSize 无上限,50000 可拉出 1.24MB 响应;浏览量可无限刷限 1–50(顺带修 pageSize=0 除零),浏览量按 IP + 文章 1 小时去重
插件 CSRF两个插件 Backups.php 无令牌校验补令牌,产出 qfsyj-plugin-csrf-patch.zip
响应头与 TLS缺 4 个安全头、config.inc.php 权限 755、TLS 1.1 + 3DES 未禁补头、改 640 + 拦 404、收敛协议

3.3 服务器与面板

  • SSH 关闭密码登录,启用密钥 + fail2ban;关闭闲置 FTP 服务
  • 系统更新 361 个 dnf 包,内核 5.14.0-635 → 759
  • 宝塔面板 10.0.2 → 13.1.0,面板风险项 16 → 7,剩余 7 条经逐条核验均为误报

04踩过的问题与根因

按技术栈归类,每条都附带可复用的结论。

4.1 CSS 层叠与优先级

现象根因结论
表情面板被后面的卡片盖住卡片 :hover{transform:translateY(-2px)} 创建了独立层叠上下文,把 .box 的 z-index:40 关进卡片内部;卡片自身 z-index:auto,后序兄弟卡片按 DOM 顺序画在上面悬停只改阴影和描边,绝不用 transform;卡片显式 z-index:1,带回复框的提到 3
窄屏样式「写了不生效」joe.responsive.min.css 用 html .joe_comment …(0,2,1)压过 global 的(0,2,0)窄屏覆盖必须加 html 前缀
引用块夜间边框变灰joe.mode.min.css 把 border 刷成 --classA夜间规则里显式压回 --theme
昵称被截成「访客…」max-width:50% 在 shrink-to-fit 容器里解析成约 24px百分比 max-width 在撑不开的容器里不可靠,改用 flex 换行
瀑布流两条粘连顶层补了 margin-bottom,嵌套层漏了嵌套层补 + & + 的 margin-top

4.2 验证方法的坑

五个「测了等于没测」的陷阱
  1. 无头 Edge 最小视口约 500px,--window-size=390 无效,手机态须用 <iframe width=390> 包一层。
  2. 整页截图会被缩放,坐标对不上;量尺寸一律用 getBoundingClientRect / getComputedStyle。
  3. 无头截图不带 hover,hover 触发的 bug 必须在测试页里手写 transform 模拟。
  4. @keyframes showComment 起始 scale(.3) 会把表单量成 125px 宽,截图页须加 animation:none。
  5. 判断「某段代码有没有被引用」不能用 grep | head 截断结果。

4.3 nginx 与打包

  • 伪静态规则写法:location ^~ ^/feed/... 把正则当字面量路径,静默失效且 nginx -t 不报错。
  • 真正的坑是阶段顺序:server 段 rewrite/if 早于 location 匹配,宝塔伪静态先把 URI 改写成 /index.php/feed/...,location 永远不命中。拦截必须写成 server 级 if + return 404,插在 #REWRITE-START 之前。
  • robots 与 noindex 互斥:Disallow: /search/ 会让爬虫读不到 noindex,退化成「仅网址收录」。
  • 打包不能用旧 zip 条目:沿用旧包会把已删文件塞回去,必须以磁盘实际文件为准重建。

4.4 PHP 与逻辑

  • MI\s?\d 加 i 会匹配到 Mobile,所有 iPhone 变成「小米 iOS」——正则的大小写标志必须逐个确认。
  • 原版 Joe 的 Edge 判定 /Edge([\d]*)\// 匹配不到 Chromium 的 Edg/,所有新版 Edge 都被识别成 Chrome(已顺带修复)。
  • Edit 替换含多个 } 的代码块容易吞掉后续语句,改完必须 php -l + 目视复核。

4.5 自伤事件

两次由清理动作引发的故障

① 10-19 清理代码时删掉了后台外观设置仍在使用的函数,导致设置页 Server Error;② 另一次用 grep | head 判断引用关系时结果被截断,误删骨架屏 CSS/JS,只能从 Joe.zip.bak 逐块对照恢复。共同点是「先删后验」,正确顺序应为「先全量确认引用,再删,删完立即回归」。

05遗留事项与建议

按执行方分为两类:需你在服务器侧完成的操作,和技术上尚未闭环的取舍。

5.1 需要你执行

上传 Joe.zip 覆盖主题(287 文件 / 3,498,677 B),覆盖后强刷一次 CSS 缓存;确认 core/function.php 已含 _getAgentPlatform 待办
feed/search 拦截:server 级 if ($uri ~* "^/feed/(rss|/atom/)?search(/|$)") { return 404; },插在 #REWRITE-START 之前并 reload 待办
上传 include.php(7,553 B)与 qfsyj-plugin-csrf-patch.zip 待办
执行清理脚本 qfsyj-紧急清理.sh,并删除 install.php 待办
Search Console / 百度提交移除已泄露的日志与源码包 URL 待办

5.2 技术与设计上的取舍

项现状与影响可选改进
瀑布流阅读顺序CSS 多列的自然行为是「左列整列读完再读右列」,与视觉上的左右交替预期不符改 JS masonry,可同时解决下一条
超长卡片被劈开单张卡片高于整列时,Chrome 会强行断开跨列显示同上,JS masonry 可根治
手机端不显示 UA主题原生 .agent{display:none},品牌图标在手机上不显示可改为手机端只显图标不显文字
少见品牌无 logorealme / TECNO / Infinix 在 Simple Icons 无官方图标,退回通用手机轮廓自绘补充或维持现状
机型歧义ANY-AN00 等无 HONOR 字样的型号只能按华为判定维护机型对照表
CSS 体积139KB → 195KB(gzip 约 57KB),增量主要来自图标与卡片样式可拆为独立 icon.css 按需加载
升级覆盖Typecho 1.3.1 会覆盖 var/ 下补丁;Joe 升级会覆盖 core/slider.php、factory.php、route.php升级时这三个文件与 var/ 不要整包覆盖

06附录:改动文件清单

文件改动内容
assets/css/joe.global.min.css评论区卡片/瀑布流/图标基座与 38 个品牌类、引用块、表情面板、缩进与分页等主体样式(139KB → 195KB)
core/function.php_getAgentPlatform() 重写、品牌判定表、Edge 识别修复、那年今日渲染函数去 title
public/comment.phpUA 行结构改为「系统 · 浏览器」双图标输出
core/short.php缩进注入、摘要处理
public/aside.php / related.php / batten.php边栏精简、相关推荐随机、那年今日接入
index.php / archive.php评论数跳转、数字分页、那年今日 need 接入
core/slider.php / factory.php / route.php滑动验证 HMAC 令牌、登录限流、路由加固(升级勿覆盖)
var/Typecho/* 补丁CVE-2026-7025、SSRF、CSRF 三处核心修补(升级勿覆盖)

备份链:Joe.zip.bak12 至 Joe.zip.bak42,共 31 个历史版本,建议保留最近 5 个、其余归档。