Proxy reverso Nginx baseado em Docker que gera automaticamente configurações de roteamento a partir das variáveis VIRTUAL_HOST dos containers em execução.
nginx/kubernetes-ingress
Um Ingress Controller para Kubernetes que usa NGINX ou NGINX Plus para direcionar tráfego HTTP, gRPC, TCP e UDP externo aos serviços do cluster.
- Estrelas
- 5,094
- Forks
- 2,056
- Issues abertas
- 190
- Último commit
- há 3 horas
O que é?
O NGINX Ingress Controller é um componente do Kubernetes que configura um balanceador de carga NGINX ou NGINX Plus de acordo com os recursos Ingress do cluster. Ele faz o roteamento com base no conteúdo, usando host e caminho, e encerra conexões TLS/SSL para cada hostname, permitindo que aplicações dentro do cluster sejam acessadas externamente.
Além do Ingress padrão, o controller disponibiliza recursos do NGINX por meio de annotations e configurações do ConfigMap. Ele também oferece os próprios recursos VirtualServer e VirtualServerRoute para casos como divisão de tráfego, além do recurso TransportServer para TCP, UDP e TLS passthrough. Além de HTTP, há suporte a aplicações WebSocket, gRPC, TCP e UDP.
O projeto é mantido pela NGINX (F5). A instalação pode ser feita por meio de um Helm chart ou de manifests do Kubernetes, e há imagens disponíveis tanto para NGINX quanto para NGINX Plus. Este projeto é diferente do controller kubernetes/ingress-nginx.
Recursos principais
- 01Roteamento de tráfego HTTP com base no host e no caminho.
- 02Encerramento de conexões TLS/SSL para cada hostname.
- 03Balanceamento de carga para aplicações HTTP, WebSocket, gRPC, TCP e UDP.
- 04Recursos VirtualServer para divisão de tráfego e roteamento avançado.
- 05TLS passthrough por meio de recursos TransportServer.
- 06Compatível com NGINX open source e NGINX Plus.
Casos de uso
- Disponibilizar aplicações web executadas em um cluster Kubernetes para clientes externos.
- Encerrar certificados TLS de vários serviços em um único ponto de entrada.
- Dividir o tráfego entre versões de uma aplicação durante uma implantação gradual.
- Balancear a carga de serviços gRPC ou TCP em um ambiente Kubernetes.
Início rápido
- 1
Instale o controller com o Helm chart ou os manifests do Kubernetes vinculados no README
- 2
Configure o balanceamento de carga de um app de exemplo usando o exemplo Cafe ou o exemplo de configuração básica do VirtualServer
Antes de usar
- Ele é executado somente em clusters Kubernetes.
- Alguns recursos exigem o NGINX Plus, um produto comercial coberto por um contrato de suporte.
- É um projeto diferente do NGINX Ingress Controller do kubernetes/ingress-nginx.
Em coleções
Tópicos
Perguntas frequentes
- O que é kubernetes-ingress?
- Um Ingress Controller para Kubernetes que usa NGINX ou NGINX Plus para direcionar tráfego HTTP, gRPC, TCP e UDP externo aos serviços do cluster. O NGINX Ingress Controller é um componente do Kubernetes que configura um balanceador de carga NGINX ou NGINX Plus de acordo com os recursos Ingress do cluster. Ele faz o roteamento com base no conteúdo, usando host e caminho, e encerra conexões TLS/SSL para cada hostname, permitindo que aplicações dentro do cluster sejam acessadas externamente.
- kubernetes-ingress é gratuito? Qual é a licença?
- kubernetes-ingress é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
- kubernetes-ingress ainda é mantido?
- Manutenção ativa. O último commit de kubernetes-ingress foi em 6 de nov. de 2026.
- Para que posso usar kubernetes-ingress?
- Disponibilizar aplicações web executadas em um cluster Kubernetes para clientes externos. Encerrar certificados TLS de vários serviços em um único ponto de entrada. Dividir o tráfego entre versões de uma aplicação durante uma implantação gradual. Balancear a carga de serviços gRPC ou TCP em um ambiente Kubernetes.
- Como instalar kubernetes-ingress?
- Instale o controller com o Helm chart ou os manifests do Kubernetes vinculados no README Configure o balanceamento de carga de um app de exemplo usando o exemplo Cafe ou o exemplo de configuração básica do VirtualServer
- Onde consigo kubernetes-ingress?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/nginx/kubernetes-ingress
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Interface gráfica baseada na web para nginx que permite gerenciar virtual hosts, proxies, certificados SSL e streams sem editar arquivos de configuração manualmente.
Proxy reverso HTTP e ferramenta de encaminhamento de uso geral, com interface web de gerenciamento, escritos em Go para homelabs e servidores pequenos.
Firewall de Aplicação Web open source e cloud-native, baseado em NGINX, que atua como proxy reverso na frente dos seus serviços web.
Gateway de API dinâmico e de alto desempenho, baseado em NGINX e etcd, com plugins para roteamento, autenticação, limitação de taxa e tráfego de IA/LLM.
Servidor web e proxy reverso de alta performance, criado no Taobao e 100% compatível com nginx, com suporte a HTTP/3, Kubernetes Ingress e SM2/TLCP.