prompts.chat 安全实践指南:漏洞报告流程与源码级安全机制深度解读
prompts.chat 安全实践指南:漏洞报告流程与源码级安全机制深度解读
导读
本文以 prompts.chat 仓库根目录的 SECURITY.md 为骨架,完整讲解该开源项目的安全策略:从支持版本、漏洞报告渠道、报告内容要求到 CVE 协调与披露政策,并结合仓库源码逐层解析其真实落地的安全机制——包括认证与密码哈希、API 密钥生成校验、私有内容访问控制、SSRF 防护、速率限制与滥用检测,以及自托管部署时的关键安全配置。读完本文,你将同时掌握"如何负责任地向该项目报告安全漏洞"和"该项目在代码层面如何防御常见威胁"两方面的完整知识。
一、支持的版本:安全修复只面向最新版
SECURITY.md 明确维护策略:项目只对 Latest(最新版本) 提供安全支持。这意味着:
- 只有处于最新版本的部署才能获得安全更新与漏洞修复;
- 建议自托管用户始终跟进最新发布版本,避免长期停留在旧版本上暴露已知风险。
该仓库的容器化交付(compose.yml 中 app 服务默认拉取 ghcr.io/f/prompts.chat:latest 镜像,也可通过 docker compose up -d --build 本地构建)与这一策略保持一致:拉取 latest 标签即可获得当前受支持的版本。
二、漏洞报告流程:如何负责任地报告安全问题
2.1 报告渠道与红线
项目对漏洞报告的第一条要求是:
不要就安全漏洞公开 GitHub issue。
公开 issue 会在修复前向攻击者暴露漏洞细节,扩大实际风险。正确的做法是将漏洞详情通过邮件发送至 security@prompts.chat,由维护团队在内部处理。
2.2 一份高质量报告应包含的内容
SECURITY.md 要求报告中至少包含四类信息:
| 要素 | 说明 |
|---|---|
| 漏洞描述(Description) | 说明漏洞的类型、成因与受影响的组件 |
| 复现步骤(Steps to reproduce) | 可被维护者验证的最小复现路径 |
| 潜在影响(Potential impact) | 攻击者利用后可能造成的数据泄露、权限提升、服务中断等后果 |
| 建议修复(Suggested fix,可选) | 如有可能,附上你对该漏洞的修复思路或补丁建议 |
包含复现步骤与影响评估的报告能显著加速漏洞的确认与修复闭环。
2.3 CVE 协调
项目与 GitHub 安全团队协作开展 CVE 识别与披露流程:已确认的漏洞会通过 GitHub Security Advisories 跟踪,并在适当情况下申请、分配 CVE ID。这意味着安全研究者无需自行申请 CVE,只需要通过上述邮件渠道报告,后续编号、披露节奏均由项目方统一协调。
2.4 披露政策
项目承诺:
- 在问题修复前,希望研究者给予合理时间后再公开披露(Coordinated Disclosure / 协调披露);
- 维护团队承诺与安全研究者合作;
- 问题解决后,除非研究者要求匿名,否则将对报告者予以致谢(Credit)。
2.5 不在范围内的内容
以下类型的攻击不属于该安全计划受理范围:
- 拒绝服务攻击(Denial of Service)——属于运营防护范畴而非代码漏洞;
- 社会工程攻击(Social Engineering)——针对人的欺骗而非系统缺陷;
- 第三方依赖中的问题(Third-party dependencies)——应直接上报给对应上游项目;
- 需要物理接触的攻击(Attacks requiring physical access)——超出远程威胁模型。
不过,"第三方依赖问题不属于受理范围"并不代表项目不关注依赖安全——从源码看,项目在依赖使用层面做了大量加固(详见下文 SSRF 防护与速率限制章节),只是漏洞编号与修复由上游负责。
三、源码级安全机制解读:prompts.chat 如何落地安全实践
安全策略文档解决的是"漏洞来了怎么处理",而真正降低漏洞发生概率的,是代码中的一道道防线。以下结合仓库源码逐层分析。
3.1 认证与凭据安全:bcrypt 哈希 + 多 Provider 插件化
项目采用 NextAuth 插件化认证架构,Provider 实现位于 src/lib/plugins/auth 目录(支持 credentials、github、google、apple、azure 等)。
邮箱/密码登录(src/lib/plugins/auth/credentials.ts)展示了关键实践:
- 登录表单通过
zod做校验:邮箱必须是合法邮箱,密码最少 6 位(z.string().min(6)); - 密码不以明文存储或比对,而是使用 bcryptjs 哈希——验证时调用
bcrypt.compare(password, user.password),即使数据库泄露,攻击者也无法直接还原明文密码; - 对未设置密码的用户(如纯 OAuth 注册)直接拒绝密码登录。
3.2 API 密钥安全:强随机 + 前缀 + 严格格式校验
面向开发者与 MCP 集成的 API 密钥,其生成与校验逻辑集中在 src/lib/api-key.ts:
- 密钥形如
pchat_前缀 + 32 字节randomBytes的 hex 编码(共 64 个十六进制字符),使用 Node 加密级随机源而非伪随机数; isValidApiKeyFormat校验两件事:必须以pchat_开头,且剩余部分严格匹配^[a-f0-9]{64}$——格式不合法的请求在查询数据库之前就被拒绝,避免无效请求冲击数据库。
在 src/pages/api/mcp.ts 中,API 密钥认证还叠加了一层进程内 5 分钟 TTL 缓存(AUTH_CACHE_TTL = 5 * 60 * 1000),同一密钥在缓存有效期内不再重复查询数据库,兼顾安全与性能。
数据库层面,users.apiKey 字段带有唯一约束(见迁移 20251216195800_add_api_key_and_mcp_settings/migration.sql 与 schema.prisma),从根上避免密钥冲突。
3.3 访问控制:私有 Prompt 一律返回 404 防止枚举
私有内容泄露是 UGC 平台最典型的风险之一。项目的访问控制实现 src/lib/prompt-access.ts 给出了一个教科书级的细节:
- 公共 Prompt 直接放行;私有 Prompt 仅允许作者本人或 ADMIN 角色查看(
canViewPrompt); - 关键在于:被拒绝时返回 404(not_found)而不是 403。源码注释明确说明:返回 403 会泄露"该 Prompt 存在"这一事实(
Returning 403 is also leak existence of the prompt itself!); - 且
checkPromptAccess采用惰性认证——只在 Prompt 为私有时才调用auth(),公共访问路径零认证开销。
这一模式被广泛复用在 src/app/api/prompts/[id] 下的所有子路由中(versions、vote、changes、examples 等),确保私有内容的每个操作入口都被同一道闸门保护。
3.4 SSRF 防护:Webhook 目标地址黑名单校验
项目为管理员提供 Webhook 集成(触发 Prompt 创建/更新/删除事件),这天然是 SSRF(服务端请求伪造,OWASP A10) 的高发点——攻击者可能诱导服务端去请求内网地址。防护逻辑在 src/lib/webhook.ts 的 isPrivateUrl 函数中:
- 屏蔽
localhost、127.0.0.1、::1及.local、.internal、.localhost等内网主机名后缀; - 对 IPv4 逐段拦截私网/特殊网段:
127.0.0.0/8(回环)、10.0.0.0/8、172.16.0.0/12、192.168.0.0/16、169.254.0.0/16(链路本地)、0.0.0.0/8、组播224.0.0.0/4及保留段; - 对 IPv6 拦截
::1、fe80:链路本地及fc/fd开头的唯一本地地址(ULA); - 无法解析的非法 URL 按"潜在危险"处理(fail-closed)。
该校验在配置写入(src/app/api/admin/webhooks/route.ts)与实际触发(src/lib/webhook.ts 中 triggerWebhooks 发送前二次校验)两层执行,测试端点 src/app/api/admin/webhooks/[id]/test/route.ts 同样复用,做到纵深防御。
3.5 速率限制与滥用防护:分层限流 + 信用额度
MCP 接口的四级限流
MCP 服务(src/pages/api/mcp.ts)是计算与写操作密集的入口,项目在 src/lib/rate-limit.ts 实现了滑动窗口内存限流器,并按操作成本分四级:
| 限流器 | 适用请求 | 限额 |
|---|---|---|
mcpGeneralLimiter |
所有 MCP POST 请求 | 20 次/分钟 |
mcpToolCallLimiter |
工具调用 tools/call |
10 次/分钟 |
mcpWriteToolLimiter |
写类变更工具 | 5 次/分钟 |
mcpAiToolLimiter |
AI 类工具(如 improve_prompt) | 2 次/分钟 |
实现细节值得注意:每个限流器按标识符(优先 API 密钥,其次 x-forwarded-for 首段,再退回 socket 地址)独立跟踪时间戳;超限时返回 429 并给出 retryAfterSeconds 精确重试时间;每 60 秒清理过期条目防止内存泄漏。源码注释也诚实标注了限制:这是进程内实现,多实例部署时建议替换为 Redis 版本。
内容提交的防刷与防滥用
src/app/api/prompts/route.ts 在创建 Prompt 时叠加了三道防护:
- 创建频率限制:同一用户 30 秒内只允许创建 1 条,超限返回 429
rate_limit; - flagged 用户每日上限:被标记用户(
flagged: true)每日最多 5 条,超限返回 429daily_limit; - 重复内容检测:先查同用户标题/内容重复(409
duplicate_prompt),再对最近 1000 条公开 Prompt 做内容相似度比对(409content_exists),抑制刷量。
更关键的是自动下架机制:flagged 用户提交的 Prompt 会被自动设置为 isUnlisted: true 并写入 delistReason: "UNUSUAL_ACTIVITY"(字段定义见迁移 20251222132600_add_user_flagged_and_unusual_activity/migration.sql 与 schema.prisma)。
AI 生成信用额度
对生成类能力,schema.prisma 中 users 表维护 dailyGenerationLimit、generationCreditsRemaining、generationCreditsResetAt 三字段:初始默认 10(迁移 20251225000000_add_generation_credits/migration.sql),后调整为每日 3 次(迁移 20260106071035_daily_generation_limit/migration.sql)。管理员可在 src/app/api/admin/users/[id]/route.ts 中调整限额并同步重置剩余额度,配合每日重置的定时任务实现可控的成本防护。
3.6 自托管部署安全:密钥与环境变量
自托管场景(详见 SELF-HOSTING.md 与 DOCKER.md)的安全要点集中在两点:
AUTH_SECRET:用于签名认证令牌。开发默认值绝不可用于生产,DOCKER.md 明确要求生产环境显式设置,并给出生成方式openssl rand -base64 32;POSTGRES_PASSWORD:compose.yml 中数据库密码通过环境变量注入(默认值prompts仅供本地开发),并注释提醒"生产环境务必修改",同时app服务通过 healthcheck 等待数据库就绪后才启动。
3.7 测试与回归:安全行为被持续验证
安全机制并非一次性代码,仓库通过 vitest 测试套件持续锁住行为:
- src/tests/api/mcp-handler.test.ts 验证 MCP 入口的 HTTP 方法路由(GET 返回 405 且设置
Cache-Control: no-store防止 405 被缓存)、限流器分层调用与 API 密钥格式校验路径; - src/tests/api/prompts.test.ts 覆盖创建接口的 429
rate_limit、429daily_limit(flagged 用户)等滥用防护分支; - 各 API 路由测试同样 mock 了
rate-limit与api-key模块,确保认证/限流逻辑与业务逻辑解耦且可独立验证。
这说明报告流程之外,项目在"减少漏洞出现"这一环投入了系统性的工程手段。
四、给安全研究者与自托管维护者的操作清单
综合以上内容,汇总成可直接执行的清单:
作为安全研究者:
- 发现疑似漏洞后不要开公开 issue;
- 整理描述、复现步骤、潜在影响与建议修复,邮件发送至
security@prompts.chat; - 等待维护团队确认并跟踪 GitHub Security Advisories / CVE 编号;
- 在修复完成前保持低调,遵循协调披露节奏。
作为自托管维护者:
- 始终运行最新版本镜像,及时跟进安全更新;
- 生产环境显式设置
AUTH_SECRET(openssl rand -base64 32),修改数据库默认密码; - 多实例部署时,将内存限流器替换为 Redis 实现(源码注释已明确此前提);
- 谨慎配置 Webhook——目标地址指向内网会被
isPrivateUrl直接拦截,这是有意设计而非故障; - 善用管理员后台的用户标记、每日生成额度配置等滥用治理工具。
五、总结
SECURITY.md 构建了一条清晰、负责任的漏洞响应链路:单一报告渠道 → 结构化报告要素 → 与 GitHub 安全团队协调的 CVE 流程 → 协调披露与致谢,并明确划出受理边界。而深入源码可以看到,与之配套的是一整套可验证的工程防线:bcrypt 凭据哈希、强随机 API 密钥、防枚举的 404 访问控制、SSRF 目标校验、四级滑动窗口限流、flagged 用户自动下架,以及覆盖这些行为的自动化测试。理解这套"流程 + 代码"双轨安全体系,无论对提交漏洞的研究者还是自托管用户,都具有直接的实战价值。