docker curl: (35) Recv failure

### 解决 Docker 中 `curl` 命令出现 `Recv failure` 错误的方法

当遇到 `curl: (56) Recv failure: Connection reset by peer` 或类似的接收失败错误时，这通常表明客户端与服务器之间的连接被意外中断。此类问题可以由多种因素引起，包括但不限于网络配置不当、防火墙设置阻止通信或是目标服务端口未开放。

对于运行于 Docker 容器内的应用程序来说，如果尝试通过 `curl` 发起 HTTP 请求却遭遇上述异常，则可能是由于容器本身的网络模式设定不正确造成的[^1]。为了排查并最终解决问题，可以从以下几个方面入手：

#### 一、验证宿主机到目的地址连通性
先在物理机上测试能否正常访问外部资源：

curl http://example.com/

#### 二、确认容器内DNS解析功能正常工作
有时即使能够Ping通IP地址也可能因为域名无法解析而导致请求失败。可以在启动容器时指定自定义 DNS 服务器来规避此风险：

services:
  webapp:
    image: myimage
    dns:
      - 8.8.8.8
      - 8.8.4.4

#### 三、调整Docker容器网络参数
默认情况下，Docker 使用桥接网卡创建独立的虚拟子网给各个容器使用。然而，在某些特殊场景下（比如跨多个节点部署集群），这种隔离可能会带来不必要的麻烦。此时可考虑采用host模式让容器共享宿主机的真实网络接口；或者构建overlay network实现更灵活的服务发现机制。
- Host Mode Example:

version: '3'
services:
  app:
    image: nginx
    ports:
      - "80:80"
    networks:
      mode: host

#### 四、检查是否存在安全组规则或其他形式的安全策略阻碍流量进出
云平台上的实例往往预设了一些严格的出入站控制列表ACLs，它们会过滤掉不符合条件的数据包。务必确保允许必要的协议和端口号通行无阻。

#### 五、更新或重新编译Curl库版本
旧版软件可能存在已知漏洞或者是针对特定环境做了优化处理，因此升级至最新稳定发行版有助于提高兼容性和稳定性。

以上措施应该能有效缓解乃至彻底消除大部分因网络状况不佳所引发的 `curl` 执行期间发生的 `recv()` 函数调用返回ECONNRESET的情况。当然，具体实施过程中还需要结合实际情况作出适当调整。