请求设置

设置 标签页决定请求如何传输：使用哪个 HTTP 版本、是否跟随重定向、是否保留 Cookie、是否检查证书，以及它最多可以花多长时间。代理和证书针对整个工作区或整个 App 设置，见本页后面。

设置标签页Copy Anchor Link

请求的文件中只保存你更改过的设置。任何设置与默认值不同时，标签页会显示一个圆点；原始模式开启时，标签页显示 设置（原始）。恢复默认设置 会还原每项设置。

在请求文件中，这些设置如下所示：

[settings]
http-version = "http2"
follow-redirects = false
timeout = 10.0

HTTP 版本Copy Anchor Link

HTTP/3 有一些限制：

• 它需要 macOS 27 或更高版本。在较旧的 Mac 上，标签页会说明这一点，设为 HTTP/3 的请求无法发送；自动 则保持使用 HTTP/2 和 HTTP/1.1。
• 仅限 https:// 地址。
• 不支持代理（包括系统代理）、自定义 CA 文件和客户端证书。设为 HTTP/3 且需要其中任何一项的请求会被拒绝，并说明原因。设为 自动 时，这类请求仍使用 TCP。
• 原始模式不能与 HTTP/3 一起使用。

设为 自动 时，当响应提供 HTTP/3，它的详情卡片会显示 提供 HTTP/3。如果下一个请求的 QUIC 连接失败，Echolot 会改为通过 TCP 发送，并忘记这个提供，详情卡片会说明原因。不会重复发送。

还有两种情况会自行切换版本：

• NTLM 需要 HTTP/1.1。设为 自动 时，NTLM 请求通过 HTTP/1.1 发送；设为 HTTP/2 或 HTTP/3 时则被拒绝。
• 当服务器以 HTTP_1_1_REQUIRED 重置某个 HTTP/2 请求时，Echolot 此后对该服务器使用 HTTP/1.1。可安全重复的请求会立即通过 HTTP/1.1 重新发送；其他请求会停止并显示相应的错误， 你再次发送时则通过 HTTP/1.1 发出。

响应的详情卡片会在 TLS 版本旁边显示所使用的版本。

重定向Copy Anchor Link

跟随重定向 开启时，Echolot 会跟随指向 http:// 和 https:// 地址的 301、302、303、307 和 308 响应：

• 303 变成不带正文的 GET（HEAD 仍是 HEAD）。
• 301 和 302 像浏览器一样，把 POST 变成 GET。
• 307 和 308 保持方法和正文不变。

每一跳都会被记录。详情卡片显示 3 次重定向（或实际次数）；点按它可查看每一跳的状态、方法、地址和耗时，以及最终地址。可以用 Alpenglow 中的 Echo › Follow redirects 试一试。

重定向到另一个源会丢弃你的凭据：Authorization 和 Cookie 标头、API 密钥标头、含有机密的标头、签名（Digest、AWS、Hawk、EdgeGrid、NTLM）以及客户端证书。 见凭据只留在其来源。

跟随重定向 关闭时，3xx 响应就是最终的响应。

CookieCopy Anchor Link

每个窗口都有一个 Cookie 存储。发送并储存 Cookie 开启时，请求会发送存储中与其地址匹配的 Cookie，响应所设置的 Cookie 会进入存储。对于既不该发送也不该保留任何 Cookie 的请求，请将其关闭。

响应的 Cookie 标签页显示 随请求发送 的内容、由响应设置 的内容，以及 储存在此窗口中 的内容。用 Cookie 对应的按钮移除其中一个，或用 全部清除 移除全部。见响应。

存储遵循浏览器的规则：响应不能为整个公共后缀（例如 .com 或 .co.uk）设置 Cookie。可以试一试 Alpenglow 中的 Echo › Set a cookie，然后再向 demo.echolot.dev 发送任何其他请求。

解压缩响应Copy Anchor Link

解压缩响应 开启时，Echolot 会发送 Accept-Encoding: gzip, deflate, br, zstd（除非你自己设置了该标头），并解码 gzip、deflate、Brotli 和 Zstandard 响应。正文 标签页显示解码后的正文； 原样到达的字节保留在 传输 标签页中，正文的存储菜单则提供 存储编码的正文…。详情卡片会显示，例如 br, 12 KB → 48 KB。

