官方为“个人开发者或内部团队快速接入、不需要完整 SaaS 功能”提供了 Simple Mode:隐藏 SaaS 功能、跳过 billing 流程,启动时自动播种默认分组。对 LIN 的团队客户,这是一个可对照的案例:如果团队是“内部共用、内部结算”,重型计费那套未必是必选项——但 LIN 的站点是对外服务形态,是否启用 Simple Mode 是运营方部署决策,专栏应写清两种模式的取舍而非混写。
适用场景:5-20 人内部团队自建/私有化使用,只想解决发 Key 与限流,不想做充值计费时。
Simple Mode 内部团队 RUN_MODE 案例
操作步骤
- 设环境变量
RUN_MODE=simple启用;生产环境还必须设SIMPLE_MODE_CONFIRM=true才能启动(安全确认,原文)。 - 默认分组每次启动自动播种;想自己管分组则设
SIMPLE_MODE_AUTO_CREATE_DEFAULT_GROUPS=false(只影响播种,不删已有组、不改运行时自动绑定与管理员并发设置)。 - 需要按 Key 限消费时开
SIMPLE_MODE_KEY_RATE_LIMIT_ENABLED=true,启用每 Key 的 5 小时/每日/7 日消费窗口。 - 上线前明确告知成员:Simple Mode 下余额/订阅扣减被 bypass,窗口限额是唯一的消费闸门。
配置说明
官方原文关键限制:窗口执行以数据库为 source of truth、只记 API-key 窗口用量、是 post-request soft cap——并发在途请求可按各自最终成本 overshoot;历史 simple-mode 用量不回填。把这段原样写进专栏,避免用户误以为是硬上限。
注意事项
- ⚠️ 拿 soft cap 当硬预算向财务承诺,月末对不上账。
- ⚠️ 忘了
SIMPLE_MODE_CONFIRM=true,生产启动失败还以为是程序坏了。