网络基础设施标识符格式检查

目标与适用范围

在进入配置、清单或数据处理前，检查 IPv4、IPv6、CIDR、MAC 地址、AWS ARN 和 Docker 镜像引用的语法与结构，并明确区分格式证据和可达性、归属、权限及镜像可用性。
本指南将当前任务范围转化为可复核的交付结果。请保留源文件、中间产物和关键判断，让后续协作者能够理解检查了什么以及为什么这样处理。

准备证据并作出选择

• 把原始值、来源字段和预期标识符类型放在一起保存，不要用规范化副本覆盖原文。

• 提前约定 IPv4 或 IPv6 是否允许 CIDR、接受哪种 MAC 展示方式，以及消费者支持哪些 ARN 或 Docker 引用形式。

• 尽量使用脱敏或合成的基础设施值，并写明后续是否还需要连通性、设备归属、授权或镜像仓库状态检查。

• 决策点: 输入到底属于哪种标识符？. IPv4、IPv6 和 CIDR 候选交给 ip-address-validator，MAC 展示交给 mac-address-validator，AWS 资源字符串交给 aws-arn-validator，镜像引用交给 docker-image-tag-validator。导入数据含义不清时，不能只凭字段名路由。

• 决策点: 哪些变化可以做规范化？. 只有在规则明确时才去掉首尾空白。保留原始值、CIDR 前缀、MAC 分隔符、ARN 各段、镜像仓库路径、标签和 digest，确保复核时看得出格式信息是否被丢失。

• 决策点: 格式结果能否直接支持下一步决策？. 通过只能说明语法或结构门槛已满足。如果问题涉及地址可达、设备归属、AWS 资源存在与权限，或仓库是否有该镜像，应交给获授权的运维检查。

按步骤完成工作流

1. 盘点输入并完成路由

建立小表，记录来源字段、原始值、预期类型以及环境或命名约定。在改变展示形式前，先把每一行路由到四个校验器之一。 使用 ip-address-validator, mac-address-validator, aws-arn-validator, docker-image-tag-validator.

2. 检查网络地址与接口语法

用 IP 校验器检查 IPv4、IPv6 和支持的 CIDR，再用 MAC 校验器检查冒号、连字符、Cisco 风格或紧凑写法。并排保留原始与规范化结果，定位版本、分隔符或组成部分错误。 使用 ip-address-validator, mac-address-validator.

3. 检查云资源与容器引用

把 AWS 资源字符串交给 ARN 校验器，把包含 registry、repository、tag 或 digest 的镜像引用交给 Docker 校验器。逐项审阅结构字段，不要把通用 valid 标记当成部署检查的全部结论。 使用 aws-arn-validator, docker-image-tag-validator.

4. 整理失败证据并移交运维检查

记录被拒绝的原值、失败规则、修正候选和审阅结论。只有格式门槛通过后，才让获授权的负责人继续做网络、资产、IAM 或仓库检查，因为这些问题不由本工作流回答。 使用 ip-address-validator, mac-address-validator, aws-arn-validator, docker-image-tag-validator.

交付前验收结果

• 每个候选值都记录了类型、原始值、规范化规则、所选校验器和格式级结果。
• IP 结果说明地址形式及 CIDR 处理方式；MAC 结果保留展示形式和工具报告的类型或厂商细节；ARN 与 Docker 结果保留解析出的结构字段。
• 非法八位组、前缀范围错误、分隔符畸形、ARN 组成缺失、仓库名不合法或标签无效等常见失败都有明确的修正路径。
• 任何格式通过都没有被描述为可达、归属、权限、资源存在、仓库可用或镜像可拉取的证明。

常见问题

• IP 地址格式有效，是否就代表主机可达？ 不代表。IP 校验器检查地址语法和支持的 CIDR 结构；可达性还要通过获授权的网络测试确认，并且会受到路由、防火墙、服务状态和时间变化影响。
• MAC 校验结果能证明设备归属吗？ 不能。MAC 格式、是否本地管理以及工具报告的厂商信息都只是输入中的标识线索，不能证明当前设备、所有者、位置或网络连接关系。
• ARN 格式有效，是否就证明 AWS 资源存在或我有权限？ 不能。ARN 校验只检查字符串结构和组成部分。资源是否存在、账号访问权、IAM 权限以及服务是否支持该资源，都要通过获授权的 AWS 流程检查。
• Docker 镜像引用格式有效，是否就能拉取镜像？ 不能。引用即使语法正确，也可能对应不存在的标签、私有仓库、无权访问的 registry，或尚未推送的镜像。