# Линтер Dockerfile (набор правил Hadolint)

Вставьте Dockerfile и получите статический анализ в стиле Hadolint без Docker-демона: теги базового образа, USER root, sudo, гигиена apt/apk/yum/dnf, фиксация версий npm/pip/yarn, ADD против COPY, склейка слоёв, pipefail, порты EXPOSE, секреты в ENV — 30+ правил по уровням серьёзности с номерами строк, причинами и примерами исправлений плюс построчно размеченный исходник.

> Каноническая страница: https://test.elysiatools.com/ru/tools/dockerfile-linter

- **Категория:** Development

- **Ключевые слова:** dockerfile, hadolint, линтер, практики docker, образ контейнера

## Обзор

Идентификаторы и серьёзность соответствуют исходникам Hadolint v2.15 (DL4000 MAINTAINER=error, DL3025 CMD в shell-форме=warning, отсутствующий HEALTHCHECK DL3057 по умолчанию игнорируется, включается опцией). Разбор уважает семантику Dockerfile: директива # escape=, склейка строк, BuildKit-хередоки (RUN <<EOF), JSON-форма, сброс состояния на каждом FROM многоэтапных сборок и подавление через # hadolint ignore=DLxxxx. Правила пакетных менеджеров работают по токенам команд (apt-get update без rm -rf /var/lib/apt/lists в той же RUN → DL3009 и т.п.); npm install без @version → DL3016; pip install без == и без --no-cache-dir → DL3013/DL3042. BP001 — расширение платформы: напоминание про .dockerignore при COPY . .

## Входные данные

- **Содержимое Dockerfile** (textarea): FROM node:20-alpine WORKDIR /app COPY . . RUN npm ci --omit=dev CMD \["node", "server.js"\]
- **Минимальная отображаемая серьёзность** (select)
- **Включить правило HEALTHCHECK (DL3057)** (checkbox)

## Когда использовать

- Перед сборкой образа, чтобы поймать :latest, USER root, sudo и незафиксированные пакеты.
- При ревью многоэтапных Dockerfile: сброс состояния на FROM, JSON-форму CMD и HEALTHCHECK.
- Когда нужно проверить гигиену apt/apk, ADD против COPY и секреты в ENV без запуска демона.

## Как это работает

- Вставьте текст Dockerfile в основное поле.
- Выберите минимальную отображаемую серьёзность (info, warning или error) и при необходимости включите правило HEALTHCHECK (DL3057).
- Разбор учитывает семантику Dockerfile: # escape=, склейку строк, BuildKit-хередоки, JSON-форму, многоэтапный сброс на FROM и # hadolint ignore=DLxxxx.
- На выходе — список находок с ID правил Hadolint v2.15, строками, объяснениями и примерами правок плюс аннотированный исходник.

## Сценарии использования

- Проверка production Dockerfile перед коммитом или CI на типичные антипаттерны.
- Ревью многоэтапной Node- или Python-сборки: не-root USER, JSON CMD и зафиксированные зависимости.
- Обучение практикам Docker: теги образов, склейка RUN, очистка кэша apt и отсутствие секретов в ENV.

## Частые вопросы

### Нужен ли Docker-демон?

Нет. Анализ полностью статический и не требует Docker.

### Какие правила проверяются?

Более 30 правил Hadolint v2.15: DL4000 MAINTAINER, теги образов, гигиена пакетных менеджеров, фиксация npm/pip/yarn, ADD против COPY, USER root, секреты в ENV, порты EXPOSE и другие, плюс напоминание BP001 про .dockerignore при COPY . .

### Как отключить отдельное правило?

Добавьте в Dockerfile комментарий # hadolint ignore=DLxxxx на нужной строке.

### Что делает опция HEALTHCHECK?

Включает правило DL3057 об отсутствии HEALTHCHECK. По умолчанию оно включено.

### Поддерживаются ли многоэтапные сборки?

Да. Состояние правил сбрасывается на каждом FROM.

## Связанные инструменты

