caddyserver/caddy빠르고 확장 가능한 멀티 플랫폼 HTTP/1-2-3 웹 서버 (자동 HTTPS 지원)
<p align="center">
<a href="https://caddyserver.com">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://github.com/user-attachments/assets/1d6be89c-df8a-438c-b01d-cef6bf56440a">
<source media="(prefers-color-scheme: light)" srcset="https://github.com/user-attachments/assets/3a5b7419-6925-48f6-ae75-d231f4a4f0c2">
<img src="https://github.com/user-attachments/assets/3a5b7419-6925-48f6-ae75-d231f4a4f0c2" alt="Caddy" width="550">
</picture>
</a>
<br>
<h3 align="center"><a href="https://zerossl.com"><img src="https://user-images.githubusercontent.com/55066419/208327323-2770dc16-ec09-43a0-9035-c5b872c2ad7f.svg" height="28" style="vertical-align: -7.7px" valign="middle"></a> 프로젝트</h3>
</p>
<hr>
<h3 align="center">모든 사이트를 HTTPS로</h3>
<p align="center">Caddy는 기본적으로 TLS를 사용하는 확장 가능한 서버 플랫폼입니다.</p>
<p align="center">
<a href="https://github.com/caddyserver/caddy/releases">릴리스</a> ·
<a href="https://caddyserver.com/docs/">문서</a> ·
<a href="https://caddy.community">도움 받기</a>
</p>
<p align="center">
<a href="https://github.com/caddyserver/caddy/actions/workflows/ci.yml"><img src="https://github.com/caddyserver/caddy/actions/workflows/ci.yml/badge.svg"></a>
<a href="https://www.bestpractices.dev/projects/7141"><img src="https://www.bestpractices.dev/projects/7141/badge"></a>
<a href="https://pkg.go.dev/github.com/caddyserver/caddy/v2"><img src="https://img.shields.io/badge/godoc-reference-%23007d9c.svg"></a>
<a href="https://x.com/caddyserver" title="@caddyserver on Twitter"><img src="https://img.shields.io/twitter/follow/caddyserver" alt="@caddyserver on Twitter"></a>
<a href="https://caddy.community" title="Caddy Forum"><img src="https://img.shields.io/badge/community-forum-ff69b4.svg" alt="Caddy Forum"></a>
<br>
<a href="https://sourcegraph.com/github.com/caddyserver/caddy?badge" title="Caddy on Sourcegraph"><img src="https://sourcegraph.com/github.com/caddyserver/caddy/-/badge.svg" alt="Caddy on Sourcegraph"></a>
<a href="https://cloudsmith.io/~caddy/repos/"><img src="https://img.shields.io/badge/OSS%20hosting%20by-cloudsmith-blue?logo=cloudsmith" alt="Cloudsmith"></a>
</p>
<p align="center">
<b>Powered by</b>
<br>
<a href="https://github.com/caddyserver/certmagic">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://user-images.githubusercontent.com/55066419/206946718-740b6371-3df3-4d72-a822-47e4c48af999.png">
<source media="(prefers-color-scheme: light)" srcset="https://user-images.githubusercontent.com/1128849/49704830-49d37200-fbd5-11e8-8385-767e0cd033c3.png">
<img src="https://user-images.githubusercontent.com/1128849/49704830-49d37200-fbd5-11e8-8385-767e0cd033c3.png" alt="CertMagic" width="250">
</picture>
</a>
</p>
<!-- Warp sponsorship requests this section -->
<div align="center" markdown="1">
<hr>
<sup>Special thanks to:</sup>
<br>
<a href="https://go.warp.dev/caddy">
<img alt="Warp sponsorship" width="400" src="https://github.com/user-attachments/assets/c8efffde-18c7-4af4-83ed-b1aba2dda394">
</a>
### [Warp, built for coding with multiple AI agents](https://go.warp.dev/caddy)
[Available for MacOS, Linux, & Windows](https://go.warp.dev/caddy)<br>
</div>
<hr>
### 메뉴
- [기능](#features)
- [설치](#install)
- [소스에서 빌드](#build-from-source)
- [개발용](#for-development)
- [버전 정보 및/또는 플러그인 포함](#with-version-information-andor-plugins)
- [빠른 시작](#quick-start)
- [개요](#overview)
- [전체 문서](#full-documentation)
- [도움 받기](#getting-help)
- [소개](#about)
## [기능](https://caddyserver.com/features)
- [Caddyfile](https://caddyserver.com/docs/caddyfile)을 사용한 **간편한 구성**
- [네이티브 JSON 구성](https://caddyserver.com/docs/json/)을 통한 **강력한 구성**
- [JSON API](https://caddyserver.com/docs/api)를 통한 **동적 구성**
- JSON이 마음에 들지 않는다면 [**구성 어댑터**](https://caddyserver.com/docs/config-adapters)
- 기본적으로 **자동 HTTPS**
- 공용 도메인 이름을 위한 [ZeroSSL](https://zerossl.com) 및 [Let's Encrypt](https://letsencrypt.org)
- 내부 이름 및 IP를 위한 완전 관리형 로컬 CA
- 클러스터 내 다른 Caddy 인스턴스와 조정 가능
- 다중 발급자 폴백
- Encrypted ClientHello (ECH) 지원
- TLS/OCSP/인증서 관련 문제로 다른 서버가 다운되어도 **계속 유지됨**
- 수조 건의 요청을 처리하고 수백만 개의 TLS 인증서를 관리한 **프로덕션 준비 완료**
- 프로덕션에서 입증된 대로 **수십만 개의 사이트로 확장 가능**
- **HTTP/1.1, HTTP/2, HTTP/3** 모두 기본 지원
- **뛰어난 확장성**을 갖춘 [모듈식 아키텍처](https://caddyserver.com/docs/architecture)로 Caddy는 비대해지지 않고 무엇이든 할 수 있음
- **외부 의존성 없이**(libc조차도 없이) **어디서나 실행 가능**
- 다른 서버보다 더 높은 **메모리 안전성 보장**을 제공하는 언어인 Go로 작성됨
- 정말로 **사용하기 즐거움**
- [알아볼 것](https://caddyserver.com/features)이 훨씬 더 많음
## 설치
가장 간단한 크로스 플랫폼 시작 방법은 [GitHub Releases](https://github.com/caddyserver/caddy/releases)에서 Caddy를 다운로드하여 실행 파일을 PATH에 두는 것입니다.
다른 설치 방법은 [온라인 문서](https://caddyserver.com/docs/install)를 참조하세요.
## 소스에서 빌드
요구 사항:
- [Go 1.26.0 이상](https://golang.org/dl/)
### 개발용
_**참고:** 이 단계들은 [적절한 버전 정보를 포함하지 않습니다](https://github.com/golang/go/issues/29228). 이를 위해서는 다음 섹션의 지침을 따르세요._
```bash
$ git clone "https://github.com/caddyserver/caddy.git"
$ cd caddy/cmd/caddy/
$ go build
```
Caddy를 실행하면 구성에서 별도로 지정하지 않는 한 낮은 포트에 바인딩하려고 시도할 수 있습니다. OS가 이를 위해 높은 권한을 요구하는 경우, 새 바이너리에 해당 권한을 부여해야 합니다. Linux에서는 다음과 같이 쉽게 할 수 있습니다: `sudo setcap cap_net_bind_service=+ep ./caddy`
임시 바이너리만 생성하는 `go run`을 선호하는 경우에도 포함된 `setcap.sh`를 사용하여 다음과 같이 할 수 있습니다:
```bash
$ go run -exec ./setcap.sh main.go
```
`setcap`을 위해 비밀번호를 입력하고 싶지 않다면, `sudo visudo`를 사용하여 sudoers 파일을 편집하고 사용자 계정이 비밀번호 없이 해당 명령을 실행할 수 있도록 허용하세요. 예를 들어:
```
username ALL=(ALL:ALL) NOPASSWD: /usr/sbin/setcap
```
`username`을 실제 사용자 이름으로 바꾸세요. 주의하고 자신이 무엇을 하는지 아는 경우에만 이 작업을 수행하세요! 우리는 Caddy 사용법을 문서화할 자격이 있을 뿐, Go 도구나 여러분의 컴퓨터에 대해서는 그렇지 않으며, 이 지침은 편의를 위해서만 제공됩니다. 자신의 책임하에 컴퓨터 사용법을 익히고 필요한 조정을 하세요.
그런 다음 모든 모듈 또는 특정 모듈에서 테스트를 실행할 수 있습니다:
```bash
$ go test ./...
$ go test ./modules/caddyhttp/tracing/
```
### 버전 정보 및/또는 플러그인 포함
[빌더 도구인 `xcaddy`](https://github.com/caddyserver/xcaddy)를 사용하면...
```bash
$ xcaddy build
```
...다음 단계가 자동화됩니다:
1. 새 폴더 생성: `mkdir caddy`
2. 해당 폴더로 이동: `cd caddy`
3. [Caddy의 main.go](https://github.com/caddyserver/caddy/blob/master/cmd/caddy/main.go)를 빈 폴더에 복사합니다. 추가하려는 사용자 정의 플러그인에 대한 import를 추가하세요.
4. Go 모듈 초기화: `go mod init caddy`
5. (선택 사항) Caddy 버전 고정: `go get github.com/caddyserver/caddy/v2@version`에서 `version`을 git 태그, 커밋 또는 브랜치 이름으로 바꾸세요.
6. (선택 사항) 플러그인 추가: 해당 import 추가: `_ "import/path/here"`
7. 컴파일: `go build -tags=nobadger,nomysql,nopgx`
## 빠른 시작
[Caddy 웹사이트](https://caddyserver.com/docs/)에는 튜토리얼, 빠른 시작 가이드, 참조 등을 포함한 문서가 있습니다.
**경험 수준에 관계없이 모든 사용자가 Caddy 사용에 익숙해지기 위해 [시작하기](https://caddyserver.com/docs/getting-started) 가이드를 수행할 것을 권장합니다.**
시간이 1분밖에 없다면, [웹사이트에 선택할 수 있는 여러 빠른 시작 튜토리얼](https://caddyserver.com/docs/quick-starts)이 있습니다! 하지만 빠른 시작 튜토리얼을 마친 후에는 소프트웨어가 어떻게 작동하는지 이해하기 위해 더 많은 문서를 읽어보세요. 🙂
## 개요
Caddy는 HTTPS 서버로 가장 자주 사용되지만, 모든 장기 실행 Go 프로그램에 적합합니다. 무엇보다도 Caddy는 Go 애플리케이션을 실행하는 플랫폼입니다. Caddy "앱"은 Caddy 모듈로 구현된 Go 프로그램일 뿐입니다. 두 개의 앱 -- `tls`와 `http` -- 이 Caddy에 기본으로 포함되어 있습니다.
Caddy 앱은 [자동 문서화](https://caddyserver.com/docs/json/), [API를 통한 우아한 온라인 구성 변경](https://caddyserver.com/docs/api), 다른 Caddy 앱과의 통합의 이점을 즉시 누립니다.
[JSON](https://caddyserver.com/docs/json/)이 Caddy의 네이티브 구성 언어이지만, Caddy는 [구성 어댑터](https://caddyserver.com/docs/config-adapters)로부터 입력을 받을 수 있으며, 이는 기본적으로 원하는 모든 구성 형식을 JSON으로 변환할 수 있습니다: Caddyfile, JSON 5, YAML, TOML, NGINX 구성 등.
Caddy를 구성하는 주요 방법은 [API](https://caddyserver.com/docs/api)를 통하는 것이지만, 구성 파일을 선호한다면 [명령줄 인터페이스](https://caddyserver.com/docs/command-line)도 이를 지원합니다.
Caddy는 현존하는 어떤 웹 서버와 비교해도 전례 없는 수준의 제어를 제공합니다. Caddy에서는 일반적으로 HTTP 핸들러와 TLS 핸드셰이크부터 스토리지 매체에 이르기까지 모든 것을 구동하는 메모리 내 초기화된 타입의 실제 값을 설정합니다. Caddy는 또한 다른 웹 서버보다 훨씬 뛰어난 강력한 플러그인 시스템을 갖춘 믿을 수 없을 정도로 확장 가능합니다.
이 설계의 힘을 활용하려면 구성 문서가 어떻게 구조화되어 있는지 알아야 합니다. [Caddy의 구성 구조](https://caddyserver.com/docs/json/)에 대한 자세한 내용은 [문서 사이트](https://caddyserver.com/docs/)를 참조하세요.
Caddy의 구성은 거의 모두 단일 구성 문서에 포함되어 있으며, 다른 웹 서버처럼 CLI 플래그와 환경 변수, 구성 파일에 흩어져 있지 않습니다. 이는 서버 구성을 더 간단하게 관리할 수 있게 하고 숨겨진 변수/요인을 줄여줍니다.
## 전체 문서
우리 웹사이트에는 완전한 문서가 있습니다:
**https://caddyserver.com/docs/**
문서는 오픈 소스이기도 합니다. 여기에서 기여할 수 있습니다: https://github.com/caddyserver/website
## 도움 받기
- Caddy를 사용하는 기업은 도움이 필요하기 전에 [Ardan Labs](https://www.ardanlabs.com)를 통해 지원 계약을 체결하는 것이 좋습니다.
- [후원](https://github.com/sponsors/mholt)은 큰 도움이 됩니다! 후원자에게는 비공개 도움을 제공할 수 있습니다. Caddy가 귀사에 도움이 된다면 후원을 고려해 주세요. 이는 프로젝트의 장수를 보장하기 위한 전임 작업 자금을 지원할 뿐만 아니라, 귀사에 필요한 리소스, 지원, 할인을 제공하며, 고객과 잠재 고객에게 귀사의 좋은 이미지를 보여줍니다!
- 개인은 https://caddy.community의 커뮤니티 포럼에서 무료로 도움을 주고받을 수 있습니다. 사람들은 여가 시간과 선의로 도움을 준다는 것을 기억하세요. 도움을 받는 가장 좋은 방법은 먼저 도움을 주는 것입니다!
[이슈 트래커](https://github.com/caddyserver/caddy/issues)는 버그 보고 및 기능 요청, 즉 실행 가능한 개발 항목에만 사용해 주세요 (지원 질문은 보통 포럼으로 안내됩니다).
## 소개
Matthew Holt는 2014년 Brigham Young University에서 컴퓨터 과학을 공부하던 중 Caddy를 개발하기 시작했습니다. ("Caddy"라는 이름은 이 소프트웨어가 웹 서비스를 제공하는 지루하고 일상적인 작업을 돕고, 여러 가지를 함께 정리할 수 있는 단일 장소이기도 하기 때문에 선택되었습니다.) 이는 곧 자동으로 그리고 기본적으로 HTTPS를 사용하는 최초의 웹 서버가 되었으며, 현재 수백 명의 기여자를 보유하고 수조 건의 HTTPS 요청을 처리했습니다.
**"Caddy"라는 이름은 상표입니다.** 소프트웨어의 이름은 "Caddy"이며, "Caddy Server"나 "CaddyServer"가 아닙니다. "Caddy" 또는 명확히 하고 싶다면 "the Caddy web server"라고 부르세요. Caddy는 Stack Holdings GmbH의 등록 상표입니다.
- _X의 프로젝트: [@caddyserver](https://x.com/caddyserver)_
- _X의 작성자: [@mholt6](https://x.com/mholt6)_
Caddy는 HID Global의 계열사인 [ZeroSSL](https://zerossl.com)의 프로젝트입니다.
Debian 패키지 저장소 호스팅은 [Cloudsmith](https://cloudsmith.com)에서 친절하게 제공합니다. Cloudsmith는 조직이 모든 형식의 패키지를 어디든지 완전한 신뢰를 가지고 생성, 저장 및 공유할 수 있게 하는 유일한 완전 호스팅 클라우드 네이티브 범용 패키지 관리 솔루션입니다.