dishcloth/probe

轻量级快速探测工具镜像文档

1. 镜像概述

本镜像是一个轻量级"quick and dirty"探针工具，设计初衷是提供快速、便捷的系统或服务探测能力。它专注于"快速可用"，无需复杂配置，可直接部署使用，适合临时诊断、快速验证场景，帮助用户在无需搭建完整监控系统的情况下，快速获取目标服务状态或基础系统信息。

2. 核心功能与特性

• 快速部署：镜像体积小，拉取及启动速度快，秒级即可投入使用
• 零配置启动：默认无需预先配置，通过命令行参数直接指定探测目标
• 多协议支持：基础支持HTTP、TCP、ICMP等常见协议探测（根据工具实现可能略有差异）
• 轻量级设计：镜像精简，资源占用低，可在资源受限环境运行
• 结果简洁：输出信息直观，专注核心探测结果，避免冗余数据

3. 适用场景

• 临时服务健康检查：快速验证目标服务（如Web服务、数据库）是否正常响应
• 网络连通性诊断：临时检查主机间网络连通性（端口开放状态、协议可达性）
• 简单系统信息收集：快速获取目标主机基础信息（如操作系统版本、资源占用概况）
• 开发/测试环境验证：开发或测试过程中，快速验证服务部署状态或接口可用性
• 应急故障排查：故障发生时，无需部署复杂工具，快速定位基础连通性或服务状态问题

4. 使用方法与配置说明

4.1 基本部署命令

通过docker run直接启动，基本格式如下：

bash
docker run --rm [镜像名称] [探测参数]

4.2 常用参数说明

4.3 典型使用示例

示例1：TCP端口连通性探测

检查目标主机192.168.1.100的8080端口是否开放：

bash
docker run --rm quick-probe --target 192.168.1.100 --port 8080 --proto tcp

预期输出：TCP probe to 192.168.1.100:8080 - Success (Response time: 23ms)

示例2：HTTP服务状态探测

检查https://example.com的服务响应状态：

bash
docker run --rm quick-probe --target example.com --port 443 --proto http --ssl

预期输出：HTTP probe to example.com:443 - Status Code: 200 (OK), Response time: 156ms

示例3：简单系统信息探测

获取本地容器运行环境的基础系统信息：

bash
docker run --rm quick-probe --sys-info

预期输出：OS: Linux 5.15.0-78-generic, CPU Cores: 4, Memory Usage: 1.2G/8G

4.4 输出结果说明

工具输出遵循固定格式，主要包含：

• 探测类型（TCP/HTTP/ICMP/系统信息）
• 目标信息（地址、端口、协议）
• 探测结果（成功/失败）
• 关键指标（响应时间、状态码、系统资源等）

5. 注意事项

• 本工具设计为"quick and dirty"场景使用，不建议用于生产环境长期监控
• ICMP协议探测可能需要容器具备相应网络权限（如--cap-add=NET_RAW）
• 部分协议探测受网络策略限制（如防火墙规则可能影响探测结果）
• 镜像未包含复杂安全加固，不建议在不信任网络环境中暴露敏感目标探测