projectcontour/contour

注意：新的Contour版本镜像不再推送到此仓库。此仓库仅为向后兼容而保留。新镜像可在https://github.com/projectcontour/contour/pkgs/container/contour%E6%89%BE%E5%88%B0%E3%80%82

!https://github.com/projectcontour/contour/workflows/Build%20and%20Test%20Pull%20Request/badge.svg https://goreportcard.com/badge/github.com/projectcontour/contour](https://goreportcard.com/report/github.com/projectcontour/contour) !GitHub release ![License]([] ![Slack]([] ![CII Best Practices]([***]

!https://github.com/projectcontour/contour/raw/main/contour.png

概述

Contour是一个Kubernetes入口控制器，通过部署Envoy代理作为反向代理和负载均衡器工作。Contour默认支持动态配置更新，同时保持轻量级特性。

Contour还引入了新的入口API（HTTPProxy），通过自定义资源定义（CRD）实现。其目标是扩展Ingress API的功能，提供更丰富的用户体验，并解决原始设计中的不足。

更多信息请参见https://github.com/projectcontour/contour%E3%80%82

核心功能和特性

• 基于Envoy代理：使用Envoy作为底层反向代理和负载均衡器，提供高性能和可靠性
• 动态配置更新：支持配置的实时更新，无需重启服务
• 轻量级设计：保持低资源占用，适合各种规模的Kubernetes集群
• HTTPProxy CRD：通过自定义资源定义扩展Ingress API，提供更丰富的路由规则和功能
• 向后兼容：支持标准Kubernetes Ingress资源，便于现有应用迁移

使用场景和适用范围

Contour适用于需要在Kubernetes集群中管理入口流量的场景，包括：

• 为集群内服务提供外部访问入口
• 实现HTTP/HTTPS路由、负载均衡和反向代理
• 需要动态更新路由配置的微服务架构
• 希望扩展标准Ingress API功能的用户，如路径重写、请求头修改、TLS配置等

使用方法和配置说明

部署方式

Contour通常在Kubernetes集群中部署，推荐使用官方提供的部署清单或Helm Chart。

使用kubectl部署

bash
kubectl apply -f https://projectcontour.io/quickstart/contour.yaml

使用Helm部署

bash
helm repo add contour https://projectcontour.github.io/contour
helm install contour contour/contour --namespace projectcontour --create-namespace

容器运行参数

Contour容器支持以下主要运行参数（具体可通过contour --help查看）：

• --config-path：指定配置文件路径
• --incluster：使用集群内配置（默认启用）
• --kubeconfig：指定kubeconfig文件路径（集群外使用）
• --metrics-addr：指标暴露地址（默认:8000）

配置示例

HTTPProxy资源示例

yaml
apiVersion: projectcontour.io/v1
kind: HTTPProxy
metadata:
  name: example
  namespace: default
spec:
  virtualhost:
    fqdn: www.example.com
  routes:
    - conditions:
        - prefix: /
      services:
        - name: webapp
          port: 80

注意事项

• 此仓库镜像仅用于向后兼容，建议新部署使用https://github.com/projectcontour/contour/pkgs/container/contour
• 详细配置和高级功能请参考官方文档