Kubernetes集群端点IP或FQDN的正则表达式构建指南-js教程-PHP中文网

Kubernetes集群端点IP或FQDN的正则表达式构建指南

DDD

发布： 2025-11-01 14:52:00

原创

630人浏览过

Kubernetes集群端点IP或FQDN的正则表达式构建指南

本文旨在提供一个全面的正则表达式方案，用于验证kubernetes集群端点url。该方案能够精确匹配以ipv4地址或完全限定域名（fqdn）开头的url，并随后接特定格式的路径（如`/k8s/clusters/c-m-xxxx`），同时确保url不以斜杠结尾，适用于angular/typescript等前端应用场景。

构建Kubernetes集群端点URL的正则表达式

在现代Web应用开发中，尤其是在与后端服务或API进行交互时，对URL进行格式验证是一项常见且重要的任务。对于Kubernetes集群端点这类包含动态信息（如IP地址或域名）和特定路径结构的URL，使用正则表达式进行验证是高效且可靠的方法。本文将详细介绍如何构建一个能够同时匹配IP地址和FQDN作为主机部分，并遵循特定路径格式的Kubernetes集群端点URL的正则表达式。

需求分析

我们需要构建一个正则表达式，来验证以下两种格式的Kubernetes集群端点URL：

IP地址作为主机名：10.210.163.246/k8s/clusters/c-m-vftt4j5q
FQDN（完全限定域名）作为主机名：fg380g9-32-vip3-ocs.sample.company.com/k8s/clusters/c-m-8vcjbtwh

核心要求包括：

URL必须以IPv4地址或FQDN开头。
主机部分后必须紧跟一个斜杠 /。
路径部分应遵循 /segment/segment/.../last-segment 的模式，其中 segment 由字母、数字和连字符组成。
URL不允许以斜杠 / 结尾。
适用于Angular/TypeScript环境，意味着兼容JavaScript的正则表达式引擎。

挑战与解决方案

最初的尝试可能包括将IP地址、FQDN和路径的正则表达式分别构建，然后尝试组合。然而，简单的拼接往往会因为 ^ (匹配字符串开头) 和 $ (匹配字符串结尾) 锚点的使用不当而导致匹配失败。例如，如果主机部分的正则表达式内部包含 $，它将阻止后续路径部分的匹配。

正确的策略是将整个URL视为一个整体，并使用 | (或) 运算符来处理主机部分的不同类型（IP或FQDN），同时确保 ^ 和 $ 锚点作用于整个表达式的开始和结束。

统一的正则表达式方案

以下是能够满足上述所有要求的统一正则表达式：

/^((?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)|(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9-]*[a-zA-Z0-9])\.)+([A-Za-z][A-Za-z0-9-]*[A-Za-z0-9]))\/(([a-zA-Z0-9-]+)\/)+([a-zA-Z0-9-]+)$/

登录后复制

正则表达式详解

我们将上述正则表达式分解为几个核心部分进行解释：

1. 整体结构与锚点

^: 匹配字符串的开始。
$: 匹配字符串的结束。这两个锚点确保整个字符串必须完全符合正则表达式的模式，而不是部分匹配。

2. 主机部分 (((?:...)|(?:...)))

这部分使用 | 运算符来匹配IPv4地址或FQDN。

集简云

软件集成平台，快速建立企业自动化与智能化

查看详情

