在Kubernetes集群的实际使用中，服务端点URL会以IP地址或者FQDN两种形式存在，比如常见的10.96.0.1:443、kubernetes.default.svc.cluster.local:6443这类格式，要实现对这类混合场景的端点URL精确匹配，需要针对性构建正则表达式。
Kubernetes端点URL的常见格式分析
Kubernetes内的端点URL主要由三部分组成：主机部分、端口部分，部分场景还会包含协议前缀。其中主机部分分为两类：
- IP地址：包含IPv4地址，格式为四段0-255的数字用点分隔，比如
192.168.1.10、10.0.0.1 - FQDN：完全限定域名，由多个标签用点分隔，每个标签只能包含字母、数字、连字符，且不能以连字符开头或结尾，比如
my-svc.my-namespace.svc.cluster.local
端口部分为冒号后跟1-65535的数字，协议前缀常见为http://、https://，部分场景也可能没有协议前缀。
正则匹配规则拆解
IPv4地址匹配规则
IPv4的每段数字范围是0-255，需要分情况处理：
- 250-255：
25[0-5] - 200-249：
2[0-4][0-9] - 0-199：
[01]?[0-9][0-9]?
四段组合的正则为：(?:(?: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]?)
FQDN匹配规则
FQDN的每个标签规则为[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?，多个标签用点分隔，整体正则为：(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?.)+[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?
端口匹配规则
端口为:(?:[1-9][0-9]{0,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5])，简化后可以用:d{1,5}配合后续校验，或者直接使用:(?:[1-9]d{0,4}|[1-5]d{4}|6[0-4]d{3}|65[0-4]d{2}|655[0-2]d|6553[0-5])精确匹配1-65535的端口。
完整正则表达式构建
结合上述规则，我们可以构建支持协议前缀、同时匹配IP和FQDN的端点URL正则：
基础版本（无协议前缀）
仅匹配主机加端口的格式：
^(?:(?:(?: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-Z0-9-]*[a-zA-Z0-9])?):(?:[1-9]d{0,4}|[1-5]d{4}|6[0-4]d{3}|65[0-4]d{2}|655[0-2]d|6553[0-5])$
带协议前缀版本
支持http和https协议前缀：
^(?:https?://)?(?:(?:(?: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-Z0-9-]*[a-zA-Z0-9])?):(?:[1-9]d{0,4}|[1-5]d{4}|6[0-4]d{3}|65[0-4]d{2}|655[0-2]d|6553[0-5])$
验证与使用示例
我们可以使用Python的re模块验证正则的匹配效果：
import re
# 定义正则规则
pattern = r'^(?:https?://)?(?:(?:(?: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-Z0-9-]*[a-zA-Z0-9])?):(?:[1-9]d{0,4}|[1-5]d{4}|6[0-4]d{3}|65[0-4]d{2}|655[0-2]d|6553[0-5])$'
# 测试用例
test_cases = [
'10.96.0.1:443', # 合法IPv4端点
'kubernetes.default.svc.cluster.local:6443', # 合法FQDN端点
'https://192.168.0.1:8080', # 带协议的IPv4端点
'http://my-svc.test.svc:80', # 带协议的FQDN端点
'256.0.0.1:80', # 非法IP
'kubernetes..svc:6443', # 非法FQDN
'10.96.0.1:70000', # 非法端口
]
for case in test_cases:
if re.match(pattern, case):
print(f'{case} 匹配成功')
else:
print(f'{case} 匹配失败')
运行上述代码后，会输出每个测试用例的匹配结果，帮助我们确认正则的准确性。
注意事项
- 如果不需要匹配端口，可以去掉正则中端口相关的部分
- 如果FQDN需要支持更多特殊字符，可以根据实际需求调整标签的匹配规则
- 在Kubernetes的Ingress或者NetworkPolicy配置中使用该正则时，需要注意对应配置项的语法要求，避免正则转义问题
Kubernetes正则表达式FQDNIP地址URL匹配修改时间：2026-07-02 22:54:33