- [Анализатор APNG: чанки IDAT/fdAT, повтор deflate и методы disposal с таймингом кадров](https://test.elysiatools.com/ru/tools/apng-idat-fdat-chunk-streaming-deflate-replay-and-disposal-method-analyzer): Загрузите PNG/APNG и разберите структуру анимации: подпись PNG и проверка CRC32 каждого чанка, IHDR (глубина/тип цвета/интерлейс), acTL (число кадров и повторов, обязан стоять до первого IDAT), fcTL (порядковый номер, ограничение области x+y+w+h ≤ холста, нормализация delay_num/delay_den, dispose_op none/background/previous, blend_op source/over), первый кадр IDAT + последующие через fdAT; общие номера fcTL+fdAT должны расти без пропусков с нуля; поток deflate каждого кадра воспроизводится с проверкой размера распаковки = высота × (1 + байтов на строку), повреждённый zlib фиксируется; симуляция disposal предупреждает о previous в первом кадре (трактуется как background), кадрах с нулевой задержкой и т. п.
- [Проверка цветовой визуальной доступности](https://test.elysiatools.com/ru/tools/color-vision-accessibility-checker): Измеряет контраст WCAG, моделирует основные нарушения цветового зрения и помечает слабоконтрастные зоны.
- [Линтер HTML для email](https://test.elysiatools.com/ru/tools/email-html-linter): Проверяет кросс-клиентную совместимость HTML-шаблонов email: неподдерживаемые flex/grid, не-инлайн CSS, ловушки рендеринга Word в Outlook, проблемы вёрстки таблицами и недостатки доступности. Покрывает ограничения Gmail/Outlook/Apple Mail.
- [Конструктор art direction для responsive Picture / srcset](https://test.elysiatools.com/ru/tools/responsive-picture-srcset-art-direction-builder): Генерирует полную разметку с art-direction-кропами: элементы на каждый брейкпоинт, кандидаты 1x/2x или w-дескрипторы по шаблону {w}, опциональные слои AVIF/WebP, работа с sizes, width/height против CLS, варианты HTML и JSX и lint-заметки по спецификации.
- [Инспектор бинарных заголовков Windows PE / Linux ELF / Mach-O (секции, импорт/экспорт)](https://test.elysiatools.com/ru/tools/windows-pe-linux-elf-mach-o-binary-header-section-import-export-inspector): Загрузите PE-COFF (.exe/.dll), ELF или Mach-O: разбор заголовков DOS/PE/COFF/optional, e_ident и таблиц ELF, заголовка и команд загрузки Mach-O; вывод — точка входа/база образа, таблица секций с отображением RVA↔смещение, импорт/экспорт, динамические символы и релокации, кросс-архитектурные аннотации (x86/x86-64/ARM/AArch64/RISC-V), значки ASLR/NX/PIE и hex-дамп начала файла.
- [Проверка доступности](https://test.elysiatools.com/ru/tools/accessibility-checker): Находит типовые проблемы WCAG 2.1 в HTML, страницах или макетах и возвращает рекомендации по исправлению
- [Аудитор зависимостей package.json](https://test.elysiatools.com/ru/tools/package-json-dependency-auditor): Проверяет package.json на гигиену зависимостей и качество диапазонов версий, а также при желании исследует транзитивное дерево из package-lock.json или yarn.lock. Отмечает дубликаты, wildcard/pre-release, неотсортированные ключи, отсутствующие метаданные и неверную классификацию runtime/dev зависимостей.
- [Синхронизатор палитры Tailwind](https://test.elysiatools.com/ru/tools/tailwind-color-palette-sync): Введите HEX, выберите схему именования (шкала 50–950 / одно имя / вложенность) — генерирует фрагмент theme.extend.colors для tailwind.config.ts с уровнями WCAG AA/AAA. Тёмная тема опциональна.

## Примеры

- [Примеры Обработки Изображений Android Java](https://test.elysiatools.com/ru/samples/android-image-processing-java): Примеры обработки изображений Android Java включая чтение/сохранение, масштабирование и преобразование формата
- [Примеры Обработки Изображений Android Kotlin](https://test.elysiatools.com/ru/samples/android-image-processing-kotlin): Примеры обработки изображений Android Kotlin включая чтение/сохранение, масштабирование и преобразование формата
- [Примеры Обработки Изображений Web Python](https://test.elysiatools.com/ru/samples/web-image-processing-python): Примеры обработки изображений Web Python используя PIL/Pillow включая чтение, сохранение, изменение размера и преобразование формата
- [Примеры Обработки Изображений Web Rust](https://test.elysiatools.com/ru/samples/web-image-processing-rust): Примеры обработки изображений Web Rust включая чтение/запись, масштабирование и преобразование форматов

## Связанные материалы

- [Проверка Dockerfile и окружения перед выпуском контейнера](https://test.elysiatools.com/ru/hubs/container-release-dockerfile-and-env-review): Проверьте правила Dockerfile, ссылки на образы, повторные ключи окружения и различия тестовой и рабочей конфигурации в проверяемом отчёте выпуска.
