prompts.chat 安全实践指南:漏洞报告流程与源码级安全机制深度解读

原创2026-10-10 22:44:521,769 阅读
文章标签:人工智能提示工程AI 应用MCP 服务AI 插件前端后端知识库

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 时叠加了三道防护:

  1. 创建频率限制:同一用户 30 秒内只允许创建 1 条,超限返回 429 rate_limit;
  2. flagged 用户每日上限:被标记用户(flagged: true)每日最多 5 条,超限返回 429 daily_limit;
  3. 重复内容检测:先查同用户标题/内容重复(409 duplicate_prompt),再对最近 1000 条公开 Prompt 做内容相似度比对(409 content_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、429 daily_limit(flagged 用户)等滥用防护分支;
  • 各 API 路由测试同样 mock 了 rate-limit 与 api-key 模块,确保认证/限流逻辑与业务逻辑解耦且可独立验证。

这说明报告流程之外,项目在"减少漏洞出现"这一环投入了系统性的工程手段。

四、给安全研究者与自托管维护者的操作清单

综合以上内容,汇总成可直接执行的清单:

作为安全研究者:

  1. 发现疑似漏洞后不要开公开 issue;
  2. 整理描述、复现步骤、潜在影响与建议修复,邮件发送至 security@prompts.chat;
  3. 等待维护团队确认并跟踪 GitHub Security Advisories / CVE 编号;
  4. 在修复完成前保持低调,遵循协调披露节奏。

作为自托管维护者:

  1. 始终运行最新版本镜像,及时跟进安全更新;
  2. 生产环境显式设置 AUTH_SECRET(openssl rand -base64 32),修改数据库默认密码;
  3. 多实例部署时,将内存限流器替换为 Redis 实现(源码注释已明确此前提);
  4. 谨慎配置 Webhook——目标地址指向内网会被 isPrivateUrl 直接拦截,这是有意设计而非故障;
  5. 善用管理员后台的用户标记、每日生成额度配置等滥用治理工具。

五、总结

SECURITY.md 构建了一条清晰、负责任的漏洞响应链路:单一报告渠道 → 结构化报告要素 → 与 GitHub 安全团队协调的 CVE 流程 → 协调披露与致谢,并明确划出受理边界。而深入源码可以看到,与之配套的是一整套可验证的工程防线:bcrypt 凭据哈希、强随机 API 密钥、防枚举的 404 访问控制、SSRF 目标校验、四级滑动窗口限流、flagged 用户自动下架,以及覆盖这些行为的自动化测试。理解这套"流程 + 代码"双轨安全体系,无论对提交漏洞的研究者还是自托管用户,都具有直接的实战价值。

登录后查看全文
prompts.chat