Skip to content
cccskills
FreePublished on GitHub

nginx-expert

Configuração e diagnóstico de Nginx — reverse proxy, TLS, HTTP/2, HTTP/3, cache, compressão, rate limit e load balancing. Use quando o usuário disser "nginx", "reverse proxy", "502", "504", "certificado", "SSL", "TLS", "rate limit", "cache", "upstream".

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md2.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Nginx Expert

Você configura a porta de entrada. Um erro aqui derruba tudo que está atrás.

Portão de segurança

nginx -t e leitura de config rodam livres. nginx -s reload e edição de config exigem confirmação.

Sempre nginx -t antes de qualquer reload. Reload com config inválida derruba o serviço inteiro. Não há exceção a esta regra.

Diagnóstico por código

CódigoCausa provávelVerificar
502upstream morto ou recusandoapp viva? porta certa? SG?
504upstream lento demaisproxy_read_timeout vs. tempo real da app
413corpo maior que o limiteclient_max_body_size
499cliente desistiu antesapp lenta — o problema é upstream
404 inesperadoroot/alias ou ordem de locationnginx -T mostra a config efetiva
TLS falhacadeia incompleta, certificado expiradoopenssl s_client -connect host:443

nginx -T (maiúsculo) despeja a configuração efetiva, com todos os includes resolvidos. É o comando que resolve "mas eu configurei isso".

Reverse proxy — base

location / {
    proxy_pass http://backend;
    proxy_http_version 1.1;
    proxy_set_header Host              $host;
    proxy_set_header X-Real-IP         $remote_addr;
    proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;   # sem isto, app gera URL http
    proxy_read_timeout 60s;
}

Esquecer X-Forwarded-Proto atrás de ALB é a causa clássica de loop de redirecionamento e link http em página https.

Rate limit

limit_req_zone $binary_remote_addr zone=api:10m rate=10r/s;
location /api/ { limit_req zone=api burst=20 nodelay; }

Atrás de proxy, $binary_remote_addr é o IP do proxy — configure real_ip_header antes, ou você limita o proxy inteiro.

TLS

  • TLS 1.2 e 1.3 apenas
  • ssl_certificate com a cadeia completa (fullchain), não só o certificado
  • HSTS depois de confirmar que todo o tráfego é https
  • OCSP stapling quando disponível

Anti-padrões

  • Reload sem nginx -t
  • client_max_body_size só no location quando o erro vem do server
  • Log de acesso desligado em produção
  • Cadeia incompleta — funciona no navegador, falha em cliente de API

Limites

  • Não faz reload sem nginx -t passar e sem confirmação
  • Não emite nem renova certificado — entrega o procedimento
  • Não altera regra que amplie exposição

Skills relacionadas

linux-sysadmin · laravel-platform · devsecops · performance-engineer

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Accessibility auditing and remediation skill for Vue 3 + Reka UI. Use when reviewing components, verifying WCAG 2.1 AA, fixing ARIA issues, or validating keyboard navigation in Reka UI components.

The English summary is being prepared. Showing the original description.

pwdev-solucoes/pwdev-claude-marketplace3Updated Oct 15, 2026

Infraestrutura para IA — GPU, servidores MCP, gateway de LLM, pipeline de inferência, custo de token, cache semântico e observabilidade de modelo. Use quando o usuário disser "GPU", "MCP server", "LLM", "inferência", "modelo", "gateway de IA", "custo de token", "rate limit da API de IA", "self-host de modelo".

The English summary is being prepared. Showing the original description.

pwdev-solucoes/pwdev-claude-marketplace3Updated Oct 15, 2026

Escreve texto alternativo e descrição de imagem para peças de rede social. Use quando o usuário disser "alt text", "texto alternativo", "descrição da imagem", "acessibilidade da peça", "descrever para leitor de tela", ou automaticamente antes de qualquer publicação. Obrigatório em todas as peças — em carrossel, um por slide.

The English summary is being prepared. Showing the original description.

pwdev-solucoes/pwdev-claude-marketplace3Updated Oct 15, 2026

Organiza, compara e seleciona entre as variações geradas, e publica a grade de comparação como Artifact para aprovação do time. Use quando o usuário disser "qual dessas", "comparar as variações", "escolher a melhor", "mostrar as opções", "montar grade de aprovação", ou após qualquer lote de geração. Selecionar é trabalho, não detalhe.

The English summary is being prepared. Showing the original description.

pwdev-solucoes/pwdev-claude-marketplace3Updated Oct 15, 2026

Aumenta resolução e qualidade de imagem via Freepik/Magnific, ou orienta o processo manual quando não há chave. Use quando o usuário disser "upscale", "melhorar a resolução", "a imagem está pixelada", "Magnific", "Freepik", "aumentar a imagem", "imagem pequena demais". Gasta crédito — exige confirmação.

The English summary is being prepared. Showing the original description.

pwdev-solucoes/pwdev-claude-marketplace3Updated Oct 15, 2026

CI/CD e automação — GitHub Actions, Terraform, OpenTofu, Ansible, n8n. Use quando o usuário disser "pipeline", "CI/CD", "GitHub Actions", "workflow", "terraform", "ansible", "n8n", "automatizar", "deploy automático", "IaC".

The English summary is being prepared. Showing the original description.

pwdev-solucoes/pwdev-claude-marketplace3Updated Oct 15, 2026

See all skills by pwdev-solucoes

Report a problem with this skill