A Project Store Forum GitHub Theme: System
Download Sponsor

Установка

На этой странице описаны разные способы установки Caddy в вашей системе.

Официальные:

Поддерживаются сообществом:

Статические бинарные файлы

При установке на production-систему мы рекомендуем использовать официальный пакет для вашего дистрибутива, если он доступен ниже.

  1. Получите бинарный файл Caddy:
  2. Установите Caddy как системный сервис. Это настоятельно рекомендуется, особенно для production-серверов.

Поместите бинарный файл в один из каталогов вашего $PATH (или %PATH% в Windows), чтобы можно было запускать caddy без ввода полного пути к исполняемому файлу. (Выполните echo $PATH, чтобы увидеть список подходящих каталогов.)

Статические бинарные файлы можно обновлять, заменяя их более новыми версиями и перезапуская Caddy. Команда caddy upgrade может упростить это.

Debian, Ubuntu, Raspbian

Установка этого пакета автоматически запускает Caddy как systemd service с именем caddy. Он также включает дополнительный сервис caddy-api, который по умолчанию не включен, но его следует использовать, если вы в основном настраиваете Caddy через API, а не через конфигурационные файлы.

После установки прочитайте инструкции по использованию сервиса.

Стабильные релизы:

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo chmod o+r /usr/share/keyrings/caddy-stable-archive-keyring.gpg
sudo chmod o+r /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install caddy

Тестовые релизы (включая beta-версии и release candidates):

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/testing/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-testing-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/testing/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-testing.list
sudo chmod o+r /usr/share/keyrings/caddy-testing-archive-keyring.gpg
sudo chmod o+r /etc/apt/sources.list.d/caddy-testing.list
sudo apt update
sudo apt install caddy

Посмотреть репозитории Cloudsmith

Если вы хотите использовать пакетные вспомогательные файлы (systemd services, bash completion и конфигурацию по умолчанию) с собственной сборкой Caddy, инструкции можно найти здесь.

Fedora, RedHat, CentOS

Этот пакет поставляется с обоими unit-файлами systemd service Caddy, но по умолчанию не включает их. Использовать сервис рекомендуется. Если вы так сделаете, прочитайте инструкции по использованию сервиса.

Fedora:

dnf install dnf5-plugins
dnf copr enable @caddy/caddy
dnf install caddy

CentOS/RHEL:

dnf install dnf-plugins-core
dnf copr enable @caddy/caddy
dnf install caddy

Посмотреть Caddy COPR

Arch Linux, Manjaro, Parabola

Этот пакет поставляется с сильно измененными версиями обоих unit-файлов systemd service Caddy, но по умолчанию не включает их. Эти изменения включают особое поведение start/stop и дополнительные флаги sandboxing, которые объяснены в документации systemd exec; из-за них некоторые каталоги хоста могут быть недоступны процессу Caddy.

pacman -Syu caddy

Посмотреть Caddy в репозиториях Arch Linux и Arch Linux Wiki

Docker

docker pull caddy

Посмотреть на Docker Hub

Смотрите нашу рекомендуемую конфигурацию Docker Compose и инструкции по использованию.

Railway

Благодаря спонсорской поддержке Railway мы официально поддерживаем этот шаблон:

Deploy on Railway

Gentoo

Примечание: этот способ установки поддерживается сообществом.

emerge www-servers/caddy

Посмотреть пакет Gentoo

Homebrew (Mac)

Примечание: этот способ установки поддерживается сообществом.

brew install caddy

Посмотреть Homebrew formula

Chocolatey (Windows)

Примечание: этот способ установки поддерживается сообществом.

choco install caddy

Посмотреть пакет Chocolatey

Scoop (Windows)

Примечание: этот способ установки поддерживается сообществом.

scoop install caddy

Посмотреть Scoop manifest

Webi

Примечание: этот способ установки поддерживается сообществом.

Linux и macOS:

curl -sS https://webi.sh/caddy | sh

Windows:

curl.exe https://webi.ms/caddy | powershell

Возможно, вам потребуется изменить правила брандмауэра Windows, чтобы разрешить входящие подключения не только с localhost.

Посмотреть на Webi

Ansible

Примечание: этот способ установки поддерживается сообществом.

ansible-galaxy install nvjacobo.caddy

Посмотреть репозиторий роли Ansible

Termux

Примечание: этот способ установки поддерживается сообществом.

pkg install caddy

Посмотреть файл build.sh Termux

Nix/Nixpkgs/NixOS

Примечание: этот способ установки поддерживается сообществом.

Посмотреть Caddy в поиске Nixpkgs и поиск параметров NixOS

Unikraft

Примечание: этот способ установки поддерживается сообществом.

Сначала установите сопутствующий инструмент Unikraft, kraft:

curl --proto '=https' --tlsv1.2 -sSf https://get.kraftkit.sh | sh

Затем запустите Caddy с Unikraft так:

kraft run --rm -p 2015:2015 --plat qemu --arch x86_64 -M 256M caddy:2.7

Чтобы разрешить входящие подключения не только с localhost, нужно подключить экземпляр unikernel к сети.

Посмотреть каталог приложений Unikraft и примеры платформы KraftCloud (powered by Unikraft).

OPNsense

Примечание: этот способ установки поддерживается сообществом.

pkg install os-caddy

Посмотреть FreeBSD caddy-custom makefile и исходный код плагина os-caddy

Mise

Примечание: этот способ установки поддерживается сообществом.

Если вы используете mise, polyglot-менеджер версий инструментов, можно установить последнюю версию такой командой:

mise use -g caddy@latest