Caddy — Cheatsheet

If you like this project, consider supporting me on Buy Me a Coffee ☕️

🔒 Caddy — Web Server Cheatsheet

Description

Caddy is a modern, open-source web server written in Go, known for automatic HTTPS via Let's Encrypt and ZeroSSL. Created by Matt Holt in 2015, Caddy provisions and renews TLS certificates by default with zero configuration, making it the simplest production-ready web server for HTTPS deployments.

Common use cases / Типичные сценарии:

• Automatic HTTPS reverse proxy / Автоматический HTTPS обратный прокси
• Static file serving with zero-config TLS / Раздача статики с автоматическим TLS
• Load balancing (HTTP, TCP) / Балансировка нагрузки
• API gateway / API-шлюз
• Local development server (self-signed certs) / Локальный сервер разработки
• File server with directory browsing / Файловый сервер с просмотром каталогов

[!NOTE] Caddy is gaining rapid adoption due to its automatic HTTPS and simple configuration (Caddyfile). It supports both a human-readable Caddyfile syntax and a JSON-based configuration API. Caddy v2 (current) is a complete rewrite of v1. Alternatives include Nginx (most widely deployed, manual cert management), HAProxy (high-performance L4/L7 LB), and Traefik (auto-discovery, cloud-native). Caddy быстро набирает популярность благодаря автоматическому HTTPS и простой конфигурации. Поддерживает Caddyfile и JSON API. Caddy v2 — полная переработка v1. Альтернативы: Nginx, HAProxy, Traefik.

Installation & Configuration

Package Installation / Установка пакетов

Debian / Ubuntu (Official Repo)

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl  # Prerequisites / Зависимости
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg  # Add GPG key / Добавить GPG ключ
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list  # Add repo / Добавить репозиторий
sudo apt update && sudo apt install caddy  # Install Caddy / Установить Caddy

RHEL / CentOS / Fedora

dnf install -y 'dnf-command(copr)'                       # Install copr plugin / Установить плагин copr
dnf copr enable @caddy/caddy                              # Enable Caddy repo / Включить репозиторий
dnf install caddy                                         # Install Caddy / Установить Caddy

Arch Linux

sudo pacman -S caddy                                      # Install from community / Установить из community

Binary / Go Install (Any OS)

# Download static binary / Скачать статический бинарник
curl -o /usr/local/bin/caddy "https://caddyserver.com/api/download?os=linux&arch=amd64"
chmod +x /usr/local/bin/caddy                             # Make executable / Сделать исполняемым

# Or install via Go / Или установить через Go
go install github.com/caddyserver/caddy/v2/cmd/caddy@latest

Docker

docker run -d --name caddy \
  -p 80:80 -p 443:443 -p 443:443/udp \
  -v caddy_data:/data \
  -v caddy_config:/config \
  -v $PWD/Caddyfile:/etc/caddy/Caddyfile \
  caddy:latest                                            # Run Caddy in Docker / Запуск в Docker

Default Paths / Пути по умолчанию

Main config / Основной конфиг: /etc/caddy/Caddyfile

Data directory (certs, etc.) / Каталог данных (сертификаты и др.): /var/lib/caddy/.local/share/caddy/ (systemd) ~/.local/share/caddy/ (manual run)

Config directory / Каталог конфигурации: /var/lib/caddy/.config/caddy/ (systemd) ~/.config/caddy/ (manual run)

Logs directory / Директория логов: /var/log/caddy/ (if configured)

Binary location / Расположение бинарника: /usr/bin/caddy

Default Ports / Порты по умолчанию

[!TIP] Caddy listens on port 2019 for the admin API by default. This is accessible only from localhost. You can use it to manage configuration dynamically without restarts. Caddy по умолчанию слушает порт 2019 для admin API. Доступен только с localhost. Через него можно управлять конфигурацией без перезапуска.

Core Management

Service Control / Управление сервисом

