关于 FengCMS :一个 2013 年开源的 PHP + MySQL 内容管理系统,曾被上万家网站使用,至今仍有网站在线运行;2026 年 10 月完成安全现代化升级,本文回顾的版本为 v1.37。开源仓库:github.com/fengcms/fengcms
各位看官,审计报告里有一条发现,标题读起来像个笑话:
缺少私有配置时回退为已知值。
配置加载器(config.php)在找不到站点配置时,不报错、不退出,而是优雅地兜底 到一组写死的值------数据库 root/123456、后台认证码 8888、应用密钥 admin123。
这三个值,第一个是数据库最高权限,第二个是后台的第二把钥匙,第三个撑着会话与加密的根基。而它们被安排成"漏配时的备胎"。这篇讲讲危险默认值为什么可怕、为什么不能直接删,以及我们怎么把它拆掉又不摔坏存量站。

本文要点
- 危险默认值的真正罪名不是"值弱",是"静默"
- 为什么直接删默认值反而会破坏旧站点
- 预检查工具怎么设计才不自己泄密
- 双配置文件并存时:拒绝启动,而不是择一使用
一、罪名不是"值弱",是"静默"
先说清楚这三颗雷各管什么:
root/123456:数据库账号。root加弱口令,等于把整个数据库实例的最高权限做成了常量------攻击者连猜都不用猜,123456是全世界扫描器的第一条字典;- 认证码
8888:FengCMS 后台登录的第二重凭据------密码之外还要过这一关,设计初衷是好的。坏在默认值的传播方式:所有安装教程都写着"装完改成复杂认证码",但教程教得再勤快,也拦不住有人照着默认值一路下一步。默认值的宿命就是:教人改它的人越多,说明留在原地的人越普遍; - 应用密钥
admin123:参与会话与加密相关运算的根密钥。密钥的强度是整个信任链的地基,地基是公开常量,上面锁得再仔细也白搭。
但请注意,这三条的罪名重心不在"值弱"------弱值是症状,病根是"回退"这个动作本身:配置缺失本该是启动失败级的事故,却被设计成"悄悄用默认值继续跑"。原形态大致长这样:
php
// 危险回退的原形态(示意,已列入废除路径)
$DB_USER = $cfg['DB_USER'] ?? 'root'; // 没配置?那就 root
$DB_PASS = $cfg['DB_PASS'] ?? '123456'; // 没密码?那就 123456 ------ 不吭声,照常跑
$ADMIN_ID = $cfg['ADMIN_ID'] ?? '8888'; // 认证码同理
$APP_KEY = $cfg['APP_KEY'] ?? 'admin123'; // 地基同理
看清楚了:每一行 ?? 都是一次替你做主。危险有三重:
- 静默:没人收到告警,日志干干净净,站长以为一切正常;
- 两头都知道 :这组值在源码仓库里明晃晃躺着,攻击者的字典里也有------防守方不知道,进攻方知道,这是最坏的不对称;
- 漏配恰恰发生在最脆弱的时刻:旧站升级、手工部署、迁移服务器------手忙脚乱的正是这几步,而回退机制专挑这时候"帮"你。
一个会替你掩盖错误的配置系统,比一个会咆哮的危险得多。
二、为什么不能直接删:老站还在跑

按常理,把回退删掉、缺配置就抛异常,一天就能干完。审计建议(A4)却写了一段非常克制的推演:
新安装器写入私有配置,但旧站点升级或手工部署若漏配,可能静默使用旧值 ......为现有站点提供兼容迁移步骤与配置预检查,再移除危险默认值,避免直接破坏旧站点。
顺序是关键:先有迁移步骤和预检查,再删默认值 。直接删的后果是------某台十三年没动过的共享主机,升级完直接白屏,数据库连不上,因为它的配置一直靠回退活着。你眼里是"拆掉一颗雷",站长眼里是"升级把我网站搞挂了"。
这和《安全加固的克制》里"删除门槛高于新增"是同一条原则的第二次登场:回退机制本身要废,但废它的动作必须排在"确保没人还依赖它"之后。 危险的东西不能留着,但让它失效的时机,得选在所有依赖者都拿到新拐杖之后。
给旧站的过渡路径也因此清晰:先把这台站的配置显式化 ------按迁移步骤把数据库地址、密钥、认证码写进私有配置或环境变量,跑一遍预检确认在位,最后才谈摘除回退。顺序反了,升级就从"给老屋换电线"变成"直接拉闸"。
显式配置之后,还要确认实际读取的是哪一份
可以用一个迁移场景理解这个顺序:站长已经把新密码写进私有文件,但容器里仍保留旧的环境变量。按本文的优先级,运行时读到的仍可能是环境变量。此时继续修改文件,或者把旧文件复制回来,都没有解决配置来源的问题。排查应该先确认变量来自哪里、由谁注入,再确认当前进程是否已经加载了预期配置。
记录来源不等于记录秘密。交接表可以写"数据库密码由容器环境提供,私有文件未设置",不必贴出密码本身;预检失败也应指出缺失项或连接阶段,而不是完整输出连接串。命令行进程与 Web 进程的环境还可能不同,因此命令行检查通过以后,仍要核对真实运行入口的配置来源,不能把一个进程的结果直接当成所有入口的证明。
三、三步拆法:预检 → 收紧 → 拒绝启动

