Caddy

Caddy提供部署功能，可以为您的网站部署新的web，可以为您的应用程序配置，软件可以快速部署和扩展HTTPS，为用户建立提供帮助，软件使用还是很简单的，按照提供的配置方案将软件部署到你的网站就可以获得新的网络，也可以通过这款软件部署新的反向代理，可为所有主要平台编译，并且没有运行时依赖项，软件提供API，可以通过API快速配置HTTP，可以使用API进行更多作，包括导出配置和对配置进行细粒度的更改!

Caddy软件功能

全新的体验

Caddy非常“好用”，有助于简化复杂的部署。您的Caddy网站将拥有更少的活动部件，从而降低了成本，提高了生产率并提高了可。

使用Caddy的本机ON配置自定义的每一英寸，或使用Caddyfile只需几行即可建立生产站点。

有了Caddy，HTTPS就可以使用;而且您可以以前所未有的方式配置和部署站点。围绕Web局限官方最新部署工作流的子已经过去了!

不只是网络

Caddy 2是一个高度可扩展的自托管平台，您可以在其上构建，配置和部署长期运行的服务(“应用程序”)。

Caddy随附用于HTTPS(静态文件，反向生成，负载平衡等)，TLS证书管理器和完全托管的内部PKI的应用程序。Caddy应用程序相互协作，以使复杂的基架构仅需较少的活动部件即可工作。

例如，此处显示的配置可让您的TLS证书更新，以供其他程序使用;无需外部工具或HTTP守护程序!

为所有应用程序提供统一的配置，在线配置API和自动文档，Caddy几乎可以无限扩展。得益于其独特的模块化架构，我们可以提供无限制的功能，而不会膨胀代码库

Caddy软件特色

使用Caddyfile轻松配置

强大的配置及其原生ON配置

动态配置与ON API

如果您不喜欢ON，请配置适配器

默认情况下为 自动HTTPS

ZeSSL和让我们加密公共名称

完全托管的本地CA，用于内部名称和IP

可以与集群中的其他Caddy实例进行协调

多发行者后备

当其他由于TLS / OCSP /证书相关问题而关闭时保持正常运行

在处理数万亿个请求并管理数百万个TLS证书后即可投入生产

可以扩展到成千上万个网站…甚至更多

HTTP / 1.1，HTTP / 2和实验HTTP / 3支持

高度可扩展的 模块化体系结构使Caddy可以轻松完成任何事情

Anywhere的运行有没有外部的依赖关系(甚至没有的libc)

用Go语言编写，这种语言具有比其他更高的内存安全保证

Caddy使用说明

高阶位

“ Caddy 2”仍然被称为caddy。我们可能会使用“ Caddy 2”来说明哪个版本可以使过渡更容易混淆。

大多数用户只需要替换其caddy二进制文件和更新的Caddyfile配置(在测试其功能后即可)。

在没有从Caddy 1继承任何假设的情况下，最好进入Caddy 2。

您可能无法在v2中完美复制您的利基v1配置。通常，有充分的理由。

命令行不再用于配置。

配置不再需要环境变量。

为Caddy 2进行配置的主要方法是通过其API，但是也可以使用该caddy命令。

您应该知道Caddy 2的本机配置语言是ON，而Caddyfile只是另一个为您转换为ON的配置适配器。极端定制/高级用例可能需要ON，因为Caddyfile不能表示所有可能的配置。

Caddyfile基本上是相同的，但功能也更强大。指令已更改。

脚步

1、通过执行我们的入门教程，熟悉Caddy 2 。

2、如果还没有，请执行步骤1。认真地说-我们无法强调至少知道如何使用Caddy 2有多么重要。(这很有趣!)

3、使用以下指南转换您的caddy命令。

4、使用以下指南转换您的Caddyfile。

5、在本地或分阶段测试新配置。

6、测试，测试，再测试

7、部署并玩得开心!

HTTPS和端口

球童的默认端口不再是:2015。Caddy 2的默认端口为:443，如果不知道主机名/ IP，则为port :80。您始终可以在配置中自定义端口。

