# Linter de Dockerfile (regras Hadolint)

Cole um Dockerfile e receba análise estática estilo Hadolint sem daemon Docker: tags da imagem base, USER root, sudo, higiene de apt/apk/yum/dnf, fixação de versões npm/pip/yarn, ADD vs COPY, fusão de camadas, pipefail, portas EXPOSE, segredos em ENV — 30+ regras por severidade com linha, motivo e exemplo de correção, mais o código anotado linha a linha.

> Página canônica: https://test.elysiatools.com/pt/tools/dockerfile-linter

- **Categoria:** Development

- **Palavras-chave:** dockerfile, hadolint, linter, boas práticas docker, imagem de contêiner

## Visão geral

IDs e severidades seguem as fontes do Hadolint v2.15 (DL4000 MAINTAINER=error, DL3025 CMD em shell=warning, HEALTHCHECK ausente DL3057 ignorado por padrão, opcional). A análise respeita a semântica do Dockerfile: diretiva # escape=, continuações de linha, heredocs do BuildKit (RUN <<EOF), forma de array JSON, reset de estado a cada FROM de builds multi-stage e supressão via # hadolint ignore=DLxxxx. Regras de gerenciadores de pacotes operam por tokens de comando (apt-get update sem rm -rf /var/lib/apt/lists na mesma RUN → DL3009 etc.); npm install sem @version → DL3016; pip install sem == e sem --no-cache-dir → DL3013/DL3042. BP001 é extensão da plataforma: lembrete de .dockerignore ao fazer COPY . .

## Entradas

- **Conteúdo do Dockerfile** (textarea): FROM node:20-alpine WORKDIR /app COPY . . RUN npm ci --omit=dev CMD \["node", "server.js"\]
- **Severidade mínima exibida** (select)
- **Incluir regra HEALTHCHECK (DL3057)** (checkbox)

## Quando usar

- Antes de commitar ou publicar uma imagem, para detectar FROM :latest, MAINTAINER, USER root e CMD em forma de shell.
- Ao revisar builds multi-stage ou RUN com apt/npm/pip, para verificar limpeza de cache, versões fixadas e fusão de camadas.
- Quando quiser filtrar só erros ou avisos e opcionalmente incluir a regra de HEALTHCHECK (DL3057).

## Como funciona

- Cole o Dockerfile no campo principal (textarea). A análise interpreta diretiva # escape=, continuações de linha, heredocs do BuildKit, forma JSON de CMD/ENTRYPOINT, reset de estado a cada FROM e comentários # hadolint ignore=DLxxxx.
- Escolha a severidade mínima: todos os achados (info), somente avisos e erros, ou somente erros. Marque se deseja incluir a regra HEALTHCHECK (DL3057).
- O resultado HTML lista cada regra (IDs alinhados ao Hadolint v2.15) com linha, motivo e correção sugerida, além da vista do código anotada. BP001 lembra de .dockerignore em COPY . .

## Casos de uso

- Revisar um Dockerfile legado com FROM :latest, apt-get sem limpeza, ADD, ENV com senha e USER root.
- Validar um build Node multi-stage com npm ci, USER não-root, CMD em JSON e HEALTHCHECK antes do deploy.
- Checar higiene de pacotes (apt/apk/yum, pip/npm sem versão) e lembrar .dockerignore em COPY . .

## Perguntas frequentes

### Preciso ter o Docker ou o Hadolint instalados?

Não. A análise é estática e roda no navegador, sem daemon Docker.

### Quais regras são aplicadas?

Mais de 30 regras no estilo Hadolint v2.15 (DL4000 MAINTAINER=error, DL3025 CMD em shell=warning, DL3009 limpeza de apt, DL3016/DL3013 pin de npm/pip, etc.) mais a extensão BP001 para .dockerignore.

### Como filtrar os resultados?

Use o seletor de severidade mínima: info (todos), warning (avisos e erros) ou error (somente erros). A regra HEALTHCHECK (DL3057) é opcional.

### O linter entende builds multi-stage e heredocs?

Sim. O estado é reiniciado a cada FROM; continuações de linha, arrays JSON e heredocs do BuildKit (RUN <<EOF) são interpretados corretamente.

### Posso silenciar uma regra específica?

Sim, com o comentário # hadolint ignore=DLxxxx na linha correspondente, como no Hadolint original.

## Ferramentas relacionadas

