# GitHub SaaS 生态遍历 × ZIPFORCE Hub 自审报告（2026-09-24）

> 方法：GitHub API 6 组关键词（boilerplate / best practices / multi-tenant / security / checklist / RLS）
> + 深读 forter/security-101（4.7k★）5 阶段清单 + nextify/best-practice + sqreen/CTO checklist 框架
> + 对照 ZIPFORCE Hub **14 项自审**（RLS/2FA/限速/CORS/备份/容器/secrets/错误泄露/审计/暴力破解…）

---

## 一、GitHub SaaS 生态格局

| 仓库 | Star | 价值 |
|---|---|---|
| **forter/security-101-for-saas-startups** | 4.7k | **安全清单权威**：5 阶段（早期→首客→增长→规模→成熟），本文审计主基准 |
| wasp-lang/open-saas | 16k | JS SaaS 样板（Stripe 订阅+Admin+Auth） |
| ixartz/SaaS-Boilerplate | 7.4k | Next.js 样板（Auth+Stripe+i18n+测试） |
| boxyhq/saas-starter-kit | 4.9k | Enterprise SaaS（SSO/SAML/SCIM） |
| nextify-limited/best-practice | 394 | 技术选型速查（Cloudflare/AWS/Stripe/Umami） |
| aws-samples/aws-saas-factory-postgresql-rls | 131 | **PG RLS 多租户隔离官方范式**（我们同款架构） |
| sqreen/CTOSecurityChecklist | 746 | CTO 安全清单（已 deprecated，并入 forter） |

---

## 二、14 项自审结果（✓通过 / ⚠需优化 / ✗需修复）

### 安全层（forter 清单对照）

| # | 审计项 | 我们状态 | forter 建议 | 判定 |
|---|---|---|---|---|
| 1 | **密码安全** | scrypt 哈希 + 登录失败限速（loginfail:ip 键） | 复杂密码+密码管理器 | ✓ |
| 2 | **2FA/MFA** | `users.mfa_secret` 列已建 | TOTP 2FA 全员开启 | ⚠ 列在但未实装——**需实现 TOTP 验证流程** |
| 3 | **登录暴力破解** | loginfail 限速取 XFF 最后段（防伪造） | — | ✓（曾有 XFF 绕过已修） |
| 4 | **RLS 租户隔离** | 核心表 ✓（users/sessions/audit_log/billing/credentials/report_defs） | 数据隔离 | ✓ |
| 5 | **RLS 覆盖缺口** | **7 张表无 RLS**：`mcp_keys`(key_hash 明文可读!)、`product_reviews`、`autocomplete_terms`、`fx_rates`、`marketplaces`、`platforms`、`term_field_map` | — | **✗ mcp_keys 最严重**——portal_app 可 SELECT 全表读 key_hash（虽然存的是 sha256 不可逆，但能枚举租户的 key 存在性）。`product_reviews` 跨租户可读评论。公共注册表（fx/marketplaces/platforms/term_field_map）本应公共只读 ✓ 可接受。**需修：mcp_keys + product_reviews + autocomplete_terms 加 RLS** |
| 6 | **HTTPS/安全头** | Caddy security_headers（X-Frame DENY + HSTS 等） | SSL everywhere | ✓ |
| 7 | **CORS** | 全站同源+自定义 Origin/Host CSRF 门 | — | ✓（比大多数 SaaS 更严） |
| 8 | **Rate Limiting API** | 无应用层限速（登录有，API 无） | WAF/DDoS | ⚠ **API 端点无限速**——恶意脚本可高频调用。建议：Caddy 层加 `rate_limit` 或 FastAPI middleware（如 /api/ai/ 系列 LLM 端点烧钱无门槛） |
| 9 | **容器加固** | 10 处 read_only/cap_drop/no-new-privileges | — | ✓（安全最佳实践好于 forter 清单要求） |
| 10 | **Secrets 管理** | 40 处 secrets/_FILE 引用，无硬编码 | 密钥管理 | ✓ |

### 基础设施层

