A Project Store Forum GitHub Theme: System
Download Sponsor

설치

이 페이지에서는 시스템에 Caddy를 설치하는 다양한 방법을 설명합니다.

공식:

커뮤니티 유지 관리:

정적 바이너리

프로덕션 시스템에 설치하는 경우 아래에서 사용 가능한 배포판용 공식 패키지를 사용하는 것이 좋습니다.

  1. Caddy 바이너리 얻기:
  2. Caddy를 시스템 서비스로 설치하세요. 이는 프로덕션 서버에 강력히 권장됩니다.

실행 파일의 전체 경로를 입력하지 않고도 caddy를 실행할 수 있도록 $PATH(또는 Windows의 경우 %PATH%) 디렉터리 중 하나에 바이너리를 배치합니다. (자격이 되는 디렉터리 목록을 보려면 echo $PATH를 실행하세요.)

정적 바이너리를 최신 버전으로 교체하고 Caddy를 다시 시작하여 업그레이드할 수 있습니다. caddy upgrade 명령을 사용하면 이를 쉽게 수행할 수 있습니다.

Debian, Ubuntu, Raspbian

이 패키지를 설치하면 자동으로 이름이 caddy인 systemd 서비스로서 Caddy를 시작하고 실행합니다. 또한 선택적 caddy-api 서비스와 함께 제공되는데, 이 서비스는 기본적으로 활성화되어 있지 않지만 구성 파일 대신 주로 API를 통해 Caddy를 구성하는 경우 사용해야 합니다.

설치한 후 서비스 사용 지침을 읽어보세요.

안정판(Stable) 릴리스:

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

테스트(Testing) 릴리스 (베타 및 릴리스 후보 포함):

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 서비스, bash 자동 완성 및 기본 구성)을 커스텀 Caddy 빌드와 함께 사용하려면 여기에서 지침을 확인할 수 있습니다.

Fedora, RedHat, CentOS

이 패키지는 Caddy의 systemd 서비스 유닛 파일 두 가지를 모두 제공하지만, 기본적으로 활성화하지는 않습니다. 서비스를 사용하는 것이 권장됩니다. 서비스를 사용하려면 서비스 사용 지침을 읽어보세요.

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

이 패키지는 Caddy의 systemd 서비스 유닛 파일 두 가지 모두의 많이 수정된 버전을 제공하지만, 기본적으로 활성화하지는 않습니다. 이러한 수정 사항에는 사용자 지정 시작/중지 동작 및 systemd의 exec 문서에 설명된 추가 샌드박싱 플래그가 포함되어 있으며, 이로 인해 특정 호스트 디렉터리를 Caddy 프로세스에서 사용하지 못할 수 있습니다.

pacman -Syu caddy

Arch Linux 저장소 및 Arch Linux Wiki에서 Caddy 보기

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 매니페스트 보기

Webi

참고: 이 방법은 커뮤니티에서 유지 관리하는 설치 방법입니다.

Linux 및 macOS:

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

Windows:

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

localhost가 아닌 들어오는 연결(incoming connections)을 허용하려면 Windows 방화벽 규칙을 조정해야 할 수 있습니다.

Webi에서 보기

Ansible

참고: 이 방법은 커뮤니티에서 유지 관리하는 설치 방법입니다.

ansible-galaxy install nvjacobo.caddy

Ansible 역할(role) 저장소 보기

Termux

참고: 이 방법은 커뮤니티에서 유지 관리하는 설치 방법입니다.

pkg install caddy

Termux build.sh 파일 보기

Nix/Nixpkgs/NixOS

참고: 이 방법은 커뮤니티에서 유지 관리하는 설치 방법입니다.

Nixpkgs 검색 및 NixOS 옵션 검색에서 Caddy 보기

Unikraft

참고: 이 방법은 커뮤니티에서 유지 관리하는 설치 방법입니다.

먼저 Unikraft의 보조 도구인 kraft를 설치합니다:

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

그런 다음 다음을 사용하여 Unikraft로 Caddy를 실행합니다:

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

localhost가 아닌 들어오는 연결을 허용하려면 유니커널(unikernel) 인스턴스를 네트워크에 연결해야 합니다.

Unikraft 애플리케이션 카탈로그 및 KraftCloud 플랫폼 예제(Unikraft 기반)를 확인하세요.

OPNsense

참고: 이 방법은 커뮤니티에서 유지 관리하는 설치 방법입니다.

pkg install os-caddy

FreeBSD caddy-custom 메이크파일 및 os-caddy 플러그인 소스 보기

Mise

참고: 이 방법은 커뮤니티에서 유지 관리하는 설치 방법입니다.

폴리글롯 도구 버전 관리자인 mise를 사용하는 경우 다음과 같은 명령을 사용하여 최신 버전을 설치할 수 있습니다:

mise use -g caddy@latest