容器服务
容器服务
容器服务
文档指南
请输入
容器服务 VKE
产品动态
Kubernetes 版本发布记录
组件发布记录
监控组件
DNS 组件
GPU 组件
Sandbox 组件
安全公告
产品公告
历史公告
用户指南
集群
节点池
授权
网络
容器网络
服务（Service）
路由（Ingress）
APIG Ingress
ALB Ingress
自定义转发规则配置示例
CLB Ingress
Nginx Ingress
Gateway API
工作负载
存储
数据管理中心（DMC）
对象存储（TOS）
FSX 访问方式
文件存储（NAS）
FSX 访问方式
弹性文件存储（EFS）
文件存储（vePFS）
FSX 访问方式
vePFS Client 访问方式
NFS 访问方式
大数据文件存储（CloudFS）
弹性伸缩
工作负载弹性伸缩
事件驱动伸缩（KEDA）
组件管理
网络组件
监控组件
DNS 组件
GPU 组件
Sandbox 组件
异构计算
调度管理
可观测性
基础观测
诊断与巡检
最佳实践
网络
可观测性
安全合规
API 参考
集群管理
节点池管理
组件管理
机型镜像管理
云原生观测
巡检诊断
弹性容器实例
附录
开发指南
常见问题
通用 FAQ
集群 FAQ
集群管理
集群升级
节点与节点池 FAQ
授权 FAQ
工作负载 FAQ
服务与路由 FAQ
存储 FAQ
弹性伸缩 FAQ
可观测性 FAQ
配额 FAQ
组件 FAQ
容器镜像 FAQ
AI 云原生
推理套件
Helm 模板 AI 应用
Deepseek 实践
Qwen 实践
最佳实践
MiniMax 模型部署
Qwen 模型部署
弹性容器实例 VCI
最新动态
用户指南
虚拟节点
VKE 集群使用虚拟节点
自建/跨云集群使用虚拟节点
创建 VCI 实例
VCI Agent Sandbox
安全合规
- 文档首页
容器服务容器服务 VKE用户指南网络路由（Ingress）Nginx IngressNginx Ingress 配置重定向规则
复制全文
下载 pdfNginx Ingress 配置重定向规则
文档反馈
问问助手Nginx Ingress 支持重定向功能，包括永久重定向和临时重定向，也支持将 HTTP 重定向为 HTTPS。本文为您介绍如何配置 Nginx Ingress 重定向功能。
注意
前提条件
- 已连接集群。详情请参见 连接集群。
- 已安装 ingress-nginx 组件。详情请参见 安装组件。
配置永久重定向
Nginx Ingress 支持通过 Annotation 配置永久重定向，示例和说明如下：
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: nginx-ingress # 路由规则的名称
annotations:
nginx.ingress.kubernetes.io/permanent-redirect: "https://www.volcengine.com" # 重定向到指定的目标网站
spec:
ingressClassName: nginx # 指定 Ingress Controller
rules:
- host: example.com # 转发规则域名
http:
paths:
- backend:
service:
name: service-demo # 请求被转发到的目标服务名称
port:
number: 80 # 请求被转发到的目标服务开放端口号
path: / # 访问路径
pathType: Prefix # 路径类型：Exact（精确匹配）/Prefix（前缀匹配）
Annotation 说明如下表所示。
字段 | 类型 | 是否必须 | 描述 | 默认值 |
字段 | 类型 | 是否必须 | 描述 | 默认值 |
nginx.ingress.kubernetes.io/permanent-redirect | String | 是 | 重定向的目标网站地址。 | 无 |
说明
默认情况下，永久重定向的返回状态码为301。
配置永久重定向返回状态码
Nginx Ingress 支持通过 Annotation 配置永久重定向并指定返回状态码，示例和说明如下：
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: nginx-ingress # 路由规则的名称
annotations:
nginx.ingress.kubernetes.io/permanent-redirect: "https://www.volcengine.com" # 重定向到指定的目标网站
nginx.ingress.kubernetes.io/permanent-redirect-code: "308" # 重定向返回状态码
spec:
ingressClassName: nginx # 指定 Ingress Controller
rules:
- host: example.com # 转发规则域名
http:
paths:
- backend:
service:
name: service-demo # 请求被转发到的目标服务名称
port:
number: 80 # 请求被转发到的目标服务开放端口号
path: / # 访问路径
pathType: Prefix # 路径类型：Exact（精确匹配）/Prefix（前缀匹配）
Annotation 说明如下表所示。
字段 | 类型 | 是否必须 | 描述 | 默认值 |
字段 | 类型 | 是否必须 | 描述 | 默认值 |
nginx.ingress.kubernetes.io/permanent-redirect | String | 是 | 重定向到指定的网站。 | 无 |
nginx.ingress.kubernetes.io/permanent-redirect-code | String | 是 | 指定重定向返回状态码。取值：301或308。 | 无 |
配置临时重定向
Nginx Ingress 支持通过 Annotation 配置临时重定向，示例和说明如下：
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: nginx-ingress # 路由规则的名称
annotations:
nginx.ingress.kubernetes.io/temporal-redirect: "https://www.volcengine.com" # 重定向到指定的目标网站
spec:
ingressClassName: nginx # 指定 Ingress Controller
rules:
- host: example.com # 转发规则域名
http:
paths:
- backend:
service:
name: service-demo # 请求被转发到的目标服务名称
port:
number: 80 # 请求被转发到的目标服务开放端口号
path: / # 访问路径
pathType: Prefix # 路径类型：Exact（精确匹配）/Prefix（前缀匹配）
Annotation 说明如下表所示。
字段 | 类型 | 是否必须 | 描述 | 默认值 |
字段 | 类型 | 是否必须 | 描述 | 默认值 |
nginx.ingress.kubernetes.io/temporal-redirect | String | 是 | 重定向到指定的网站。 | 无 |
配置 HTTP 重定向到 HTTPS
Nginx Ingress 支持通过 Annotation 配置 HTTP 重定向到 HTTPS，示例和说明如下：
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: nginx-ingress # 路由规则的名称
annotations:
nginx.ingress.kubernetes.io/ssl-redirect: "true" # 开启 HTTP 重定向到 HTTPS
spec:
ingressClassName: nginx # 指定 Ingress Controller
rules:
- host: example.com # 转发规则域名
http:
paths:
- backend:
service:
name: service-demo # 请求被转发到的目标服务名称
port:
number: 80 # 请求被转发到的目标服务开放端口号
path: / # 访问路径
pathType: Prefix # 路径类型：Exact（精确匹配）/Prefix（前缀匹配）
Annotation 说明如下表所示。
字段 | 类型 | 是否必须 | 描述 | 默认值 |
字段 | 类型 | 是否必须 | 描述 | 默认值 |
nginx.ingress.kubernetes.io/ssl-redirect | Boolean | 是 | 是否将 HTTP 请求重定向至 HTTPS。取值：
| 无 |
结果验证
以永久重定向为例，使用以下命令访问服务。其中180.xxx.xxx.xxx为 Nginx Ingress 对应 CLB 的公网或私网 IP 地址。
curl -H "Host: example.com" http://180.xxx.xxx.xxx -I -k
预期输出如下，可以看到重定向信息。
HTTP/1.1 301 Moved Permanently
Date: Thu, 07 Dec 2023 06:56:48 GMT
Content-Type: text/html
Content-Length: 162
Connection: keep-alive
Location: https://www.volcengine.com
最近更新时间：2026.04.07 14:29:43
这个页面对您有帮助吗？
有用
有用
无用
无用