关闭它，可以看到服务器压缩后的响应原样，或不发送 Accept-Encoding 标头。

验证 TLS 证书Copy Anchor Link

除非你要对一个证书不被你的 Mac 信任、而你又无法添加其 CA 的服务器进行测试，否则请保持开启。关闭后，详情卡片会显示橙色的打开的锁，它的弹出窗口显示 证书验证已关闭。

对于私有 CA，更好的办法是仅为该主机信任它：见证书。

超时Copy Anchor Link

超时是交换可以花费的总时间，从连接到最后一个字节。时间用尽时，请求会停止并显示 请求超时，连接随即关闭。

原始模式Copy Anchor Link

原始模式用于把请求逐字节按你写的样子发送，包括格式错误的请求，以测试服务器如何处理它。Echolot 会省去它为每个请求添加的标头（Host、User-Agent、Accept、 Accept-Encoding、Cookie、Content-Length 和分帧），也不检查请求是否格式良好。在 自动生成 下，标头 标签页显示 原始模式：Echolot 不添加任何标头，只发送上方的标头。

对于只发送你自己标头的请求，还要把 认证 设为 无认证，并且如果正文需要，请写上你自己的 Content-Type。原始模式写出的是 HTTP/1.1，所以不能与 HTTP/3 一起使用。

重试Copy Anchor Link

Echolot 会保持连接打开并复用它们，这样可以节省 DNS、连接和 TLS 的时间；复用时，详情卡片会显示 复用的连接。有时服务器恰好在请求发出时关闭了保持打开的连接。这时：

• 可安全重复的请求会在新连接上重新发送：GET、HEAD、OPTIONS、TRACE、PUT 或 DELETE，或带有 Idempotency-Key 标头的任何请求。详情卡片会说明它被重新发送了。
• 其他任何请求（比如不带 Idempotency-Key 的 POST）不会重新发送，因为服务器可能已经处理了它。它会停止并显示 在收到任何响应前连接已关闭；服务器可能已处理该请求。

Echolot 在其他任何情况下都不会重试。

代理Copy Anchor Link

请求默认经过 设置 › 网络 中选择的代理：

工作区可以设置自己的代理，它会随工作区传给队友和命令行工具：

1. 从边栏底部的工作区切换器中打开 工作区设置…。
2. 选取 代理 标签页，并关闭 使用 App 的代理设置。
3. 选取 系统设置、环境（HTTPS_PROXY…）（读取 HTTPS_PROXY、HTTP_PROXY 和 NO_PROXY）、无 或 手动。
4. 对于 手动，填写 代理（可以使用变量，例如 {{proxy}}）、用户名 和 密码，以及 直接连接到。把密码写成机密变量 {{proxy_password}}：工作区文件从不保存机密。 字面的密码会提供 移到钥匙串。

HTTP/3 从不经过代理。见工作区。

证书Copy Anchor Link

对于使用私有证书颁发机构、或要求客户端证书（双向 TLS）的主机，请在工作区中添加一条规则：

1. 打开 工作区设置… 并选取 证书 标签页。
2. 点按 添加主机 并输入主机，例如 api.example.com，或用 *.internal 表示每个子域名。
3. 在 信任的 CA 旁边，点按 选取… 并选取一个或多个 PEM 文件。除系统的 CA 之外，它们也会被信任。
4. 对于客户端证书，在 客户端证书 旁边选取文件：PEM 文件或 .p12（.pfx）。对于文件中没有密钥的 PEM 证书，还要选取 私钥 文件。
5. 如果密钥或 .p12 有密码短语，请在 密码短语 中把它写成机密变量，例如 {{p12_passphrase}}。

第一条与主机匹配的规则生效。工作区内的文件以相对于工作区的路径存储，所以这条规则对拥有该工作区的每个人都有效。每条规则的证书只用于它自己的主机：重定向到另一个主机时，绝不会出示第一个主机的客户端证书。

App 级设置Copy Anchor Link

代理是唯一带有 App 级默认值的请求设置（设置 › 网络）。其他每项设置，对每个请求都从上表中的默认值开始，请求的文件保存你所更改的内容。要一次更改许多请求的设置，请在边栏中选中它们， 并用 编辑 N 个请求… 修改它们的标头、参数和认证，或者直接编辑文件。