第一步:预检查工具先上场。 php tools/config-preflight.php------它的行为被文档定义得非常窄:只检查配置完整性、数据库连接和数据库账号权限,不输出凭证 。配置文档把它直接列进了部署与升级的检查清单------升级流程的靠前几步就有它 :动代码之前,先确认配置齐不齐、库连不连得上、账号权限够不够。这一步的哲学很朴素:升级的第一件事不是改什么,是先看清自己现在站在什么上面。
bash
# 部署时先跑这个(示意)
php tools/config-preflight.php
# 检查项:配置文件完整性 · 数据库可连接 · 账号权限足够
# 输出:通过/失败 + 缺了哪一项
# 永远不会打印:密码、密钥、认证码
注意"不输出凭证 "这个自我约束。检查工具手里握着明文配置,一旦它把值打到日志里(调试的诱惑太大了),预检工具自己就成了泄露点------看门狗不能一边查岗一边把钥匙串晃给别人看。工具的输出设计,本身就是安全设计。
第二步:配置读取顺序写死,拒绝混用。 现行规则(配置文档原文):每个部署变量优先取进程环境变量,没有再读私有配置文件 ;而当新的私有 config.php 和旧的 config.local.php 同时存在时,启动与预检直接失败 ,要求备份并移除旧文件------理由写得明白:"避免两套值混用"。
php
// 配置加载的优先级与拒绝逻辑(示意)
// 1. 环境变量(容器/CI 场景)
$val = getenv('DB_HOST') ?: null;
// 2. 私有配置文件
if ($val === null && isset($private['DB_HOST'])) $val = $private['DB_HOST'];
// 两套配置并存?不猜、不合并、不择一------直接失败
if (file_exists('config.php') && file_exists('config.local.php')) {
exit('检测到新旧两套私有配置,请备份并移除旧文件后重启');
}
"两套配置并存就拒绝启动"这个决定值得单独品:一个想省事的实现会挑其中一套用、或者合并------猜配置的系统等于给排障加随机数 。而失败信息指名道姓说清怎么修,是"好的失败"的样板:报错不可怕,不说话才可怕。
第三步:目标状态是"缺密钥就停"。 审计建议的方向:新部署缺少密钥时停止启动 ,把危险默认值从回退链上摘掉。到达路径就是上面的顺序------迁移步骤铺好、预检成为部署标配,然后回退失去存在理由。让"漏配"成为跑不起来级的错误,而不是静默降级的开始。
回头看这三步,动的全是"失败的方式":预检把静默失败变成响亮失败,配置并存把猜测失败变成拒绝失败,最终连回退本身也退场。加固配置系统,本质是给系统换一种失败哲学。
四、私有配置不进 Git:最后一道物理隔离
代码层之外还有一道物理边界,审计确认过:开发环境的私有配置、运行数据和上传文件不进入 Git ;发布包同样不含数据与配置。这道防线看着朴素,却直接回应了危险默认值的根源问题------真正的站点配置一旦进了仓库,全世界都是"已知值"。
配套的分层也值得记下来:进程环境变量优先,服务器私有配置文件兜底,源码仓库只放代码和文档 。容器和 CI 场景用环境变量,共享主机场景用不进 Git 的私有文件------两条路都通向同一个结果:仓库里翻一万遍,也翻不出任何一台真实站点的密码。真正会泄露的从来不是默认值本身,而是被误提交的真配置------默认值危险一次,误提交能危险一万次。
这条红线后面讲发布工程时还会再出现(发布包的文件清单怎么裁、内部文档怎么排除),到时我们再对一遍账。
默认值治理的验收,包含"故意配错"的情况
这类改动适合在隔离副本中准备几组配置:只有新文件、只有兼容期允许的旧来源、新旧文件同时存在、必需项缺失、环境变量覆盖文件值。每组都先写下预期结果,再观察启动与预检是否一致。尤其是双文件冲突,不能预检报错而 Web 入口继续运行,否则部署者得到的是两套互相矛盾的结论。
还要分清两件事:把旧值显式写入配置,只完成了来源迁移;替换公开弱值,才完成了凭据治理。后者涉及数据库授权、已有会话及相关加密数据的影响,需要沿实际用途安排切换,不能简单地随机生成一个值就宣布结束。本文描述的是治理路径,具体站点是否已经完成,仍应由该站的配置与切换记录确认。
小结
危险默认值这篇,核心三句:真正的罪名是静默 ------弱值人人会改,回退机制让人根本不知道自己在裸奔;拆它要有顺序 ------迁移步骤和预检先就位、确认没人依赖再删,直接拔雷会砸到十三年没动过的老站;配套工具要自律------预检不吐凭证、双配置直接拒绝、缺密钥终将拒绝启动。配置系统的最高美德不是"总能跑起来",而是**"该跑不起来的时候,大声地跑不起来"**。
各位看官,去翻翻你们的 config.php,有没有一位"备胎先生"在值夜班?评论区报个平安。
感觉有收获的点个赞收藏一下,谢谢!
相关阅读:
本系列上一篇:PHP12《会话与CSRF加固》;下一篇:PHP14《Web入口收敛与访问白名单》。
FengCMS 开源地址: https://github.com/fengcms/fengcms ------ 如果这个系列的文章对你有帮助,欢迎到仓库点个 Star;有想法也可以直接提 Issue 交流。
本文由 FungLeo 主导,Deepseek 优化校阅,转发请注明首发地址,谢谢大家!