sepulworld/dinghy-ping

网络连接验证Docker镜像

镜像概述和主要用途

本Docker镜像提供通过API接口或Web界面验证网络连接的功能，旨在帮助用户便捷地检测和确认网络连通性状态。适用于网络诊断、服务可用性监控、自动化测试中的网络验证等场景，支持多种网络协议的连通性测试。

核心功能和特性

• 支持通过API接口进行网络连接验证，便于集成到自动化流程
• 提供直观的Web界面，可视化展示网络连通性检测结果
• 兼容多种网络协议（HTTP/HTTPS、TCP、ICMP等）的连通性测试
• 实时反馈网络连接状态、响应时间及错误信息
• 轻量级设计，资源占用低，部署简单快速

使用场景和适用范围

• 网络故障诊断与排查
• 服务部署后的连通性验证
• 定期网络状态监控与报警
• 自动化测试流程中的网络连通性检查
• 开发/测试环境网络配置验证

使用方法和配置说明

基础部署命令

bash
docker run -d -p 8080:8080 --name network-validator [镜像名称]

环境变量配置

Web界面使用

1. 启动容器后，访问 http://<容器IP>:<PORT> 打开Web界面
2. 在界面表单中输入目标主机、端口和协议（HTTP/HTTPS/TCP/ICMP）
3. 点击"测试连接"按钮，查看实时连通性结果及响应时间

API接口使用

基本请求格式

http
GET /api/validate?protocol=<协议>&host=<主机>&port=<端口>

请求参数

• protocol: 网络协议（http/https/tcp/icmp）
• host: 目标主机地址（域名或IP）
• port: 目标端口（ICMP协议不需要）

响应示例（JSON）

json
{
  "status": "success",
  "protocol": "http",
  "host": "example.com",
  "port": 80,
  "responseTime": 234,
  "message": "Connection successful"
}

Docker Compose配置示例

yaml
version: '3'
services:
  network-validator:
    image: [镜像名称]
    ports:
      - "8080:8080"
    environment:
      - PORT=8080
      - API_KEY=your_secure_api_key
      - TEST_TARGETS=http:example.com:80,https:google.com:443,tcp:github.com:22
      - LOG_LEVEL=info
    restart: unless-stopped