Caddy官方版

Caddy简介

/[/k0/这个软件仍然很容易使用。您可以根据提供的配置方案将软件部署到您的网站上，以获得新的网络，也可以通过该软件部署新的反向代理，该软件可以针对所有主要平台进行编译，无需运行时依赖。软件提供了API，通过API可以快速配置HTTP，还可以利用API做更多的事情，包括导出配置，对配置进行细粒度的更改！

Caddy软件功能

新体验

Caddy非常“易用”，有助于简化复杂的部署。你的Caddy网站会有更少的活动部件，这将降低成本，提高生产力，提高可靠性。

使用/

用Caddy可以用HTTPS；您可以以前所未有的方式配置和部署您的站点。围绕Web限制破解部署工作流的子任务已经过了！

不仅仅是互联网。

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

Caddy附带适用于HTTPS的应用程序(静态文件、反向生成、负载平衡等)。)，TLS证书管理器和完全管理的内部PKI。Caddy应用程序相互协作，以更少的移动部件实现复杂的基础架构。

例如，此处显示的配置允许更新您的TLS证书以供其他程序使用；不需要外部工具或HTTP守护程序！

为所有应用提供统一配置，在线配置API和自动文档，Caddy几乎可以无限扩展。由于其独特的模块化架构，我们可以在不扩展代码库的情况下提供无限的功能。

Caddy软件特色

使用Caddy文件轻松配置

的强大配置及其本机on configuration

动态配置和开应用编程接口

如果不喜欢开，请配置适配器。

默认情况下自动HTTPS。

让我们加密公共名称

内部名称和IP的完全管理的loCAl ca

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

多步行者保护区

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

它可以在处理数万亿个请求和管理数百万个TLS证书后投入生产。

可以扩展到数千个网站& # 8230；更多地

HTTP/1.1、HTTP/2和实验性HTTP/3支持

高度可扩展的模块化架构使Caddy能够轻松完成任何事情。

Anywhere的操作是否有任何外部依赖(甚至没有libc)？

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

Caddy使用说明

高阶位

"Caddy 2 "还是叫球童。我们可以用“Caddy 2”来说明哪个版本可以使过渡更加混乱。

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

当没有从Caddy 1继承的假设时，最好输入Caddy 2。

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

命令行不再用于配置。

配置不再需要环境变量。

配置Caddy 2的主要方式是通过它的API，但是也可以使用这个caddy命令。

你应该知道Caddy 2的原生配置语言是on，而Caddy文件只是你切换到ON的另一个配置适配器。极端自定义/高级用例可能需要开，因为Caddy文件不能代表所有可能的配置。

Caddy文件基本相同，但功能更强大。指令已经改变。

脚步

1.通过实现我们的入门教程来熟悉Caddy 2。

2.如果没有，请执行步骤1。说真的——我们不能强调至少知道如何使用Caddy 2有多重要。(这个很有意思！)

3.使用以下准则来转换您的caddy命令。

4.使用以下指南转换您的Caddy文件。

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

6.测试，测试和再测试

7.部署并享受乐趣！

HTTPS和港口

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

如果知道主机名或IP，则Caddy 2的默认协议始终是HTTPS。与Caddy 1不同，在Caddy 1中，默认情况下只有公共外观的域使用HTTPS。现在，每个站点都使用HTTPS(除非您明确指定端口:80或禁用HTTPS http://)。

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

证书和AE资源的存储结构发生了变化。Caddy 2可能会为您的站点获取新证书；但是如果您有许多证书，您可以手动迁移它们(如果这不适合您)。详情见问题#2955和#3124。

命令行

凯迪拉克的当前命令，凯迪拉克运行。

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

这样一个命令盒..Caddy文件将成为caddy run & # 8211配置../Caddy文件.

和以前一样，如果您的Caddy文件位于当前文件夹中，Caddy会自动找到并使用它；–在这种情况下，您不需要使用这个标志。

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

运行助手没有运行简单文件的配置。caddy 2中的等效术语是caddy file-。

除了HOME(以及(可选的XDG_*)您设置的任何变量)，环境变量不再相关。CADDYPATH被操作系统惯例所取代。

重大变化

如果要提供一个静态文件，需要添加file_指令，因为Caddy 2默认不采用这个指令。出于安全原因，Caddy 2默认情况下不会嗅探MIME。如果缺少内容类型，您可能需要使用标题指令自己设置标题。

在v1中，您只能按请求路径过滤(或“匹配”)指令。在v2中，请求匹配功能更强大。任何将中间件添加到HTTP处理程序链或以任何方式处理HTTP请求/响应的v2指令都可以利用这个新的匹配函数。了解有关v2请求匹配器的更多信息。你需要了解他们才能理解v2Caddy文件。

虽然很多占位符都是一样的，但是很多都变了，现在出现了很多新的占位符，包括Caddy文件的缩写。

Caddy 2条记录是结构化的，默认格式为ON。所有的博客级别都可以简单地转到同一个博客进行处理(但是你可以根据自己的需要定制这个博客)。

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

我们将在这里列出一些最常见的v1命令，并描述如何转换它们以在v2Caddy文件中使用。

这一页缺少v1指令不代表v2做不到！在v2中，有些v1指令是不需要的，翻译效果差或者用其他方式实现。对于一些高级定制，您可能需要下拉到“开”以获得所需的内容。浏览我们的文档，找到您需要的内容！

Caddy基本认证

HTTP基本身份验证仍然使用basicth指令进行配置。但是，Caddy 2配置不接受纯文本密码。你必须把它们弄碎。这个球童哈希密码可以帮助你。

浏览

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

错误

您可以使用来完成自定义错误页面句柄。

延长

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

v1: ext。超文本标记语言

v2: try_files {path}。html {路径}

网关接口

假设您使用的是PHP，v2相当于php_fastcgi。

请注意，fastcgiv1中的指令在幕后做了许多事情，包括尝试在磁盘上归档、重写请求，甚至重定向。V2php_fastcgi指令也可以为您做到这一点，但是文档提供了一个扩展的表单，如果您的需求不同，您可以对其进行修改。

phpv2中不需要预置，因为php_fastcgi指令默认采用php。一个php_fastcgi 127.0.0.1:9000 php这样的php行，会导致反向代理认为还有另一个后端php被调用，从而导致连接错误。

版本2中的子命令是不同的——PHP可能不需要任何子命令。

压缩

现在，一条指令可以用于所有响应编码，包括多种压缩格式。

页眉

基本上没有变化，但是现在更强大了，因为它可以代替v2中的substring。