缓存

十个缓存域,各有自己的 TTL,可放内存或 Cloudflare KV,每个域都能单独清除。

每个涉及支付、邮件、存储或 AI 的请求都会从后台配置表读取服务商配置。这些读取按域缓存,TTL 在 /admin/config/cache 设置。改完配置又不想等 TTL 过期时,可以单独清除某一个域。

准备工作

  • config.read 才能看到页面,config.write 才能改 TTL 或清缓存。见角色与权限。
  • 默认使用内存。Cloudflare KV 仅在运行时有 CACHE 绑定时可用。Redis 会列出并显示不可用原因,它未接入缓存层。

设置

选后端

内存只在单个进程内缓存。Workers 上每个 isolate 各缓存一份,Node 上每个容器各一份。KV 可在实例间共享。不可用的后端会显示原因。若已配置的后端在运行时不可用,读取会回退到进程内存。

按域设置 TTL

每个域有自己的默认值。配置类的 TTL 短,修改服务商后很快生效。模板类的 TTL 长,很少变化的内容读库次数更少。

保存表单接受 1–86,400 秒。关闭 启用 可让该域绕过缓存,TTL 值会保留供再次启用时使用。

改完之后清一下

在 /admin/config/* 保存服务商设置后会自动清除对应的域,所以改动不用等 TTL 过期就生效。在后台之外直接改了数据行时,才需要手动清除。

各个域和默认 TTL

域缓存什么默认 TTL
admin_config后台配置表本身30 秒
auth_config认证服务商与选项30 秒
email_config邮件服务商设置30 秒
email_template渲染后的邮件模板60 秒
payment_config支付服务商设置30 秒
storage_config对象存储设置30 秒
analytics_config分析服务商设置30 秒
newsletter_config订阅服务商设置30 秒
ai_channel_snapshot通道列表30 秒
ai_channel_resolved场景到通道的解析结果15 秒

admin_config 是引导域。其余每个域的策略都通过它读取,所以它不能从自己缓存的那张表里读取自己的策略。它的 TTL 来自 ADMIN_CONFIG_CACHE_TTL_MS,这是本项目读取的少数几个环境变量之一。

策略

Prop

Type

要增加缓存域,在 cache-policy.ts 的 cacheDomains 中登记。后台会随之提供 TTL 设置和清除操作。

验证

  1. 打开 /admin/config/cache,页面列出十个域及其 TTL。
  2. 在 /admin/config/payment 改一项支付设置,然后进行一次结账。新设置立即生效,不用等 30 秒。
  3. 关闭 email_template 的 启用 并保存,模板读取不再使用缓存。
  4. 在没有 CACHE 绑定的运行时上,KV 选项会显示,并附不可用原因。

参考

下一步