admin 0.0.0.0:2019 позволяет любому, кто имеет доступ к порту 2019, заменить всю конфигурацию Caddy без пароля, а file_server без root раздаёт папку, в которой запущен Caddy, включая .git и .env. Этот навык находит эти и ещё десять ошибок конфигурации Caddy до перезагрузки или развёртывания и объясняет, как исправить каждую из них.

Ваш агент запускает сканер проекта: файлов с именем Caddyfile (также Caddyfile.prod и подобных), .caddyfile и .caddy, а также конфигураций Caddy JSON. Он читает синтаксис Caddyfile так же, как Caddy: блок глобальных настроек, сниппеты и import (включая другие файлы в папке, поэтому import sites/*.caddy прослеживается), несколько адресов одного сайта, один сайт без фигурных скобок, сопоставители, комментарии, строки в кавычках, heredoc и подстановки {env.*}. Он учитывает фактические настройки Caddy по умолчанию: API администрирования на localhost:2019, отсутствие защитных заголовков и HSTS, если вы их не добавили, скрытие активного Caddyfile от file_server, но не других файлов с точкой в начале имени. Минимальные Caddyfile из документации Caddy и Caddyfile по умолчанию из образа Docker проходят проверку без замечаний. Он никогда не запускает Caddy и не обращается к его API администрирования. Результат: BLOCK, REVIEW или NOT FLAGGED с указанием файла, строки, причины и более безопасного решения. Секреты никогда не выводятся.

Что проверяется

BLOCK (исправить до выпуска)

• C01: API администрирования на :2019, 0.0.0.0, IP-адресе локальной сети или имени хоста вместо localhost или сокета unix

• C02: tls_insecure_skip_verify для сервера за reverse_proxy и insecure_secrets_log

• C03: file_server для /, /etc, /var, домашней папки, папки .ssh или собственного хранилища сертификатов Caddy

• C04: токены DNS-провайдеров, ключи API, пароли, ключи EAB и заголовки Authorization, записанные в конфигурации

REVIEW (проверить до релиза)

• C11: tls internal, local_certs или тестовый центр сертификации ACME на публичном домене

• C12: публичные сайты http:// или :80, раздающие содержимое, и auto_https off

• C13: file_server без root или с root ., если ничто не скрывает .git и .env

• C14: CORS, копирующий любой Origin в Access-Control-Allow-Origin при разрешённой передаче учётных данных

• C15: публичный сайт без защитных заголовков, которые отправляют другие сайты в конфигурации

• C16: trusted_proxies со значением 0.0.0.0/0 или ::/0

• C17: log_credentials, записывающий cookie и заголовки Authorization в журнал доступа

• C18: protocols tls1.0 или tls1.1, которые Caddy v2 не поддерживает и отказывается загружать

Что входит в комплект

• Сканер (Python 3.9+, только стандартная библиотека)

• Руководство по правилам с обоснованием и более безопасным решением для каждого правила

• Небезопасный и безопасный примеры проекта (Caddyfile с импортируемыми файлами сайтов и конфигурация Caddy JSON), а также фактический отчёт сканера для небезопасного примера

Ограничения

Сканер читает файлы конфигурации в их исходном виде. Значения переменных окружения (CADDY_ADMIN, {env.*}), флаги командной строки, конфигурация, переданная через API администрирования, метки caddy-docker-proxy и импорт файлов за пределами сканируемой папки не проверяются. Заголовки, которые отправляет приложение за reverse_proxy, ему не видны. NOT FLAGGED не является гарантией.

Содержимое архива

Один ZIP-архив с 15 файлами: SKILL.md, сканер в scripts/ (4 файла Python), references/rules.md (все правила с обоснованием и более безопасным решением) и examples/ (8 файлов примеров и report.md, фактический отчёт сканера для небезопасного примера).

Как использовать: Это навык для агента: папка с файлом SKILL.md и скриптами Python, которые может запускать ИИ-агент для программирования, например Claude Code, Cursor или Codex CLI. Распакуйте архив в папку навыков вашего агента (для Claude Code: ~/.claude/skills/), затем попросите агента проверить проект. Скрипты также можно запускать отдельно с Python 3.9 или новее, без установки дополнительных зависимостей. Они только читают ваши файлы: доступ к сети не используется, данные никуда не отправляются.