sudo systemctl start caddy                               # Start service / Запустить сервис
sudo systemctl stop caddy                                 # Stop service / Остановить сервис
sudo systemctl restart caddy                              # Restart service / Перезапустить сервис
sudo systemctl reload caddy                               # Reload config (graceful) / Перечитать конфиг (без простоя)
sudo systemctl status caddy                               # Service status / Статус сервиса
sudo systemctl enable caddy                               # Enable at boot / Автозапуск

CLI Commands / Команды CLI

caddy version                                             # Show version / Показать версию
caddy list-modules                                        # List loaded modules / Список модулей
caddy environ                                             # Show environment / Показать окружение
caddy build-info                                          # Build info / Информация о сборке

Configuration Management / Управление конфигурацией

caddy validate --config /etc/caddy/Caddyfile              # Validate Caddyfile / Проверить конфиг
caddy adapt --config /etc/caddy/Caddyfile                 # Convert Caddyfile to JSON / Конвертировать в JSON
caddy fmt --overwrite /etc/caddy/Caddyfile                # Format Caddyfile / Отформатировать конфиг
caddy reload --config /etc/caddy/Caddyfile                # Live reload / Перезагрузить конфиг на лету

Admin API / Админ API

# Check current config / Проверить текущую конфигурацию
curl localhost:2019/config/ | jq .

# Load new config / Загрузить новую конфигурацию
curl -X POST localhost:2019/load \
  -H "Content-Type: application/json" \
  -d @caddy.json

# Stop Caddy via API / Остановить Caddy через API
curl -X POST localhost:2019/stop

Run Without systemd / Запуск без systemd

caddy run --config /etc/caddy/Caddyfile                   # Run in foreground / Запуск на переднем плане
caddy start --config /etc/caddy/Caddyfile                 # Run as daemon / Запуск как демон
caddy stop                                                # Stop daemon / Остановить демон

Caddyfile Basics

Caddyfile Structure / Структура Caddyfile

Caddy's native config format uses a simple, human-readable syntax. Нативный формат конфигурации Caddy — простой, человекочитаемый синтаксис.

# Global options / Глобальные настройки
{
    email [email protected]                               # ACME account email / Email для ACME
    admin off                                             # Disable admin API / Отключить admin API
}

# Site block / Блок сайта
example.com {
    respond "Hello, World!"                               # Simple response / Простой ответ
}

Key Concepts / Ключевые концепции

Reverse Proxy

Basic Reverse Proxy / Базовый обратный прокси

/etc/caddy/Caddyfile

example.com {
    reverse_proxy localhost:3000                           # Proxy to backend / Проксировать на бэкенд
}

[!TIP] With just these 3 lines, Caddy will: obtain and auto-renew a TLS certificate, redirect HTTP→HTTPS, proxy all traffic to port 3000, and set proper X-Forwarded-For headers. No additional configuration needed. Всего 3 строки, и Caddy: получит и обновит TLS сертификат, перенаправит HTTP→HTTPS, проксирует трафик на порт 3000 и выставит правильные заголовки X-Forwarded-For.

Reverse Proxy with Headers / Обратный прокси с заголовками

/etc/caddy/Caddyfile

example.com {
    reverse_proxy localhost:3000 {
        header_up Host {upstream_hostport}                 # Preserve upstream host / Сохранить хост upstream
        header_up X-Real-IP {remote_host}                  # Client IP / IP клиента
        header_up X-Forwarded-Proto {scheme}               # HTTP/HTTPS scheme / Схема протокола
    }
}

Multiple Backends / Несколько бэкендов

/etc/caddy/Caddyfile

example.com {
    reverse_proxy <IP1>:8080 <IP2>:8080 <IP3>:8080        # Multiple upstreams / Несколько upstream
}

Path-Based Routing / Маршрутизация по пути

/etc/caddy/Caddyfile