如果已知主机名或IP，则Caddy 2的默认协议始终为HTTPS。这与Caddy 1不同，在Caddy 1中，默认情况下仅具有公共外观的域使用HTTPS。现在，每个站点都使用HTTPS(除非您通过显式指定port:80或禁用HTTPS http://)。

IP地址和本地主机域将从本地信任的嵌入式CA颁发证书。所有其他域将使用ZeSSL或“让我们加密”。(这都是可配置的。)

证书和AE资源的存储结构已更改。Caddy 2可能会为您的站点获取新证书;但是如果您有很多证书，则可以手动迁移它们(如果这样做不适合您)。有关详细，请参见问题#2955和#3124。

命令行

caddy现在的命令caddy run。

所有命令行标志均不同。删除它们;现在，所有配置都存在于实际的配置文档(通常是Caddyfile或ON)中。您可能会在ON结构或Caddyfile全局选项中找到所需的内容，以替换v1中的大多数命令行标志。

这样的命令caddy -conf ../Caddyfile将变为caddy run –config ../Caddyfile。

和以前一样，如果您的Caddyfile位于当前文件夹中，则Caddy将自动查找并使用它;–config在这种情况下，您不需要使用该标志。

除了不再支持USR1和USR2以外，其他信号基本相同。请使用caddy reload命令或API来加载新配置。

运行caddy无任何配置用来运行一个简单的文件。球童2中的等效项是caddy file-。

除了HOME(以及(可选XDG_*)您设置的任何变量)以外，环境变量不再相关。该CADDYPATH是由OS公约所取代。

主要变化

如果要提供静态文件，则需要添加file_指令，因为Caddy 2默认情况下不采用此指令。出于安全原因，默认情况下，Caddy 2也不嗅探MIME。如果缺少Content-Type，则可能需要使用header指令自行设置header。

在v1中，您只能按请求路径过滤(或“匹配”)指令。在v2中，请求匹配功能更加强大。任何将中间件添加到HTTP处理程序链或以任何方式处理HTTP请求/响应的v2指令都可以利用此新的匹配功能。详细了解v2请求匹配器。您需要了解它们，才能理解v2 Caddyfile。

尽管许多占位符是相同的，但许多已更改，现在有许多新的占位符，包括Caddyfile的简写。

Caddy 2志都是结构化的，默认格式为ON。所有志级别都可以简单地转到要处理的同一志(但是您可以根据需要自定义此志)。

现在，在Caddy 1中通过路径前缀匹配请求的位置，在Caddy 2中，默认情况下，路径匹配现在是精确的。如果要匹配诸如的前缀/foo/，则/foo/*在Caddy 2中需要。

我们将在此处列出一些最常见的v1指令，并描述如何转换它们以在v2 Caddyfile中使用。

Just️仅仅因为此页面中缺少v1指令并不意味着v2无法做到!在v2中不需要某些v1指令，翻译效果不佳或以其他方式实现。对于某些高级自定义，您可能需要下拉至ON以获得所需的内容。浏览我们的文档以找到所需内容!

Caddy基本认证

HTTP基本身份验证仍使用basicth伪指令配置。但是，Caddy 2配置不接受纯文本密码。您必须对它们进行哈希处理，这caddy hash-password可以帮助您。

浏览

现在可以通过file_指令启用文件浏览

错误

可以使用完成自定义错误页面handle_errs。

分机

隐式文件扩展名可以使用try_files。

v1： ext .html

v2： try_files {path}.html {path}

fastcgi

假设您使用的是PHP，则v2等效于php_fastcgi。

请注意，fastcgiv1中的指令在幕后做了很多事情，包括尝试在磁盘上文件，重写请求，甚至重定向。v2php_fastcgi指令还可以为您完成这些作，但是文档提供了扩展形式，如果您的要求不同，您可以修改它。

phpv2中不需要预设，因为该php_fastcgi指令默认情况下采用PHP。诸如这样的php_fastcgi 127.0.0.1:9000 php行将导致反向代理认为还有一个称为的后端php，从而导致连接错误。

第2版中的子指令有所不同-PHP可能不需要任何子指令。

gzip

encode现在，单个指令可用于所有响应编码，包括多种压缩格式。

标头

基本上没有变化，但现在功能更强大，因为它可以在v2中进行子字符串替换。