| # | 审计项 | 我们状态 | forter 建议 | 判定 |
|---|---|---|---|---|
| 11 | **备份** | 每日 03:30 + 版本锚点 dump + mercury 异机备份 | 不同云账号/数据中心 | ⚠ 备份全在 **本机磁盘**（backups/ 目录），mercury 有远端但 SaaS 自身无异地。**建议：每日 dump 推 mercury 或对象存储** |
| 12 | **审计日志覆盖** | 30+ action 类型（auth/ai/listing/inv/billing/ads/mcp） | — | ✓ 覆盖面好 |

### 代码层

| # | 审计项 | 我们状态 | forter 建议 | 判定 |
|---|---|---|---|---|
| 13 | **错误信息泄露** | sourcing.py 两处 `raise HTTPException(e.status, str(e))` | OWASP top 10 | ⚠ 上游异常文本直接透传客户端——可能泄露内部路径/SQL 片段。**建议改为通用消息+日志详情** |
| 14 | **MCP 面暴露** | /mcp 公网可达（两站点块放行），无 IP 白名单 | API 管理 | ⚠ MCP 端点接受 Bearer mk_* 密钥，暴力枚举空间 24 字节 hex ≈ 不可行 ✓，但 **无限速**——建议加每 key 60 req/min |

---

## 三、优化建议汇总（按优先级）

### 🔴 立即修复（安全实质）

1. **mcp_keys 加 RLS**（portal_app 不应能全表枚举 key_hash）——`ALTER TABLE mcp_keys ENABLE RLS; CREATE POLICY ... USING (tenant_id = app_tenant_id())`
2. **product_reviews / autocomplete_terms 加 RLS**（品牌隔离铁律）
3. **sourcing.py 错误透传修复**（str(e) → 通用 502 + stderr 详情）

### 🟡 近期优化（1-2 天）

4. **API 限速**：FastAPI middleware（Redis INCR EX）——/api/ai/* 每用户 20 req/min，/api/* 全局 120 req/min
5. **MCP 端点限速**：每 key 60 req/min
6. **备份异地化**：每日 dump scp 到 mercury /opt/backups/saas/（已有 ssh 通道，一行 crontab）
7. **TOTP 2FA 实装**：users.mfa_secret 列已在——加 Google Authenticator 绑定/验证流程（fastapi-totp 或 pyotp，~200 行）

### 🟢 中期（增强）

8. **注册表域公共表 RLS 标注**：fx_rates/marketplaces/platforms/term_field_map 保持公共只读但加注释（"deliberately public, read-only"）
9. **source code 漏洞扫描**：forter 建议 pip-audit / npm audit 加入 deploy_gate
10. **incident response 预案文档**：写一份（用什么命令止血/通知谁/恢复顺序）——已有回滚锚点但无正式 IR 文档

---

## 四、对标结论

| 维度 | forter 清单要求 | 我们现状 | 领先/落后 |
|---|---|---|---|
| 数据隔离 | RLS 或 schema 隔离 | PG RLS + 四维铁律 | **领先**（多数 SaaS 无 RLS） |
| 密码 | 复杂+管理器 | scrypt + 限速 | ✓ 达标 |
| 2FA | TOTP | 列在未实装 | **落后**——需实装 |
| HTTPS/安全头 | everywhere | Caddy 显式块 | ✓ |
| CORS | 白名单 | 同源+CSRF 门 | **领先** |
| 限速 | WAF | 仅登录有限速 | **落后**——API 无限速 |
| 备份 | 跨云异地 | 本机+mercury 异机（源库） | **落后**——SaaS 库无异地 |
| 容器 | — | read_only+cap_drop 全套 | **领先** |
| Secrets | 密钥管理 | Docker secrets 全覆盖 | ✓ |
| 审计日志 | — | 30+ action 类型 | **领先** |

> **总结：3 项领先、5 项达标、3 项落后（2FA/限速/备份异地）+ 3 处需修（RLS 缺口/错误泄露）。全部修复项已在优化清单排序。**
