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),并给出“先收集、再批查、后映射”的标准做法。

需要关注的安全问题

高风险

  1. 登录限流可被绕过。ip_addr() 按顺序优先读取 HTTP_CLIENT_IP、HTTP_X_FORWARDED_FOR 等客户端可伪造的请求头,最后才读取 REMOTE_ADDR。登录失败计数和注册限流都依赖这个 IP。另外,核心默认的 security.rate_allow 直接返回 true,限流需要插件来实现。再加上密码最小长度只有 4 位(PASSWORD_MIN_LENGTH = 4),暴力破解的成本很低。建议只信任 REMOTE_ADDR,仅在配置了可信反向代理时才解析转发头。
  1. 插件即任意代码执行。插件是直接 include 的 PHP 文件,拥有与核心相同的权限,因此上传或从市场安装插件等同于在服务器上执行任意代码。目前的防护主要是后台权限(need_admin()),所以管理员账号一旦泄露,服务器也就随之失陷。
  1. 市场校验的完整性形同虚设。第 516 行的逻辑是:如果市场条目没有 sha256 字段,就用下载到的代码自己计算哈希。这样校验就永远通过。而且哈希和代码来自同一个源,没有签名,只能防传输损坏,防不了市场源被攻击。另外,开启 ignore_ssl_errors 设置后,远程请求会关闭 TLS 校验,存在中间人篡改插件的风险。建议改用非对称签名(如 Ed25519),并强制要求哈希字段存在。

中风险

  1. 登录 Cookie 无服务端会话。Cookie 有效期长达 180 天,退出登录只清除浏览器里的 Cookie,无法让已泄露的 Cookie 失效,只有改密码才能让它作废。核心代码中也没有找到找回密码的流程。
  2. 计划任务入口无鉴权。GET ?a=cron 不校验任何令牌,任何人都可以触发任务。租约机制能防并发,但外部可以随意控制任务的触发时机。建议增加一个随机令牌参数。
  3. 首次安装窗口。在生成 install.lock 之前,?a=install 对任何访问者开放,部署后若未及时完成安装,可能被他人抢先设置管理员。

代码质量与可维护性

  • 优点:命名约定统一,topic_、app_、plugin_ 等前缀让函数归属一目了然,文档也比较完整。
  • 问题:
  • 大量全局函数,index.php 承担了太多职责,耦合较紧。
  • Plugin.php 把市场、上传、同步、资源合并等多个功能放在一个类里,后续维护会越来越难。
  • 代码中大量使用 @ 抑制错误(如 @unlink、@file_put_contents),加上 error_reporting 屏蔽了 notice 和 warning,出问题时不容易察觉。
  • 部分代码行非常长,阅读和审查成本较高。

🔒 图片需 后查看

主楼