- [Analisador APNG de chunks IDAT/fdAT, replay deflate e métodos de disposal com temporização de quadros](https://test.elysiatools.com/pt/tools/apng-idat-fdat-chunk-streaming-deflate-replay-and-disposal-method-analyzer): Envie um PNG/APNG e analise a estrutura da animação: assinatura PNG e verificação CRC32 por chunk, IHDR (profundidade/tipo de cor/entrelaçado), acTL (número de quadros e repetições, antes do primeiro IDAT), fcTL (número de sequência, restrição de região x+y+w+h ≤ canvas, normalização delay_num/delay_den, dispose_op none/background/previous, blend_op source/over), primeiro quadro IDAT + seguintes via fdAT; os números de sequência compartilhados fcTL+fdAT devem crescer sem lacunas a partir de 0; o fluxo deflate de cada quadro é reproduzido conferindo o tamanho descomprimido = altura × (1 + bytes por linha), zlib corrompido é relatado; a simulação de disposal alerta sobre previous no primeiro quadro (tratado como background), quadros com atraso zero etc.
- [Verificador de acessibilidade para visao de cores](https://test.elysiatools.com/pt/tools/color-vision-accessibility-checker): Mede contraste WCAG, simula deficiencias de visao de cor e destaca areas de baixo contraste em capturas.
- [Linter de HTML para Email](https://test.elysiatools.com/pt/tools/email-html-linter): Verifica a compatibilidade entre clientes de templates HTML de email: flex/grid não suportado, CSS não inline, armadilhas de renderização Word do Outlook, problemas de layout com tabelas e falta de acessibilidade. Cobre limitações de Gmail/Outlook/Apple Mail.
- [Construtor de art direction responsiva Picture / srcset](https://test.elysiatools.com/pt/tools/responsive-picture-srcset-art-direction-builder): Gera marcação completa com recortes de art direction: elementos por breakpoint, candidatas 1x/2x ou descritores de largura por modelo {w}, camadas AVIF/WebP opcionais, tratamento de sizes, width/height anti-CLS e sabores HTML e JSX com notas de lint baseadas na especificação.
- [Inspetor de cabeçalhos binários Windows PE / Linux ELF / Mach-O (seções, importações/exportações)](https://test.elysiatools.com/pt/tools/windows-pe-linux-elf-mach-o-binary-header-section-import-export-inspector): Envie um binário PE-COFF (.exe/.dll), ELF ou Mach-O: analisa cabeçalhos DOS/PE/COFF/opcional, o e_ident e tabelas do ELF e o cabeçalho e comandos de carga do Mach-O; exibe ponto de entrada/base da imagem, tabela de seções com mapeamento RVA↔offset, importações/exportações, símbolos dinâmicos e realocações, anotações multiarquitetura (x86/x86-64/ARM/AArch64/RISC-V), distintivos ASLR/NX/PIE e um dump hexadecimal inicial.
- [Verificador de acessibilidade](https://test.elysiatools.com/pt/tools/accessibility-checker): Detecta problemas comuns de WCAG 2.1 em HTML, paginas ou imagens de design e retorna orientacoes praticas
- [Auditor de dependências do package.json](https://test.elysiatools.com/pt/tools/package-json-dependency-auditor): Audita um package.json quanto à higiene de dependências e qualidade das faixas de versão, e opcionalmente inspeciona a árvore transitiva a partir de package-lock.json ou yarn.lock. Sinaliza duplicatas, wildcard ou pre-release, chaves desordenadas, metadados ausentes e dependências runtime/dev mal classificadas.
- [Sincronizador de paleta Tailwind](https://test.elysiatools.com/pt/tools/tailwind-color-palette-sync): Insira HEX, escolha o esquema de nomes (escala 50–950 / nome único / aninhamento) e gere o fragmento theme.extend.colors do tailwind.config.ts com níveis WCAG AA/AAA. Dark mode opcional.

## Exemplos

- [Exemplos de Processamento de Imagem Android Java](https://test.elysiatools.com/pt/samples/android-image-processing-java): Exemplos de processamento de imagem Android Java incluindo leitura/escrita, dimensionamento e conversão de formato
- [Exemplos de Processamento de Imagem Android Kotlin](https://test.elysiatools.com/pt/samples/android-image-processing-kotlin): Exemplos de processamento de imagem Android Kotlin incluindo leitura/escrita, dimensionamento e conversão de formato
- [Exemplos de Processamento de Imagem Web Python](https://test.elysiatools.com/pt/samples/web-image-processing-python): Exemplos de processamento de imagem Web Python usando PIL/Pillow incluindo leitura, salvamento, redimensionamento e conversão de formato
- [Exemplos de Processamento de Imagem Web Rust](https://test.elysiatools.com/pt/samples/web-image-processing-rust): Exemplos de processamento de imagem Web Rust incluindo leitura/gravação, redimensionamento e conversão de formato

## Conteúdo relacionado

- [Revisar Dockerfile e ambiente antes de publicar um contêiner](https://test.elysiatools.com/pt/hubs/container-release-dockerfile-and-env-review): Confira regras do Dockerfile, referências de imagem, chaves de ambiente duplicadas e diferenças entre homologação e produção em um registro verificável.
