bbs1 v11.0 代码分析
我解压了
bbs1org_v11_0.zip并阅读了核心代码。这是静态审查,没有实际运行,结论基于代码本身。压缩包只包含核心程序和插件开发规范,不含app/plugins/下的插件本体,也不含app-client/、docker/目录。整体架构
规模**:核心index.php约 3400 行、286 个函数;Plugin.php约 2100 行,负责插件市场、上传、同步、资源合并和计划任务;Setup.php约 1600 行,负责安装、升级和数据库迁移。- 技术栈:纯原生 PHP 8.1+,PDO 支持 SQLite、MySQL、PostgreSQL,无框架、无 Composer 依赖。
- 路由:通过
?a=动作名分发,路由表在index.php约 3330 行处;同时支持/动作/ID形式的路径重写。 - 认证:密码用
password_hash;登录 Cookie 格式为uid.过期时间.HMAC,签名密钥是用户的密码哈希,因此改密码会让旧 Cookie 失效。CSRF 采用 Cookie 与表单令牌双重校验。 - 插件机制:插件是一个返回 manifest 数组的 PHP 文件,通过 Hook 改写核心行为,并可声明路由、后台页面、CSS/JS 资源和计划任务。
PLUGIN.md长达 72KB,是给 AI 看的完整开发规范。
做得比较好的地方
- SQL 全部参数化,表名和字段名经过
app_db_identifier()处理,搜索使用参数化 LIKE。 - 输出转义:
h()基于htmlspecialchars,默认的 Markdown 渲染器只做转义加换行,没有 HTML 直通,XSS 风险较低。 - Cookie 属性:
httponly、samesite=Lax,HTTPS 下设置secure。 - 插件上传校验:检查 PHP 语法、
APP_ROOT守卫和 manifest 的 ID 格式,上传后做 sha256 校验。 - 计划任务有租约机制(
lease_token),防止并发重复执行。 - 性能约束清晰:
PLUGIN.md明确禁止循环内逐条查库(N+1),并给出“先收集、再批查、后映射”的标准做法。
需要关注的安全问题
高风险
- 登录限流可被绕过。
ip_addr()按顺序优先读取HTTP_CLIENT_IP、HTTP_X_FORWARDED_FOR等客户端可伪造的请求头,最后才读取REMOTE_ADDR。登录失败计数和注册限流都依赖这个 IP。另外,核心默认的security.rate_allow直接返回true,限流需要插件来实现。再加上密码最小长度只有 4 位(PASSWORD_MIN_LENGTH = 4),暴力破解的成本很低。建议只信任REMOTE_ADDR,仅在配置了可信反向代理时才解析转发头。
- 插件即任意代码执行。插件是直接
include的 PHP 文件,拥有与核心相同的权限,因此上传或从市场安装插件等同于在服务器上执行任意代码。目前的防护主要是后台权限(need_admin()),所以管理员账号一旦泄露,服务器也就随之失陷。
- 市场校验的完整性形同虚设。第 516 行的逻辑是:如果市场条目没有
sha256字段,就用下载到的代码自己计算哈希。这样校验就永远通过。而且哈希和代码来自同一个源,没有签名,只能防传输损坏,防不了市场源被攻击。另外,开启ignore_ssl_errors设置后,远程请求会关闭 TLS 校验,存在中间人篡改插件的风险。建议改用非对称签名(如 Ed25519),并强制要求哈希字段存在。
中风险
- 登录 Cookie 无服务端会话。Cookie 有效期长达 180 天,退出登录只清除浏览器里的 Cookie,无法让已泄露的 Cookie 失效,只有改密码才能让它作废。核心代码中也没有找到找回密码的流程。
- 计划任务入口无鉴权。
GET ?a=cron不校验任何令牌,任何人都可以触发任务。租约机制能防并发,但外部可以随意控制任务的触发时机。建议增加一个随机令牌参数。 - 首次安装窗口。在生成
install.lock之前,?a=install对任何访问者开放,部署后若未及时完成安装,可能被他人抢先设置管理员。
代码质量与可维护性
- 优点:命名约定统一,
topic_、app_、plugin_等前缀让函数归属一目了然,文档也比较完整。 - 问题:
- 大量全局函数,
index.php承担了太多职责,耦合较紧。 Plugin.php把市场、上传、同步、资源合并等多个功能放在一个类里,后续维护会越来越难。- 代码中大量使用
@抑制错误(如@unlink、@file_put_contents),加上error_reporting屏蔽了 notice 和 warning,出问题时不容易察觉。 - 部分代码行非常长,阅读和审查成本较高。
🔒 图片需 登录 后查看
主楼