网络地址转换与证据整理

目标与适用范围

校验地址、转换 IPv4 与 IPv6 表示，规范化 URL 和 webhook 输入，并整理 DNS、hosts、端口、WHOIS 与抓包证据。
本指南将当前任务范围转化为可复核的交付结果。请保留源文件、中间产物和关键判断，让后续协作者能够理解检查了什么以及为什么这样处理。

准备证据并作出选择

• 准备需要规范化的地址列表、CIDR 范围、URL、webhook 样例、主机名和抓包文件。

• 确认哪些查询或端口检查已获授权，并把证据整理与事故根因诊断分开。

• 决策点: 你是在整理规范化证据，还是诊断线上故障？. 如果目标是得到转换后的地址、URL 参数、DNS 记录、WHOIS 信息、hosts 条目、端口状态或抓包摘要，用此工作流；如果要解释服务为什么失败，转到 network-triage-debugging。

• 决策点: 下一步决策由地址、URL，还是端点记录驱动？. IP 密集任务先做地址提取与转换；请求证据先解析 URL；交接依赖端点上下文时，再整理 DNS、WHOIS、hosts、端口和抓包摘要。

按步骤完成工作流

1. 校验并提取地址清单

先校验单个 IPv4 和 IPv6 值，从日志或文档中提取地址，并计算 CIDR 归属，确保后续步骤使用可信地址集合。 使用 ip-address-validator, ip-address-extractor, cidr-calculator.

2. 转换 IPv4 与 IPv6 表示

当不同系统用整数、IPv4 或 IPv6 映射形式表示同一端点时，完成双向转换，并同时保留原始值和转换值以便审计。 使用 integer-to-ipv4, integer-to-ipv6, ipv4-to-integer, ipv4-to-ipv6, ipv6-to-integer.

3. 规范化请求与 webhook 输入

结合 webhook 中继结果与 URL 查询工具，捕获回调行为、解码参数、区分跟踪字段和路由字段，并形成可复现的请求证据。 使用 webhook-debugger-relay, url-query-analyzer, url-parameter-extractor.

4. 打包端点与流量证据

补充抓包摘要、DNS 答案、hosts 条目、授权范围内的端口检查和 WHOIS 归属信息，让后续审阅者无需重做转换即可继续排查。 使用 network-packet-analyzer, dns-query, hosts-file-editor, port-scanner, whois-lookup.

交付前验收结果

• 所有输入 IP 都已校验、提取、转换，并按解释其网络归属的 CIDR 范围分组。
• URL 查询参数和 webhook 样例在不丢失原始值、编码字段、回调头和重放备注的前提下完成规范化。
• DNS、hosts 文件、端口、WHOIS 和抓包发现被记录为证据，而不是被包装成完整事故诊断。

常见问题

• 它和 network-triage-debugging 有什么区别？ 本 Hub 整理规范化后的地址、URL、端点记录和流量证据；network-triage-debugging 用于进一步解释请求、端点、证书、路由或抓包为什么失败。
• 端口扫描能对任意主机运行吗？ 不能。端口检查只应运行在你拥有或明确授权测试的系统上，并把授权范围与结果一起记录。
• 转换后的 IP 值应该覆盖原值吗？ 不应该。原始值、转换值、转换方向和来源上下文都应一起保存，方便后续审计。
• DNS 或 WHOIS 证据能证明根因吗？ 不能单独证明。它们只是转换交接包里的上下文；事故诊断应放到 triage 工作流中完成。