new Agent([options])

版本历史
版本变更
v24.5.0

添加对 proxyEnv 的支持。

v24.5.0

添加对 defaultPort 和 protocol 的支持。

v12.5.0

如果目标主机是使用 IP 地址指定的，则不要自动设置服务器名称。

  • options <Object> 要在代理上设置的可配置选项集。可以具有与 http.Agent(options) 相同的字段，以及

    ¥options <Object> Set of configurable options to set on the agent. Can have the same fields as for http.Agent(options), and

    • maxCachedSessions <number> TLS 缓存会话的最大数量。使用 0 禁用 TLS 会话缓存。默认值：100。

      ¥maxCachedSessions <number> maximum number of TLS cached sessions. Use 0 to disable TLS session caching. Default: 100.

    • servername <string> 要发送到服务器的 服务器名称指示扩展 的值。使用空字符串 '' 禁用发送扩展名。默认值：目标服务器的主机名，除非使用 IP 地址指定目标服务器，在这种情况下，默认值为 ''（无扩展名）。

      ¥servername <string> the value of Server Name Indication extension to be sent to the server. Use empty string '' to disable sending the extension. Default: host name of the target server, unless the target server is specified using an IP address, in which case the default is '' (no extension).

      有关 TLS 会话重用的信息，请参阅会话恢复。

      ¥See Session Resumption for information about TLS session reuse.