官方为“个人开发者或内部团队快速接入、不需要完整 SaaS 功能”提供了 Simple Mode:隐藏 SaaS 功能、跳过 billing 流程,启动时自动播种默认分组。对 LIN 的团队客户,这是一个可对照的案例:如果团队是“内部共用、内部结算”,重型计费那套未必是必选项——但 LIN 的站点是对外服务形态,是否启用 Simple Mode 是运营方部署决策,专栏应写清两种模式的取舍而非混写。

适用场景:5-20 人内部团队自建/私有化使用,只想解决发 Key 与限流,不想做充值计费时。

Simple Mode 内部团队 RUN_MODE 案例

操作步骤

  1. 设环境变量 RUN_MODE=simple 启用;生产环境还必须设 SIMPLE_MODE_CONFIRM=true 才能启动(安全确认,原文)。
  2. 默认分组每次启动自动播种;想自己管分组则设 SIMPLE_MODE_AUTO_CREATE_DEFAULT_GROUPS=false(只影响播种,不删已有组、不改运行时自动绑定与管理员并发设置)。
  3. 需要按 Key 限消费时开 SIMPLE_MODE_KEY_RATE_LIMIT_ENABLED=true,启用每 Key 的 5 小时/每日/7 日消费窗口。
  4. 上线前明确告知成员:Simple Mode 下余额/订阅扣减被 bypass,窗口限额是唯一的消费闸门。

配置说明

官方原文关键限制:窗口执行以数据库为 source of truth、只记 API-key 窗口用量、是 post-request soft cap——并发在途请求可按各自最终成本 overshoot;历史 simple-mode 用量不回填。把这段原样写进专栏,避免用户误以为是硬上限。

注意事项

  • ⚠️ 拿 soft cap 当硬预算向财务承诺,月末对不上账。
  • ⚠️ 忘了 SIMPLE_MODE_CONFIRM=true,生产启动失败还以为是程序坏了。

来源:https://github.com/Wei-Shaw/sub2api