[root@localhost ~]# docker push localhost:5000/nginx:latest The push refers to repository [localhost:5000/nginx] Get "http://localhost:5000/v2/": dial tcp [::1]:5000: connect: connection refused

### Docker推送镜像时连接被拒绝的问题分析与解决 在Docker推送镜像时遇到`connection refused`错误，通常是因为目标镜像仓库未正确配置或未运行。以下是对该问题的详细分析和解决方案。 #### 1. 确认Docker守护进程是否监听端口5000 默认情况下，Docker守护进程不会监听自定义端口（如5000）。如果需要使用特定端口进行镜像推送，必须明确配置Docker守护进程以监听该端口。可以通过修改Docker的配置文件实现此目的[^4]。 ```bash # 编辑Docker配置文件（以Ubuntu为例） sudo nano /etc/docker/daemon.json ``` 在文件中添加以下内容以启用端口5000： ```json { "hosts": ["tcp://0.0.0.0:5000", "unix:///var/run/docker.sock"] } ``` 保存文件后重启Docker服务以应用更改： ```bash sudo systemctl restart docker ``` #### 2. 检查目标镜像仓库是否运行 如果目标是本地私有镜像仓库（例如通过`docker registry`运行），需要确保该服务已启动并正在监听端口5000。可以使用以下命令检查： ```bash docker ps | grep registry ``` 如果没有找到相关容器，可以启动一个本地镜像仓库： ```bash docker run -d -p 5000:5000 --name registry registry:2 ``` #### 3. 验证网络连接 确认客户端能够访问目标端口5000。可以使用以下命令测试连接： ```bash telnet localhost 5000 ``` 如果连接失败，可能是防火墙阻止了该端口的流量。检查并调整防火墙规则以允许端口5000的流量： ```bash sudo ufw allow 5000/tcp ``` #### 4. 配置Docker客户端以使用自定义镜像仓库 在推送镜像之前，需要标记镜像以匹配目标仓库的地址。例如，如果目标仓库运行在`localhost:5000`，可以执行以下命令： ```bash docker tag <image_id> localhost:5000/<repository_name>:<tag> ``` 然后执行推送命令： ```bash docker push localhost:5000/<repository_name>:<tag> ``` #### 5. 排查代理设置冲突 如果系统中启用了HTTP/HTTPS代理，可能会干扰Docker与目标仓库的通信。可以通过检查Docker配置文件中的代理设置来排查问题[^2]。 ```json { "proxies": { "default": { "httpProxy": "", "httpsProxy": "", "noProxy": "localhost,127.0.0.1" } } } ``` 确保`localhost`和`127.0.0.1`包含在`noProxy`列表中。 #### 6. 检查Docker版本兼容性 某些版本的Docker可能存在与特定功能的兼容性问题。建议升级到最新稳定版本以避免潜在问题[^4]。 ```bash sudo apt-get update sudo apt-get install docker-ce docker-ce-cli containerd.io ``` --- ### 示例代码 以下是一个完整的流程示例，展示如何配置和推送镜像到本地私有仓库： ```bash # 启动本地镜像仓库 docker run -d -p 5000:5000 --name registry registry:2 # 标记镜像 docker tag my-image localhost:5000/my-image:latest # 推送镜像 docker push localhost:5000/my-image:latest ``` ---