IPv4地址匹配 ((?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?))
- (?:...): 非捕获组，用于分组但不创建单独的捕获。
- 25[0-5]: 匹配 250-255。
- 2[0-4][0-9]: 匹配 200-249。
- [01]?[0-9][0-9]?: 匹配 0-199 (包括 0-9, 10-99, 100-199)。
- \.: 匹配字面量点号。
- {3}: 前面的组（一个IP段加一个点）重复3次，匹配前三个八位字节。
- 最后一个 (?:25[0-5]|...) 匹配第四个八位字节，其后没有点。
FQDN（完全限定域名）匹配 ((([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9-]*[a-zA-Z0-9])\.)+([A-Za-z][A-Za-z0-9-]*[A-Za-z0-9]))
- ([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9-]*[a-zA-Z0-9]): 匹配单个域名标签（如 sample 或 company）。
  - 它允许标签以字母或数字开头和结尾，中间可以包含连字符。
  - [a-zA-Z0-9]: 匹配单个字母或数字。
  - [a-zA-Z0-9][a-zA-Z0-9-]*[a-zA-Z0-9]: 匹配以字母或数字开头和结尾，中间可以有零个或多个字母、数字或连字符的字符串。
- \.: 匹配字面量点号。
- (...)+: 前面的组（一个域名标签加一个点）重复一次或多次，匹配域名的多个部分（如 fg380g9-32-vip3-ocs.sample.）。
- ([A-Za-z][A-Za-z0-9-]*[A-Za-z0-9]): 匹配顶级域名 (TLD) 或最后一个域名标签，它必须以字母开头，且不能以连字符结尾。这里稍微简化了TLD的严格规则，使其能匹配 com 或 io 等。

3. 主机与路径分隔符 (\/)

\/: 匹配主机部分和路径部分之间的字面量斜杠 /。

4. 路径部分 ((([a-zA-Z0-9-]+)\/)+([a-zA-Z0-9-]+))

这部分匹配 /k8s/clusters/c-m-vftt4j5q 这样的路径结构，并确保没有尾随斜杠。

([a-zA-Z0-9-]+): 匹配一个路径段（如 k8s、clusters 或 c-m-vftt4j5q）。它由一个或多个字母、数字或连字符组成。
\/: 匹配路径段后的斜杠。
(([a-zA-Z0-9-]+)\/)+: 这个组匹配一个或多个 segment/ 结构，例如 /k8s/ 和 /clusters/。
([a-zA-Z0-9-]+): 匹配最后一个路径段（如 c-m-vftt4j5q），其后没有斜杠，从而满足了不允许以斜杠结尾的要求。

示例代码与测试

在Angular/TypeScript环境中，你可以这样使用这个正则表达式：

const kubernetesEndpointRegex = /^((?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)|(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9-]*[a-zA-Z0-9])\.)+([A-Za-z][A-Za-z0-9-]*[A-Za-z0-9]))\/(([a-zA-Z0-9-]+)\/)+([a-zA-Z0-9-]+)$/;

// 示例 1: IP地址作为主机名
const endpoint1 = "10.210.163.246/k8s/clusters/c-m-vftt4j5q";
console.log(`"${endpoint1}" 匹配结果:`, kubernetesEndpointRegex.test(endpoint1)); // 输出: true

// 示例 2: FQDN作为主机名
const endpoint2 = "fg380g9-32-vip3-ocs.sample.company.com/k8s/clusters/c-m-8vcjbtwh";
console.log(`"${endpoint2}" 匹配结果:`, kubernetesEndpointRegex.test(endpoint2)); // 输出: true

// 负面示例: 带有尾随斜杠
const endpoint3 = "10.210.163.246/k8s/clusters/c-m-vftt4j5q/";
console.log(`"${endpoint3}" 匹配结果:`, kubernetesEndpointRegex.test(endpoint3)); // 输出: false

// 负面示例: 不完整的路径
const endpoint4 = "10.210.163.246/k8s";
console.log(`"${endpoint4}" 匹配结果:`, kubernetesEndpointRegex.test(endpoint4)); // 输出: false

// 负面示例: 非法IP
const endpoint5 = "999.210.163.246/k8s/clusters/c-m-vftt4j5q";
console.log(`"${endpoint5}" 匹配结果:`, kubernetesEndpointRegex.test(endpoint5)); // 输出: false

登录后复制

你也可以在 regex101.com 这样的在线工具上测试这个正则表达式，以更直观地理解其工作原理。