配置

bouine 通过 --config 传递的 YAML 文件配置。环境变量在解码前展开（${VAR}、${VAR:-default}）。

listen:
  http: ":8080"
  https: ":443"
  admin: ":9000"

storage:
  hot_max_bytes: 1GiB

upstream_pools:
  - name: app
    targets: ["app.default.svc:8080"]
    health:
      active:
        path: /healthz
        interval: 10s

routes:
  - match: { path_prefix: /api/ }
    pool: app
    cache:
      ttl_default: 60s
      stale_while_revalidate: 10s
      stale_if_error: 300s

本节页面

• 缓存策略 — TTL 选择、覆盖、stale-while-revalidate、负缓存、抖动、缓存键。
• 流式与实时响应 — SSE、流式 miss、fetch 槽位卸载与内存上限。
• 集群模式 — strong、eventual；headless Service；gossip。
• Helm Chart — Helm chart 可配置值。
• 静态文件服务 — 无需源站从磁盘服务文件。
• 存储 — hot（RAM）和 warm（mmap）层、SIEVE 淘汰。
• TLS — TLS 终止、peer 间 mTLS、证书。
• 实验性功能 — 可能变更的 opt-in 功能。

v0.5.27–v0.5.29 新增配置

• routes[].match.path — 锚定 RE2 正则路径匹配，与 path_prefix 互斥；match.host 支持 *. 开头的通配符后缀匹配（v0.5.27）。
• routes[].request.forwarded — 在发往源站的请求上注入 X-Forwarded-For、X-Forwarded-Proto、X-Forwarded-Host 和 Via（v0.5.27）；可通过顶层 route_defaults.request.forwarded 一次性声明。
• routes[].cache.bypass_on_user_agent — 按 User-Agent glob 模式完全绕过缓存（v0.5.27）；route_defaults.cache.bypass_on_user_agent 一次性声明。
• routes[].cache.bypass_on_cookie_names — 请求携带名单中的 cookie 名即完全绕过缓存（v0.5.27）。
• routes[].cache.key.cookie_presence — 按 cookie 是否存在（而非其值）为 Vary 变体键贡献比特位（v0.5.27）。
• upstream_pools[].connect.preserve_host — 向源站转发时保留请求自身的 Host 头，拨号目标不变（v0.5.28）。
• TCP Fast Open 三层面：listen.tcp_fast_open（监听）、upstream_pools[].connect.tcp_fast_open（源站拨号）、cluster.peer_tcp_fast_open（peer 拨号）——v0.5.29 起默认全部关闭，需显式开启（仅 Linux）。
• cluster.peer_fetch_concurrency — 每节点并发 peer-fetch/put RPC 上限的默认值从 4 提升到 16（v0.5.29）。
• metrics.traffic_classes — 按主机模式声明最多 8 个命名流量群体，为数据面指标添加 traffic_class 标签（v0.5.27）。
• ttl_override — 自 v0.5.29 仅作用于成功与重定向响应（status < 400）；可缓存的错误响应按负缓存 TTL 阶梯过期。
• listen.max_connections — 默认上限自 v0.6.0 从 4096 提升到 65536；accept 拒绝由 bouine_conn_rejections_total 精确计数。
• H1 fast path 始终启用（v0.6.0，ADR-0069）：experimental.h1_fast_path 与 h1_fast_peer_path 已退役（键被忽略，启动时记录提示），experimental.h1_reactor 已移除（严格解析报未知字段错误，请删除该键）。
• routes[].cache.max_fetch_concurrency — 内置默认值自 v0.6.0 从 32 提升到 256。
• cluster.peer_fetch_concurrency — 默认值自 v0.6.0 从 16 提升到 64。
• health.passive — v0.6.1 起未设置 eject_for 时默认为 30 秒恢复窗口；v0.6.0 起 5xx 仅在目标 5 秒无成功响应后才计入驱逐；consecutive_5xx 与 eject_for 支持按 pool 热配置（v0.6.0）。
• 热配置（v0.6.0）：bouine config get/set/diff、bouine config reload（实验性，需 experimental.config_reload）、GET|POST /v1/config/hot、POST /v1/config/reload——另见 CLI 与 API。
• 新 CLI 命令 / API（v0.6.0）：bouine status、bouine explain、bouine keys find/top/recent、GET /v1/status、GET /v1/explain、GET /v1/keys/*。
• Set-Login 自 v0.6.0 起与 Set-Cookie 一样进入所有存储门控与存储剥离（ADR-0067）；携带客户端状态的响应不再通过 collapse 发给第二个客户端。
• 无 include_headers 的冷 miss 合并为一次填充 flight，从存储中服务（ADR-0066，v0.6.0）。
• ban 上限自 1024 提升到 4096，注册 O(1)，surrogate ban 通过无锁集合执行（v0.6.0）。