igops/wait-for-port
igops
一个轻量级（约3MB）的Docker镜像，通过netcat持续尝试连接指定TCP/IP端点，连接成功后退出，用于阻塞执行流程直到依赖服务就绪。
1 次收藏下载次数: 0状态：社区镜像维护者：igops仓库类型：镜像最近更新：2 年前
igops/wait-for-port 镜像文档
镜像概述
igops/wait-for-port 是一个轻量级（约3MB）的Docker镜像，基于netcat实现，用于持续尝试连接指定的TCP/IP端点。当连接成功建立后，容器会自动退出。通过在前台运行此镜像，可以阻塞执行流程（如部署脚本），确保依赖的服务完全启动并开始接受连接后再继续后续操作。
核心功能与特性
- 轻量级设计：镜像大小仅约3MB，资源占用极低
- 简单易用：直接通过命令行参数指定目标主机和端口
- 持续检查机制：默认每0.1秒检查一次连接状态
- 灵活配置：支持通过环境变量调整检查频率
- 自动退出：连接成功后立即退出，不占用额外系统资源
使用场景
- 等待主机操作系统上的服务（如Nginx、SSH服务）启动并开始接受网络连接
- 等待Docker网络中其他容器（如数据库、应用服务）启动并就绪
- 在CI/CD流程或部署脚本中确保依赖服务完全可用后再执行后续步骤
使用方法
基本用法
shelldocker run --rm igops/wait-for-port HOST PORT
示例：检查172.17.0.1主机的80端口是否开放
shelldocker run --rm igops/wait-for-port 172.17.0.1 80
输出：
Waiting for 172.17.0.1:80... OK
实际应用场景
等待主机OS上的服务启动
等待Nginx服务：
shell#!/bin/sh # 启动Nginx容器 docker run --rm -d -p 80:80 nginx # 等待主机80端口开放（使用host-gateway访问主机网络） docker run --rm --add-host="host:host-gateway" igops/wait-for-port host 80 # 确认Nginx就绪后执行HTTP请求 curl -XGET 'http://localhost'
输出：
Waiting for host:80...OK <!DOCTYPE html> <html> <head> <title>Welcome to nginx!</title> ...
等待SSH服务：
shell#!/bin/sh # 等待主机22端口（SSH服务）开放 docker run --rm --add-host="host:host-gateway" igops/wait-for-port host 22 echo "SSH server is running"
等待其他容器启动
同一Docker网络中的容器：
shell#!/bin/sh # 创建自定义Docker网络 docker network create my-bridge # 启动MongoDB容器并加入网络 docker run --rm -d --net my-bridge --net-alias my-mongo mongo # 等待MongoDB的27017端口开放 docker run --rm --net my-bridge igops/wait-for-port my-mongo 27017 echo "MongoDB is up"
通过端口映射的容器：
shell#!/bin/sh # 启动MongoDB容器并映射端口 docker run --rm -d -p 27017:27017 mongo # 等待主机上映射的27017端口开放 docker run --rm --add-host="docker-host:host-gateway" igops/wait-for-port docker-host 27017 echo "MongoDB is up"
环境变量配置
| 变量名 | 描述 | 默认值 |
|---|---|---|
| CHECK_FREQUENCY | 端口检查频率（单位：秒） | 0.1 |
wait4x/wait4x
wait4x
Wait4X用于等待端口或服务进入请求状态。
3 次收藏500万+ 次下载
4 个月前更新
portainer/portainer
portainer
本仓库现已被弃用，不再进行维护与更新，建议用户迁移至 portainer/portainer-ce 仓库以获取持续的功能支持、安全更新及技术维护，该替代仓库为官方推荐的社区版资源，能够提供更稳定的服务和及时的问题修复。
2.6千 次收藏10亿+ 次下载
3 年前更新
portainer/portainer-ce
portainer
Portainer CE 是一款轻量级容器化应用服务交付平台，旨在简化容器应用全生命周期管理，涵盖部署、监控、运维等核心环节，支持多环境统一管理，提供直观可视化界面，帮助用户高效配置、管理和扩展容器集群，降低容器技术使用门槛，适用于开发、测试及生产环境，为企业提供灵活、高效的容器应用交付解决方案。
2.6千 次收藏10亿+ 次下载
21 天前更新
portainer/portainer-ee
portainer
Portainer BE是用于容器化应用的功能全面的服务交付平台
144 次收藏5000万+ 次下载
21 天前更新
portainer/portainer-k8s-beta
portainer
Portainer for Kubernetes BETA是一款用于Kubernetes集群管理的测试版工具。
6 次收藏500万+ 次下载
5 年前更新
portainer/portainer-updater
portainer
用于自动更新Portainer软件的工具
2 次收藏100万+ 次下载
21 天前更新
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
Docker 配置
登录仓库拉取
通过 Docker 登录认证访问私有仓库
专属域名拉取
无需登录使用专属域名
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
Dev Containers
VS Code Dev Containers 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
Harbor 镜像源配置
Harbor Proxy Repository 对接专属域名
Portainer 镜像源配置
Portainer Registries 加速拉取
Nexus 镜像源配置
Nexus3 Docker Proxy 内网缓存
系统配置
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
使用与功能问题
错误码与失败问题
docker pull 提示 manifest unknown 怎么办？
manifest unknown
docker pull 提示 no matching manifest 怎么办？
no matching manifest（架构）
镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？
invalid tar header（解压）
Docker pull 时 HTTPS / TLS 证书验证失败怎么办？
TLS 证书失败
Docker pull 时 DNS 解析超时或连不上仓库怎么办？
DNS 超时
Docker 拉取出现 410 Gone 怎么办？
410 Gone 排查
出现 402 或「流量用尽」提示怎么办？
402 与流量用尽
Docker 拉取提示 UNAUTHORIZED（401）怎么办？
401 认证失败
遇到 429 Too Many Requests（请求太频繁）怎么办？
429 限流
docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？
D-Bus 凭证提示
为什么会出现「单层超过 20GB」或 413，无法加速拉取？
413 与超大单层
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"