文档中心

容器服务

请输入

服务（Service）

外部服务映射（ExternalName）

外部服务映射（ExternalName）在集群中将一个内部服务名称映射到一个外部域名，使得集群内的 Pod 可以通过 Service 名称来访问外部域名。本文介绍如何配置 ExternalName 类型的服务。

背景信息

当在集群中创建一个 ExternalName 类型的服务时，Kubernetes 不会为该服务分配 ClusterIP，也不会创建 Endpoints，而是通过 CoreDNS 返回一条 CNAME 记录，把服务名映射到外部的 DNS 域名上。集群内部的工作负载可以通过 Service 名称（例如 service-demo.default.svc.cluster.local）访问集群外部的服务，无需在应用中硬编码外部域名。

操作步骤

说明

通过 kubectl 命令行配置 ExternalName 类型的 Service 前请确保：

已安装 kubectl 工具到本地。具体操作说明，请参见安装和设置 kubectl。

已通过 kubectl 连接目标集群。具体操作说明，请参见连接集群。

创建服务的 YAML 文件。示例文件external-service-demo.yaml代码如下：

apiVersion: v1
kind: Service
metadata:
name: external-service-demo # 服务的名称
namespace: default # 服务所属的命名空间
spec:
type: ExternalName # 服务类型固定为 ExternalName
externalName: volcengine.com # 需要映射的集群外部域名，必须是合法的 DNS 名称，不能填写 IP 地址

执行以下命令，创建服务。

kubectl apply -f external-service-demo.yaml

结果验证

查看服务

配置完成后，您可以在服务列表中查看已创建的服务。

访问服务

服务创建完成后，可以通过 Service 名称访问外部域名。可以在 Pod 内执行以下命令，验证域名解析和连通性。

预期解析结果中包含volcengine.com的 CNAME 记录，以及解析得到的真实 IP 地址，说明 ExternalName 映射已生效。

最近更新时间：2026.08.25 18:09:08

这个页面对您有帮助吗？

有用

无用