Установка

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

Официально:

• Статические двоичные файлы
• Пакеты Debian, Ubuntu, Raspbian
• Пакеты Fedora, RedHat, CentOS
• Пакеты Arch Linux, Manjaro, Parabola
• Изображение Docker

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

• Gentoo
• Homebrew (Mac)
• Chocolatey (Windows)
• Scoop (Windows)
• Webi
• Ansible
• Termux
• Nix/Nixpkgs/NixOS
• Unikraft
• OPNsense

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

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

1. Получите двоичный файл Caddy:
   • из релизов на GitHub (разверните "Assets")
     • См. Проверка подписей активов, чтобы узнать, как проверить подпись актива
   • с нашей страницы загрузки
   • путем сборки из исходного кода (либо с помощью go, либо с помощью xcaddy)
2. Установите Caddy как системную службу. Это настоятельно рекомендуется, особенно для серверов в производственной среде.

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

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

Debian, Ubuntu, Raspbian

Установка этого пакета автоматически запускает и выполняет Caddy как службу systemd с именем 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 apt update
sudo apt install caddy

Тестовые релизы (включают бета-версии и кандидаты в релизы):

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 apt update
sudo apt install caddy

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

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

Fedora, RedHat, CentOS

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

Fedora или RHEL/CentOS 8:

dnf install 'dnf-command(copr)'
dnf copr enable @caddy/caddy
dnf install caddy

RHEL/CentOS 7:

yum install yum-plugin-copr
yum copr enable @caddy/caddy
yum install caddy

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

Arch Linux, Manjaro, Parabola

Этот пакет поставляется с сильно измененными версиями обоих файлов единиц службы systemd Caddy, но не включает их по умолчанию. Эти изменения включают пользовательское поведение запуска/остановки и дополнительные флаги для создания защищенной среды, которые описаны в документации systemd exec, что может привести к недоступности определенных системных каталогов для процесса Caddy.

pacman -Syu caddy

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

Docker

docker pull caddy

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

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

Gentoo

Примечание: Это метод установки, поддерживаемый сообществом.

emerge www-servers/caddy

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

Homebrew (Mac)

Примечание: Это метод установки, поддерживаемый сообществом.

brew install caddy

Просмотреть формулу Homebrew

Chocolatey (Windows)

Примечание: Это метод установки, поддерживаемый сообществом.

choco install caddy

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

Scoop (Windows)

Примечание: Это метод установки, поддерживаемый сообществом.

scoop install caddy

Просмотреть манифест Scoop

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
• Модуль NixOS: services.caddy

Просмотреть 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, вам нужно подключить экземпляр уникель к сети.

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

OPNsense

Примечание: Это метод установки, поддерживаемый сообществом.

pkg install os-caddy

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