Что такое caddy?

Caddy — это веб-сервер с открытым исходным кодом с автоматическим HTTPS из коробки.

Среди основных особенностей можно выделить:

  • Простота настройки
  • Автоматическое обновление сертификатов TLS
  • Поддержка мультиядерности/мультипроцессорности
  • Поддержка HTTP/1.1, HTTP/2, и HTTP/3 по умолчанию
  • Возможность изменения конфигурации через API

Установка caddy в ОС Альт

# apt-get install caddy

Управление службой

Пакет caddy в ОС Альт предоставляет две systemd службы: caddy и caddy-api.

Служба caddy-api, в отличие от caddy, будет сохранять конфигурацию после перезапуска при ее изменении с помощью API. Если API не будет использоваться, то можно использовать службу caddy.

Управление данными службами возможно через стандартные команды systemctl.

Например, чтобы добавить caddy в автозагрузку и запустить прямо сейчас можно воспользоваться данной командой:

# systemctl enable --now caddy

Также возможно использование caddy без systemd. Для запуска сервера воспользуйтесь командой caddy run. Для запуска с стандартной конфигурацией, предоставляемой пакетом caddy добавьте --сonfig /etc/caddy/Caddyfile

# caddy run --config /etc/caddy/Caddyfile

Данная команда запустит сервер в текущем терминале. Если необходимо запустить в фоне, можно воспользоваться командой `caddy start`.

Для выключения сервера воспользуйтесь командой caddy stop.

По остальным командам можно почитать в справке, доступной с помощью команд: caddy help и caddy help [command] а также в официальной документации .

Настройка caddy

В ОС Альт конфигурация caddy расположена в /etc/caddy/Caddyfile.

По умолчанию главный файл конфигурации содержит строку import Caddyfile.d/*.caddyfile. Эта строка указывает на то, что Caddy импортирует все файлы с расширением .caddyfile из директории /etc/caddy/Caddyfile.d/. Данная функциональность позволяет разделять конфигурации на отдельные файлы и упрощает организацию и поддержку конфигурации сервера.

Статический файловый сервер

example.com {
    root * /var/www/html
    file_server
}

TODO

Reverse proxy

example.com {
	reverse_proxy localhost:5000
}

TODO

example.com {
	root * /var/www
	reverse_proxy /api/* localhost:5000
	file_server
}

TODO

Редирект с www. субдомена

example.com {
	redir https://www.{host}{uri}
}

www.example.com {
}

TODO

www.example.com {
	redir https://{labels.1}.{labels.0}{uri}
}

example.com {
}

Адаптер конфигов

Решение типовых проблем