如何解决Docker执行docker-compose up时出现的read: connection reset by peer错误？

安全阿岳

2026-7-26

解决Docker连接registry-1.docker.io时被重置的问题

可行的排查与解决步骤：

网络与代理/防火墙排查
1. 先执行curl -v https://registry-1.docker.io/v2/测试直接访问Docker Hub，若同样报错，说明问题出在网络层面。
2. 临时关闭本地防火墙、杀毒软件，或禁用VPN/代理工具——这类软件常拦截Docker的出站连接。
3. 公司内网环境下，需配置Docker代理：
  - Linux编辑/etc/docker/daemon.json，Windows编辑C:\ProgramData\docker\config\daemon.json，添加以下配置：
```
{
  "proxies": {
    "default": {
      "httpProxy": "http://你的代理地址:端口",
      "httpsProxy": "http://你的代理地址:端口",
      "noProxy": "localhost,127.0.0.1"
    }
  }
}
```
  - 配置后重启Docker服务：Linux执行sudo systemctl restart docker，Windows在Docker Desktop中重启。
切换为国内Docker镜像源
国内访问Docker Hub稳定性差，可替换为国内镜像加速源：
编辑daemon.json文件，添加：
```
{
  "registry-mirrors": ["https://hub-mirror.c.163.com"]
}
```
也可使用阿里云个人镜像加速地址，配置完成后重启Docker服务。
调整DNS设置
DNS解析异常会导致连接失败，可切换公共DNS：
- Linux：修改/etc/resolv.conf，添加nameserver 8.8.8.8
- Windows：在网络适配器设置中手动指定DNS为114.114.114.114或8.8.8.8
重置Docker网络栈
Linux执行以下命令重置网络：
```
sudo systemctl stop docker
sudo ip link set dev docker0 down
sudo brctl delbr docker0
sudo systemctl start docker
```
Windows用户可在Docker Desktop设置中选择「Reset to factory defaults」重置。