설치
설치 (Install)
출처: Caddy 공식 문서
본문
이 페이지는 시스템에 Caddy를 설치하는 다양한 방법을 설명해요.
공식:
우리의 공식 패키지는 표준 모듈만 담고 있어요. 서드파티 플러그인이 필요하다면 xcaddy로 소스에서 빌드하거나, 다운로드 페이지를 사용하거나, Railway에 배포해요.
커뮤니티 관리:
정적 바이너리
프로덕션 시스템에 설치한다면, 아래에 나오는 여러분의 배포판용 공식 패키지를 사용하는 것을 권장해요.
- Caddy 바이너리를 얻어요:
-
GitHub의 릴리스에서 ("Assets" 펼치기)
-
자산 서명을 확인하는 방법은 자산 서명 확인을 참조하세요
-
다운로드 페이지에서
-
소스에서 빌드해서(
go또는xcaddy로)
- Caddy를 시스템 서비스로 설치해요. 특히 프로덕션 서버에서는 강력히 권장돼요.
실행 파일의 전체 경로를 입력하지 않고 caddy를 실행할 수 있도록 바이너리를 $PATH(Windows에서는 %PATH%) 디렉터리 중 하나에 넣어요. (echo $PATH를 실행해 해당하는 디렉터리 목록을 확인해요.)
정적 바이너리는 새 버전으로 교체하고 Caddy를 재시작하면 업그레이드할 수 있어요. caddy upgrade명령이 이 과정을 쉽게 만들어 줘요.
Debian, Ubuntu, Raspbian
이 패키지를 설치하면 Caddy가 caddy라는 이름의 systemd 서비스로 자동으로 시작·실행돼요. 또한 선택적 caddy-api 서비스가 함께 제공되는데, 기본으로 활성화되지는 않지만, 설정 파일 대신 API로 Caddy를 주로 구성한다면 사용해야 해요.
설치 후에는 서비스 사용 지침을 읽어 보세요.
안정 릴리스:
sudo apt install --yes 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
테스팅 릴리스(베타와 릴리스 후보 포함):
sudo apt install --yes 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
커스텀 Caddy 빌드와 함께 패키지된 지원 파일(systemd 서비스, bash 완성, 기본 설정)을 사용하려면 여기에서 지침을 확인할 수 있어요.
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
Arch Linux, Manjaro, Parabola
이 패키지는 Caddy의 systemd 서비스 유닛 파일 두 개를 크게 수정한 버전을 포함하지만, 기본으로 활성화하지는 않아요. 그 수정에는 커스텀 시작/중지 동작과 추가 샌드박싱 플래그가 포함되는데, 이는 systemd의 exec 문서에 설명되어 있어요. 이로 인해 특정 호스트 디렉터리를 Caddy 프로세스가 사용하지 못할 수도 있어요.
pacman -Syu caddy
Arch Linux 저장소의 Caddy 보기 및 Arch Linux Wiki
Docker
docker pull caddy
우리의 권장 Docker Compose 설정과 사용 지침을 참조하세요.
Railway
Railway의 후원을 통해 이 템플릿을 공식 지원해요:
Gentoo
참고: 커뮤니티에서 관리하는 설치 방법이에요.
emerge www-servers/caddy
Homebrew (Mac)
참고: 커뮤니티에서 관리하는 설치 방법이에요.
brew install caddy
Chocolatey (Windows)
참고: 커뮤니티에서 관리하는 설치 방법이에요.
choco install caddy
Scoop (Windows)
참고: 커뮤니티에서 관리하는 설치 방법이에요.
scoop install caddy
Webi
참고: 커뮤니티에서 관리하는 설치 방법이에요.
Linux와 macOS:
curl -sS https://webi.sh/caddy | sh
Windows:
curl.exe https://webi.ms/caddy | powershell
non-localhost 인바운드 연결을 허용하려면 Windows 방화벽 규칙을 조정해야 할 수도 있어요.
Ansible
참고: 커뮤니티에서 관리하는 설치 방법이에요.
ansible-galaxy install nvjacobo.caddy
Termux
참고: 커뮤니티에서 관리하는 설치 방법이에요.
pkg install caddy
Nix/Nixpkgs/NixOS
참고: 커뮤니티에서 관리하는 설치 방법이에요.
Nixpkgs 검색에서 Caddy 보기 및 NixOS 옵션 검색
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
non-localhost 인바운드 연결을 허용하려면 unikernel 인스턴스를 네트워크에 연결해야 해요.
Unikraft 애플리케이션 카탈로그 보기 및 KraftCloud 플랫폼 예제(Unikraft 기반).
OPNsense
참고: 커뮤니티에서 관리하는 설치 방법이에요.
pkg install os-caddy
FreeBSD caddy-custom makefile 보기 및 os-caddy 플러그인 소스
Mise
참고: 커뮤니티에서 관리하는 설치 방법이에요.
다중 언어 도구 버전 관리자인 mise를 사용한다면, 이런 명령으로 최신 버전을 설치할 수 있어요:
mise use -g caddy@latest