example.com {
    reverse_proxy /api/* <IP1>:8080                        # API backend / API бэкенд
    reverse_proxy /ws/*  <IP2>:9000                        # WebSocket backend / WebSocket бэкенд
    reverse_proxy /*     <IP3>:3000                        # Default backend / Бэкенд по умолчанию
}

Host-Based Routing / Маршрутизация по домену

/etc/caddy/Caddyfile

api.example.com {
    reverse_proxy <IP1>:8080                               # API service
}

app.example.com {
    reverse_proxy <IP2>:3000                               # App service
}

admin.example.com {
    reverse_proxy <IP3>:8443                               # Admin panel
}

WebSocket Proxy / WebSocket прокси

/etc/caddy/Caddyfile

example.com {
    reverse_proxy /ws/* <IP>:9000                          # Auto WebSocket support / Автоподдержка WebSocket
}

[!NOTE] Caddy automatically handles WebSocket upgrade headers — no special configuration needed (unlike Nginx). Caddy автоматически обрабатывает WebSocket заголовки — никакой дополнительной настройки не требуется (в отличие от Nginx).

Load Balancing

Load Balancing Algorithms / Алгоритмы балансировки

Load Balancing Configuration / Конфигурация балансировки

/etc/caddy/Caddyfile

example.com {
    reverse_proxy <IP1>:8080 <IP2>:8080 <IP3>:8080 {
        lb_policy round_robin                              # Round Robin algorithm / Алгоритм Round Robin
    }
}

Least Connections / Минимум соединений

/etc/caddy/Caddyfile

example.com {
    reverse_proxy <IP1>:8080 <IP2>:8080 {
        lb_policy least_conn                               # Least connections / Минимум соединений
    }
}

Cookie-Based Persistence / Привязка по cookie

/etc/caddy/Caddyfile

example.com {
    reverse_proxy <IP1>:8080 <IP2>:8080 {
        lb_policy cookie                                   # Cookie-based sticky sessions / Липкие сессии по cookie
    }
}

Health Checks / Проверки здоровья

/etc/caddy/Caddyfile

example.com {
    reverse_proxy <IP1>:8080 <IP2>:8080 {
        lb_policy round_robin

        # Active health checks / Активные проверки здоровья
        health_uri /healthz                                # Check endpoint / Эндпоинт проверки
        health_interval 10s                                # Interval / Интервал
        health_timeout 5s                                  # Timeout / Таймаут
        health_status 200                                  # Expected status / Ожидаемый статус

        # Passive health checks / Пассивные проверки здоровья
        fail_duration 30s                                  # Mark down after failures / Пометить недоступным
        max_fails 3                                        # Max failures / Максимум ошибок
        unhealthy_latency 5s                               # Latency threshold / Порог задержки
    }
}

[!NOTE] Caddy supports both active and passive health checks in the open-source edition (unlike Nginx which requires Nginx Plus for active checks). Caddy поддерживает и активные, и пассивные проверки здоровья в open-source версии (в отличие от Nginx, где активные проверки — только в Nginx Plus).

HTTPS & TLS

Automatic HTTPS (Default) / Автоматический HTTPS

example.com {
    respond "Secure by default!"                           # HTTPS is automatic / HTTPS автоматический
}

[!IMPORTANT] Caddy obtains and renews TLS certificates automatically using Let's Encrypt or ZeroSSL. No manual certbot commands needed. Requirements: port 80 and 443 accessible, valid DNS pointing to your server. Caddy получает и обновляет TLS-сертификаты автоматически через Let's Encrypt или ZeroSSL. Никаких ручных команд certbot. Требования: порты 80 и 443 доступны, DNS указывает на ваш сервер.

Custom TLS / Пользовательский TLS

/etc/caddy/Caddyfile

example.com {
    tls /path/to/cert.pem /path/to/key.pem                # Custom certificate / Пользовательский сертификат
    reverse_proxy localhost:3000
}

Self-Signed (Local Dev) / Самоподписанный (Локальная разработка)

localhost {
    tls internal                                           # Self-signed cert / Самоподписанный сертификат
    reverse_proxy localhost:3000
}

ACME Configuration / Конфигурация ACME

/etc/caddy/Caddyfile

{
    email [email protected]                                # ACME email / Email для ACME
    acme_ca https://acme-v02.api.letsencrypt.org/directory # Let's Encrypt (default) / По умолчанию
    # acme_ca https://acme.zerossl.com/v2/DV90             # ZeroSSL alternative / Альтернатива ZeroSSL
}

DNS Challenge (Wildcard Certs) / DNS Challenge (Wildcard)

/etc/caddy/Caddyfile

*.example.com {
    tls {
        dns cloudflare {env.CF_API_TOKEN}                  # DNS provider plugin / DNS провайдер
    }
    reverse_proxy localhost:3000
}

[!TIP] Wildcard certificates require the DNS challenge. You need to install the Caddy DNS provider plugin (e.g., caddy-dns/cloudflare) and rebuild Caddy with xcaddy. Wildcard-сертификаты требуют DNS challenge. Нужно установить плагин DNS провайдера и пересобрать Caddy с xcaddy.

TLS Protocols & Ciphers / TLS протоколы и шифры

/etc/caddy/Caddyfile

example.com {
    tls {
        protocols tls1.2 tls1.3                            # Allowed TLS versions / Разрешённые версии TLS
        ciphers TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
    }
}

On-Demand TLS / TLS по запросу

/etc/caddy/Caddyfile

{
    on_demand_tls {
        ask http://localhost:5555/check                     # Verify domain before issuing / Проверить домен перед выпуском
    }
}

https:// {
    tls {
        on_demand                                          # Issue cert on first request / Выпуск сертификата по требованию
    }
    reverse_proxy localhost:3000
}

[!WARNING] On-demand TLS should always have an ask endpoint to prevent abuse. Without it, anyone could trigger certificate issuance for any domain. On-demand TLS всегда должен иметь ask эндпоинт для предотвращения злоупотреблений. Без него кто угодно может запросить сертификат для любого домена.

Static Files & File Server

Basic File Server / Базовый файловый сервер

/etc/caddy/Caddyfile

example.com {
    root * /var/www/html                                   # Document root / Корневая директория
    file_server                                            # Enable file serving / Включить раздачу файлов
}

File Server with Directory Browsing / Файловый сервер с просмотром каталогов

/etc/caddy/Caddyfile

example.com {
    root * /var/www/html
    file_server browse                                     # Directory listing / Листинг каталогов
}

SPA (Single Page Application) / SPA

/etc/caddy/Caddyfile

example.com {
    root * /var/www/app
    try_files {path} /index.html                           # SPA fallback / Фолбэк для SPA
    file_server
}

Compression / Сжатие

/etc/caddy/Caddyfile

example.com {
    encode gzip zstd                                       # Enable compression / Включить сжатие (gzip + zstd)
    root * /var/www/html
    file_server
}

Security & Access Control

Basic Authentication / Базовая аутентификация

# Generate password hash / Сгенерировать хеш пароля
caddy hash-password                                        # Interactive prompt / Интерактивный ввод
caddy hash-password --plaintext '<PASSWORD>'               # Direct hash / Прямое хеширование

/etc/caddy/Caddyfile

example.com {
    basicauth /admin/* {
        <USER> <PASSWORD_HASH>                             # User:Hash / Пользователь:Хеш
    }
    reverse_proxy localhost:3000
}

Security Headers / Заголовки безопасности

/etc/caddy/Caddyfile

example.com {
    header {
        X-Frame-Options DENY                               # Clickjacking protection / Защита от clickjacking
        X-Content-Type-Options nosniff                     # MIME sniffing / Сниффинг MIME
        X-XSS-Protection "1; mode=block"                   # XSS protection / Защита от XSS
        Referrer-Policy no-referrer                        # Referrer policy / Политика реферера
        Strict-Transport-Security "max-age=31536000; includeSubDomains; preload"  # HSTS
        -Server                                            # Hide server header / Скрыть заголовок Server
    }
    reverse_proxy localhost:3000
}

IP Allow/Deny / Разрешение/блокировка по IP

/etc/caddy/Caddyfile

example.com {
    @blocked remote_ip 203.0.113.0/24                      # Define blocked IPs / Заблокированные IP
    respond @blocked 403                                   # Return 403 / Вернуть 403

    @allowed remote_ip 10.0.0.0/8 192.168.0.0/16          # Internal only / Только внутренние
    handle @allowed {
        reverse_proxy localhost:3000
    }
    respond 403                                            # Default deny / По умолчанию запрет
}

Rate Limiting / Ограничение запросов

/etc/caddy/Caddyfile

example.com {
    rate_limit {
        zone dynamic {
            key {remote_host}                              # Key by client IP / Ключ по IP клиента
            events 100                                     # Max requests / Максимум запросов
            window 1m                                      # Time window / Временное окно
        }
    }
    reverse_proxy localhost:3000
}

[!NOTE] Rate limiting requires the caddy-ratelimit plugin. Install with xcaddy build --with github.com/mholt/caddy-ratelimit. Ограничение скорости требует плагин caddy-ratelimit. Установка: xcaddy build --with github.com/mholt/caddy-ratelimit.

Logging & Monitoring

Access Logs / Логи доступа

/etc/caddy/Caddyfile

example.com {
    log {
        output file /var/log/caddy/access.log {            # Log to file / Логировать в файл
            roll_size 100mb                                # Max file size / Макс. размер файла
            roll_keep 10                                   # Keep N rotated files / Хранить N ротированных файлов
            roll_keep_for 720h                             # Keep for 30 days / Хранить 30 дней
        }
        format json                                        # JSON format / Формат JSON
        level INFO                                         # Log level / Уровень логирования
    }
    reverse_proxy localhost:3000
}

Structured JSON Log Example / Пример структурированного JSON лога

{
  "level": "info",
  "ts": 1609459200.123,
  "logger": "http.log.access",
  "msg": "handled request",
  "request": {
    "remote_ip": "203.0.113.1",
    "method": "GET",
    "uri": "/api/health",
    "host": "example.com"
  },
  "status": 200,
  "duration": 0.001234
}

Global Logging / Глобальное логирование

/etc/caddy/Caddyfile

{
    log {
        output file /var/log/caddy/caddy.log               # Global log / Глобальный лог
        level ERROR                                        # Only errors / Только ошибки
    }
}

Metrics (Prometheus) / Метрики (Prometheus)

/etc/caddy/Caddyfile

{
    servers {
        metrics                                            # Enable Prometheus metrics / Включить метрики Prometheus
    }
}

:2019 {
    metrics /metrics                                       # Expose at /metrics / Доступ по /metrics
}

Advanced Features

Snippets (Reusable Config) / Сниппеты (Переиспользуемые блоки)

/etc/caddy/Caddyfile

# Define snippet / Определение сниппета
(security_headers) {
    header {
        X-Frame-Options DENY
        X-Content-Type-Options nosniff
        Strict-Transport-Security "max-age=31536000"
        -Server
    }
}

# Use snippet / Использование сниппета
example.com {
    import security_headers                                # Import snippet / Импортировать сниппет
    reverse_proxy localhost:3000
}

another.example.com {
    import security_headers                                # Reuse snippet / Переиспользовать сниппет
    reverse_proxy localhost:4000
}

Import Files / Импорт файлов

/etc/caddy/Caddyfile

import /etc/caddy/conf.d/*.caddy                          # Import all configs / Импортировать все конфиги

Environment Variables / Переменные окружения

/etc/caddy/Caddyfile

{$DOMAIN:localhost} {
    reverse_proxy {$BACKEND_HOST:localhost}:{$BACKEND_PORT:3000}  # Env vars with defaults / Переменные с умолчаниями
}

DOMAIN=example.com BACKEND_HOST=10.0.0.1 BACKEND_PORT=8080 caddy run  # Set env vars / Задать переменные

Matchers / Сопоставления

/etc/caddy/Caddyfile

example.com {
    @api {
        path /api/*                                        # Path matcher / Сопоставление по пути
        method GET POST                                    # Method matcher / Сопоставление по методу
    }
    reverse_proxy @api <IP>:8080                           # Apply to matched / Применить к совпадениям

    @static {
        path *.css *.js *.png *.jpg *.gif *.svg            # Static files / Статические файлы
    }
    header @static Cache-Control "public, max-age=86400"   # Cache headers / Заголовки кэша

    reverse_proxy localhost:3000                            # Default / По умолчанию
}

Custom Error Pages / Пользовательские страницы ошибок

/etc/caddy/Caddyfile

example.com {
    handle_errors {
        @404 expression `{err.status_code} == 404`
        handle @404 {
            rewrite * /404.html
            file_server
        }
        @5xx expression `{err.status_code} >= 500`
        handle @5xx {
            respond "Server Error" 500
        }
    }
    reverse_proxy localhost:3000
}

Redirect / Редирект

/etc/caddy/Caddyfile

www.example.com {
    redir https://example.com{uri} permanent               # WWW → non-WWW redirect / Редирект www → без www
}

example.com {
    redir /old-page /new-page 301                          # Path redirect / Редирект пути
    reverse_proxy localhost:3000
}

Custom Caddy Builds with xcaddy / Сборка с плагинами через xcaddy

# Install xcaddy / Установить xcaddy
go install github.com/caddyserver/xcaddy/cmd/xcaddy@latest

# Build with plugins / Собрать с плагинами
xcaddy build \
  --with github.com/caddy-dns/cloudflare \
  --with github.com/mholt/caddy-ratelimit \
  --with github.com/caddyserver/transform-encoder

# Replace system binary / Заменить системный бинарник
sudo mv caddy /usr/bin/caddy
sudo systemctl restart caddy

Production Configuration

Production-Ready Template / Шаблон для продакшена

/etc/caddy/Caddyfile

{
    email [email protected]                                # ACME notifications / Уведомления ACME
    admin off                                              # Disable admin API / Отключить admin API в проде
    log {
        output file /var/log/caddy/caddy.log {
            roll_size 100mb
            roll_keep 5
        }
        level ERROR
    }
}

# Reusable snippet / Переиспользуемый сниппет
(common) {
    encode gzip zstd
    header {
        X-Frame-Options DENY
        X-Content-Type-Options nosniff
        Strict-Transport-Security "max-age=31536000; includeSubDomains; preload"
        -Server
    }
    log {
        output file /var/log/caddy/{args[0]}_access.log {
            roll_size 100mb
            roll_keep 10
            roll_keep_for 720h
        }
        format json
    }
}

example.com {
    import common example.com

    reverse_proxy <IP1>:8080 <IP2>:8080 {
        lb_policy least_conn
        health_uri /healthz
        health_interval 10s
        health_timeout 5s
        fail_duration 30s
        max_fails 3
    }
}

Production Checklist / Чеклист для продакшена

• [ ] admin off in production / admin off в продакшене
• [ ] ACME email configured / Настроен email для ACME
• [ ] TLS protocols restricted to 1.2+ / TLS протоколы ограничены до 1.2+
• [ ] Security headers set / Заголовки безопасности установлены
• [ ] Access logs configured / Логи доступа настроены
• [ ] Health checks enabled / Проверки здоровья включены
• [ ] Compression enabled / Сжатие включено
• [ ] Logrotate configured / Logrotate настроен
• [ ] Firewall rules for 80/443 only / Правила firewall только для 80/443
• [ ] Monitoring/metrics enabled / Мониторинг/метрики включены

Systemd Override / Переопределение systemd

/etc/systemd/system/caddy.service.d/override.conf

[Service]
LimitNOFILE=65535                                         # Increase file descriptors / Увеличить число файловых дескрипторов
Environment=DOMAIN=example.com                            # Set environment / Задать переменные окружения

sudo systemctl daemon-reload && sudo systemctl restart caddy  # Apply override / Применить переопределение

Troubleshooting & Tools

Common Issues / Типичные проблемы

# Certificate not issuing / Сертификат не выдаётся
# 1. Check DNS A/AAAA record points to your server / Проверить DNS запись
dig +short example.com

# 2. Check ports 80 and 443 are open / Проверить что порты 80 и 443 открыты
sudo ss -tlnp | grep -E ':80|:443'

# 3. Check Caddy logs for ACME errors / Проверить логи на ACME ошибки
sudo journalctl -u caddy --no-pager --since "1 hour ago" | grep -i "acme\|tls\|certificate"

# Permission issues / Проблемы с правами
sudo chown -R caddy:caddy /var/lib/caddy                  # Fix ownership / Исправить владельца
sudo chown -R caddy:caddy /var/log/caddy

# Config syntax error / Ошибка синтаксиса
caddy validate --config /etc/caddy/Caddyfile              # Validate config / Проверить конфиг

# Port already in use / Порт занят
sudo ss -tlnp | grep -E ':80|:443'                        # Check what's using port / Проверить что использует порт
sudo systemctl stop nginx apache2                         # Stop conflicting service / Остановить конфликтующий сервис

Debug Mode / Режим отладки

/etc/caddy/Caddyfile

{
    debug                                                  # Enable debug logging / Включить отладочное логирование
}

caddy run --config /etc/caddy/Caddyfile --adapter caddyfile  # Run with verbose output / Запуск с подробным выводом

Certificate Management / Управление сертификатами

# View managed certificates / Просмотр управляемых сертификатов
curl -s localhost:2019/config/apps/tls/certificates | jq .

# Force certificate renewal / Принудительное обновление сертификата
caddy reload --config /etc/caddy/Caddyfile                # Reload triggers renewal check / Перезагрузка запускает проверку обновления

# Check certificate from outside / Проверить сертификат извне
openssl s_client -connect example.com:443 -servername example.com < /dev/null 2>/dev/null | openssl x509 -noout -dates

Useful Diagnostic Commands / Полезные диагностические команды

caddy version                                              # Check version / Проверить версию
caddy list-modules                                         # List modules / Список модулей
curl -s localhost:2019/config/ | jq .                      # Dump running config / Текущий конфиг
curl -s localhost:2019/reverse_proxy/upstreams | jq .      # Upstream status / Статус upstream
journalctl -u caddy -f                                     # Follow logs / Следить за логами

Comparison Tables

Caddy vs Other Web Servers / Сравнение Caddy с другими веб-серверами

TLS Certificate Sources / Источники TLS-сертификатов

Logrotate Configuration

[!NOTE] Caddy has built-in log rotation via roll_size, roll_keep, and roll_keep_for directives. External logrotate is optional but can be used for integration with existing systems. Caddy имеет встроенную ротацию логов через директивы roll_size, roll_keep, roll_keep_for. Внешний logrotate опционален.

Built-in Rotation / Встроенная ротация

/etc/caddy/Caddyfile

log {
    output file /var/log/caddy/access.log {
        roll_size 100mb                                    # Rotate at 100MB / Ротация при 100МБ
        roll_keep 10                                       # Keep 10 files / Хранить 10 файлов
        roll_keep_for 720h                                 # Keep for 30 days / Хранить 30 дней
    }
}

External Logrotate / Внешний Logrotate

/etc/logrotate.d/caddy

/var/log/caddy/*.log {
    daily
    rotate 14
    compress
    delaycompress
    missingok
    notifempty
    create 640 caddy caddy
    sharedscripts
    postrotate
        kill -USR1 $(cat /run/caddy.pid 2>/dev/null) > /dev/null 2>&1 || true
    endscript
}

Documentation Links

• Caddy Official Documentation
• Caddyfile Concepts
• Caddyfile Directives
• Caddy Reverse Proxy
• Caddy TLS Configuration
• Caddy JSON API
• Caddy Community Plugins
• Caddy GitHub Repository
• Caddy Wiki
• xcaddy — Custom Builds