跳转到内容

默认值与限制 ​

以下行为依据固定源码版本。当前实现已取消旧版的固定容量与并发配额,用户显式设置的正文限制和执行期限继续生效。KiB / MiB 分别是 1024 / 1048576 字节。

开关与范围 ​

项目默认行为
MITM / HTTP 改写 / 脚本 enabledfalse三个独立开关
MITM hosts空空列表不解密;不设条数配额
MITM ports / packages空空时不附加对应限制
MITM tcpfalse按需开启非 HTTP TLS 解密
MITM h2true显式 false 仍有效;只接受 h2 的连接在关闭时透传
MITM skip_server_cert_verifyfalse默认验证真实上游
MITM block_quictrue只作用于可观察名称且命中范围的 QUIC
改写 / HTTP 脚本 / 记录端口80、443、8080、8443各自配置,按原始目标端口;不设条数配额
应用筛选空列表不限应用;指定后未知归属不能匹配

正文限制如何设置 ​

位置与字段缺省或 0正整数-1
http_rewrite.max_body_bytes不限制请求与响应共用的字节上限不限制
http_rewrite.max_request_body_bytes / max_response_body_bytes继承共同值覆盖相应方向的上限该方向不限制
scripts.max_body_bytes不限制拦截正文及脚本输出的字节上限不限制
HTTP 规则的 max_body_bytes继承 scripts.max_body_bytes覆盖当前规则当前规则不限制
单条规则的 http_client.max_body_bytes不限制主动 HTTP 输入/输出上限不限制
记录设置的 bodyLimit每方向保存 64 KiB每方向保存的字节上限保存完整正文

数值须在字段整数可表示范围内,小于 -1 会被拒绝。主动 HTTP 限额与拦截正文独立;记录限额仅改变保存量,不截断实际流量。

例如将下面的正文限制片段合并到已有 experimental,可以把改写请求限制为 8 MiB、响应及拦截脚本限制为 2 MiB。这些数值是示例选择,不是默认值;仍需另行添加和启用相应规则。

json
{
  "experimental": {
    "http_rewrite": {
      "max_request_body_bytes": 8388608,
      "max_response_body_bytes": 2097152
    },
    "scripts": {
      "max_body_bytes": 2097152
    }
  }
}

压缩输入、每层解码结果和改写输出分别检查用户限额。需要处理的请求超限返回 413;响应超限通常跳过正文处理,回放已读内容并继续转发。具体见 Body Rewrite与一元 gRPC。

执行与联网 ​

项目默认或行为
HTTP / Cron timeout_ms缺省或 0 为 5000 ms;正整数为毫秒期限,-1 不增加期限
主动 HTTP timeout默认 5 秒;正数为秒数,-1 不增加期限,0 无效
URL 资源刷新间隔默认 86400 秒;接受可表示为 duration 的正整数秒
URL 资源下载不另加固定总时限;服从调用方及服务取消
主动 HTTP 累计调用默认不限;max_requests 正整数可限制,失败与被拒绝调用也计数
allowed_origins省略/null 不限制,空数组禁止;精确 origin 列表不设条数配额
主动 HTTP / URL 资源重定向检查重定向循环,不设固定跳数配额
HTTP / Cron 解释器、主动 HTTP 并发不设固定数量配额;每次脚本使用独立 VM
Cron 重复到期不同任务独立启动,同一任务运行期间跳过重复到期
定时器 delay非负有限毫秒数,须可表示为 duration;实际最小调度间隔 1 ms
待执行定时器、日志不设每次执行的数量或日志截断配额

脚本的资源加载、网络、定时器与执行共享总期限;-1 不会解除上层请求取消、$done 或服务停止。每条完成路径仍须调用 $done。

正则、jq 与编码 ​

正则表达式、捕获组、替换次数、回溯栈,以及 jq 表达式、输出数量和嵌套不设 B-box 固定配额。回溯与 jq 使用当前请求的取消信号,JS 正则使用当前 VM 的中断;输出仍遵守用户正文限额。

Content-Encoding 支持 identity、gzip/x-gzip、deflate、br、zstd,不再固定为最多三层。zstd 保留协议要求的 8 MiB 最大窗口;窗口大小不等于整段正文大小。

记录、缓存与存储 ​

项目当前行为
配置 JSON、规则、资源、主机列表不设固定容量或数量配额,仍做格式校验
Map Local 文件、JavaScript 源码不设固定文件大小上限
请求记录、头部、trailers、磁盘总量不设固定配额;记录保留到明确清空
正文详情页每页 16 KiB,按需翻页,UTF-8 字符保持完整
页内 JSON 格式化派生显示文本最多 64 KiB,超出时显示原文;不限制保存或导出
HAR / cURL流式读取已保存内容,不再使用 64 KiB 解码截断
URL 资源缓存不设累计磁盘配额;配置激活时回收不再引用的资源
持久存储不设键/值长度、键/命名空间数量、容量及单次读写次数配额

不设固定配额不代表设备资源无限。正文缓冲按实际长度记账,生产环境的 bodyBudgetLimit=0 表示没有全局容量配额;该统计不等于进程内存用量。按实际请求规模设置正文限制,并通过记录与导出区分分页、截断和未完成。

B-box 中文指南 · 基于实际源码整理