缓存
十个缓存域,各有自己的 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 设置和清除操作。
验证
- 打开
/admin/config/cache,页面列出十个域及其 TTL。 - 在
/admin/config/payment改一项支付设置,然后进行一次结账。新设置立即生效,不用等 30 秒。 - 关闭
email_template的 启用 并保存,模板读取不再使用缓存。 - 在没有
CACHE绑定的运行时上,KV 选项会显示,并附不可用原因。
参考
- 配置模型:为什么设置存在数据库里
- 环境变量:含
ADMIN_CONFIG_CACHE_TTL_MS - 部署:运行时有哪些绑定
- Cloudflare KV:共享后端