【Caddy2】最新 Caddy2 配置文件解析 - Billyme 的博客

> 本文由 [简悦 SimpRead](http://ksria.com/simpread/) 转码， 原文地址 [billyas.github.io](https://billyas.github.io/p/ac1736fe.html)

作者：Billyme (詩)

博客园：[https://www.cnblogs.com/billyme/](https://www.cnblogs.com/billyme/)

CSDN ：[https://blog.csdn.net/horizon08](https://blog.csdn.net/horizon08)

Gitee：[https://billyme.gitee.io/blog/](https://billyme.gitee.io/blog/)

本文为 **Billyme **原创作品，仅发表于以上平台，**不允许转载**

Caddy 官网：[CaddyServer](https://caddyserver.com/)

THE ULTIMATE SERVER  
Caddy 2 is a powerful, enterprise-ready, open source web server with automatic HTTPS written in Go

### [](#升级指南🔗 "升级指南🔗")升级指南[🔗](https://caddyserver.com/docs/v2-upgrade#upgrade-guide)[](#升级指南🔗)

Caddy 2 是一个全新的代码库，从头开始编写，以改进 Caddy 1。Caddy 2 不向后兼容 Caddy 1。但不用担心，对于大多数基本设置，并没有太大的不同。本指南将帮助您尽可能轻松地过渡。

本指南不会深入研究可用的新功能——它们真的很酷，顺便说一下，你应该[学习它们](https://caddyserver.com/docs/getting-started)——这里的目标是让你快速启动并运行 Caddy 2。

### [](#菜单🔗 "菜单🔗")菜单[🔗](https://caddyserver.com/docs/v2-upgrade#menu)[](#菜单🔗)

*   [高位](https://caddyserver.com/docs/v2-upgrade#high-order-bits)
*   [脚步](https://caddyserver.com/docs/v2-upgrade#steps)
*   [HTTPS 和端口](https://caddyserver.com/docs/v2-upgrade#https-and-ports)
*   [命令行](https://caddyserver.com/docs/v2-upgrade#command-line)
*   球童档案
    *   [主要变化](https://caddyserver.com/docs/v2-upgrade#primary-changes)
    *   [基本认证](https://caddyserver.com/docs/v2-upgrade#basicauth)
    *   [浏览](https://caddyserver.com/docs/v2-upgrade#browse)
    *   [错误](https://caddyserver.com/docs/v2-upgrade#errors)
    *   [分机](https://caddyserver.com/docs/v2-upgrade#ext)
    *   [快速 cgi](https://caddyserver.com/docs/v2-upgrade#fastcgi)
    *   [压缩包](https://caddyserver.com/docs/v2-upgrade#gzip)
    *   [标题](https://caddyserver.com/docs/v2-upgrade#header)
    *   [日志](https://caddyserver.com/docs/v2-upgrade#log)
    *   [代理](https://caddyserver.com/docs/v2-upgrade#proxy)
    *   [重新目录](https://caddyserver.com/docs/v2-upgrade#redir)
    *   [改写](https://caddyserver.com/docs/v2-upgrade#rewrite)
    *   [根](https://caddyserver.com/docs/v2-upgrade#root)
    *   [状态](https://caddyserver.com/docs/v2-upgrade#status)
    *   [模板](https://caddyserver.com/docs/v2-upgrade#templates)
    *   [tls](https://caddyserver.com/docs/v2-upgrade#tls)
*   [服务文件](https://caddyserver.com/docs/v2-upgrade#service-files)
*   [插件](https://caddyserver.com/docs/v2-upgrade#plugins)
*   [获得帮助](https://caddyserver.com/docs/v2-upgrade#getting-help)

[](#高位🔗 "高位🔗")高位[🔗](https://caddyserver.com/docs/v2-upgrade#high-order-bits)[](#高位🔗)
----------------------------------------------------------------------------------------

*   “Caddy 2” 仍然只是被称为`caddy`。我们可能会使用 “Caddy 2” 来阐明哪个版本可以使过渡不那么混乱。
*   大多数用户只需要替换他们的`caddy`二进制文件和更新的`Caddyfile`配置（在测试它是否有效之后）。
*   最好不要从 Caddy 1 继承任何假设进入 Caddy 2。
*   您可能无法在 v2 中完美复制您的利基 v1 配置。通常，这是有充分理由的。
*   命令行不再用于服务器配置。
*   配置不再需要环境变量。
*   为 Caddy 2 提供配置的主要方法是通过其 [API](https://caddyserver.com/docs/api)，但也可以使用 [`caddy`命令。](https://caddyserver.com/docs/command-line)
*   您应该知道 Caddy 2 的原生配置语言是 [JSON](https://caddyserver.com/docs/json/)，而 Caddyfile 只是另一个为您转换为 JSON 的[配置适配器](https://caddyserver.com/docs/config-adapters)。极端自定义 / 高级用例可能需要 JSON，因为并非所有可能的配置都可以由 Caddyfile 表示。
*   Caddyfile 基本相同，但功能更强大；指令已更改。

[](#脚步🔗 "脚步🔗")脚步[🔗](https://caddyserver.com/docs/v2-upgrade#steps)[](#脚步🔗)
------------------------------------------------------------------------------

1.  [通过我们的入门](https://caddyserver.com/docs/getting-started)教程熟悉 Caddy 2 。
2.  如果您还没有，请执行第 1 步。说真的——我们不能强调至少知道如何使用 Caddy 2 的重要性。（它更有趣！）
3.  使用以下指南转换您的`caddy`命令。
4.  使用以下指南转换您的 Caddyfile。
5.  在本地或暂存中测试您的新配置。
6.  测试，测试，再测试
7.  部署并玩得开心！

[](#HTTPS-和端口🔗 "HTTPS 和端口🔗")HTTPS 和端口[🔗](https://caddyserver.com/docs/v2-upgrade#https-and-ports)[](#HTTPS-和端口🔗)
--------------------------------------------------------------------------------------------------------------------

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

[如果主机名或 IP 已知](https://caddyserver.com/docs/automatic-https#overview)， Caddy 2 的默认协议[_始终_](https://caddyserver.com/docs/automatic-https#overview)是 HTTPS 。这与 Caddy 1 不同，在 Caddy 1 中，默认情况下只有公开域名使用 HTTPS。现在，_每个_站点都使用 HTTPS（除非您通过明确指定端口`:80`或禁用它`http://`）。

IP 地址和 localhost 域将从[本地受信任的嵌入式 CA](https://caddyserver.com/docs/automatic-https#local-https) 颁发证书。所有其他域将使用 ZeroSSL 或 Let’s Encrypt。（这都是可配置的。）

证书和 ACME 资源的存储结构发生了变化。Caddy 2 可能会为您的站点获得新证书；但是如果您有很多证书，如果它不适合您，您可以手动迁移它们。有关详细信息，请参阅问题[#2955](https://github.com/caddyserver/caddy/issues/2955) 和[#3124](https://github.com/caddyserver/caddy/issues/3124)。

[](#命令行🔗 "命令行🔗")命令行[🔗](https://caddyserver.com/docs/v2-upgrade#command-line)[](#命令行🔗)
-----------------------------------------------------------------------------------------

`caddy`命令现在是`caddy run`.

所有命令行标志都是不同的。删除它们；所有服务器配置现在都存在于实际配置文档中（通常是 Caddyfile 或 JSON）。[您可能会在 JSON 结构](https://caddyserver.com/docs/json/)或 [Caddyfile 全局选项](https://caddyserver.com/docs/caddyfile/options)中找到您需要的内容，以替换 v1.1 中的大多数命令行标志。

像这样的命令`caddy -conf ../Caddyfile`会变成`caddy run --config ../Caddyfile`.

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

信号基本相同，只是不再支持 USR1 和 USR2。请改用 [`caddy reload`](https://caddyserver.com/docs/command-line#caddy-reload)命令或 [API](https://caddyserver.com/docs/api) 来加载新配置。

在没有任何配置的情况下运行`caddy`用于运行简单的文件服务器。Caddy 2 中的等价物是 [`caddy file-server`](https://caddyserver.com/docs/command-line#caddy-file-server).

环境变量不再相关，除了`HOME`（并且，可选地，`XDG_*`您设置的任何变量）。`CADDYPATH`被[操作系统约定所](https://caddyserver.com/docs/conventions#file-locations)取代。

[](#球童档案🔗 "球童档案🔗")球童档案[🔗](https://caddyserver.com/docs/v2-upgrade#caddyfile)[](#球童档案🔗)
------------------------------------------------------------------------------------------

[v2 Caddyfile](https://caddyserver.com/docs/caddyfile/concepts) 与您已经熟悉的非常相似。您需要做的主要事情是更改指令。

⚠️**请务必阅读新指令！**特别是如果您的配置更高级，则需要考虑许多细微差别。这些技巧可以让你快速切换，但请阅读每个指令的完整文档，以便了解升级的含义。当然，在将它们投入生产之前，请务必彻底测试您的配置。

### [](#主要变化🔗 "主要变化🔗")主要变化[🔗](https://caddyserver.com/docs/v2-upgrade#primary-changes)[](#主要变化🔗)

*   如果你提供静态文件，你需要添加一个 [`file_server`指令](https://caddyserver.com/docs/caddyfile/directives/file_server)，因为 Caddy 2 默认不假设这个。出于安全原因，默认情况下 Caddy 2 也不嗅探 MIME。如果缺少 Content-Type，您可能需要使用 [header](https://caddyserver.com/docs/caddyfile/directives/header) 指令自己设置标头。
*   在 v1 中，您只能按请求路径过滤（或 “匹配”）指令。在 v2 中，[请求匹配](https://caddyserver.com/docs/caddyfile/matchers)功能更加强大。任何向 HTTP 处理程序链添加中间件或以任何方式操纵 HTTP 请求 / 响应的 v2 指令都利用了这个新的匹配功能。[阅读有关 v2 请求匹配器的更多信息。](https://caddyserver.com/docs/caddyfile/matchers)您需要了解它们才能理解 v2 Caddyfile。
*   尽管许多[占位符](https://caddyserver.com/docs/conventions#placeholders)是相同的，但许多已更改，现在有[许多新](https://caddyserver.com/docs/modules/http#docs)占位符，包括 [Caddyfile 的简写](https://caddyserver.com/docs/caddyfile/concepts#placeholders)。
*   Caddy 2 的日志都是结构化的，默认格式是 JSON。所有日志级别都可以简单地转到要处理的同一日志（但如果需要，您可以自定义）。
*   在 Caddy 1 中通过路径前缀匹配请求的情况下，现在默认情况下 Caddy 2 中的路径匹配是精确的。如果要匹配类似 的前缀`/foo/`，则需要`/foo/*`在 Caddy 2 中匹配。

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

⚠️**仅仅因为此页面缺少 v1 指令并不意味着 v2 不能做到！**一些 v1 指令不需要，翻译不好，或者在 v2 中以其他方式实现。对于一些高级定制，您可能需要下拉到 JSON 以获得您想要的。浏览[我们的文档](https://caddyserver.com/docs/caddyfile)以找到您需要的内容！

### [](#基本认证🔗 "基本认证🔗")基本认证[🔗](https://caddyserver.com/docs/v2-upgrade#basicauth)[](#基本认证🔗)

HTTP 基本身份验证仍使用该 [`basicauth`](https://caddyserver.com/docs/caddyfile/directives/basicauth)指令进行配置。但是，Caddy 2 配置不接受明文密码。您必须对它们进行哈希处理，这 [`caddy hash-password`](https://caddyserver.com/docs/command-line#caddy-hash-password)可以提供帮助。

*   **v1：**

```
basicauth /secret/ Bob hiccup
```

*   **v2：**

```
basicauth /secret/* {
	Bob JDJhJDEwJEVCNmdaNEg2Ti5iejRMYkF3MFZhZ3VtV3E1SzBWZEZ5Q3VWc0tzOEJwZE9TaFlZdEVkZDhX
}
```

### [](#浏览🔗 "浏览🔗")浏览[🔗](https://caddyserver.com/docs/v2-upgrade#browse)[](#浏览🔗)

现在通过 [`file_server`](https://caddyserver.com/docs/caddyfile/directives/file_server)指令启用文件浏览。

*   **v1：**

```
browse /subfolder/
```

*   **v2：**

```
file_server /subfolder/* browse
```

### [](#错误🔗 "错误🔗")错误[🔗](https://caddyserver.com/docs/v2-upgrade#errors)[](#错误🔗)

自定义错误页面可以使用 [`handle_errors`](https://caddyserver.com/docs/caddyfile/directives/handle_errors).

*   **v1:** :

```
errors {
	404 404.html
	500 500.html
}
```

*   **v2:** :

```
handle_errors {
	rewrite * /{http.error.status_code}.html
	file_server
}
```

### [](#分机🔗 "分机🔗")分机[🔗](https://caddyserver.com/docs/v2-upgrade#ext)[](#分机🔗)

隐含的文件扩展名可以用 [`try_files`](https://caddyserver.com/docs/caddyfile/directives/try_files).

*   **v1：** `ext .html`
*   **v2：** `try_files {path}.html {path}`

### [](#快速cgi🔗 "快速cgi🔗")快速 cgi[🔗](https://caddyserver.com/docs/v2-upgrade#fastcgi)[](#快速cgi🔗)

假设您正在使用 PHP，则 v2 等效项是 [`php_fastcgi`](https://caddyserver.com/docs/caddyfile/directives/php_fastcgi).

*   **v1：**

```
fastcgi / localhost:9005 php
```

*   **v2：**

```
php_fastcgi localhost:9005
```

请注意，`fastcgi`v1 中的指令在后台做了很多工作，包括尝试磁盘上的文件、重写请求，甚至重定向。v2`php_fastcgi`指令也为您做这些事情，但文档提供了[扩展形式](https://caddyserver.com/docs/caddyfile/directives/php_fastcgi#expanded-form)，如果您的要求不同，您可以对其进行修改。

`php`v2 中不需要预设，因为该`php_fastcgi`指令默认采用 PHP。诸如此类的行`php_fastcgi 127.0.0.1:9000 php`会导致反向代理认为有第二个后端称为`php`，从而导致连接错误。

v2 中的子指令不同——您可能不需要任何 PHP 指令。

### [](#压缩包🔗 "压缩包🔗")压缩包[🔗](https://caddyserver.com/docs/v2-upgrade#gzip)[](#压缩包🔗)

现在，一个指令 [`encode`](https://caddyserver.com/docs/caddyfile/directives/encode)用于所有响应编码，包括多种压缩格式。

*   **v1：**

```
gzip
```

*   **v2：**

```
encode gzip
```

有趣的事实：Caddy 2 也支持`zstd`（但还没有浏览器支持）。

### [](#标题🔗 "标题🔗")标题[🔗](https://caddyserver.com/docs/v2-upgrade#header)[](#标题🔗)

[大部分没有改变](https://caddyserver.com/docs/caddyfile/directives/header)，但现在更强大，因为它可以在 v2 中进行子字符串替换。

*   **v1：**

```
header / Strict-Transport-Security max-age=31536000;
```

*   **v2：**

```
header Strict-Transport-Security max-age=31536000;
```

### [](#日志🔗 "日志🔗")日志[🔗](https://caddyserver.com/docs/v2-upgrade#log)[](#日志🔗)

启用访问记录；该 [`log`](https://caddyserver.com/docs/caddyfile/directives/log)指令仍然可以在 v2 中使用，但默认情况下，所有日志都是结构化的，编码为 JSON。

启用访问日志的推荐方法很简单：

```
log
```

它将结构化日志发送到标准错误。（您也可以发送到文件或网络套接字；请参阅 [`log`](https://caddyserver.com/docs/caddyfile/directives/log)指令文档。）

默认情况下，日志将采用[结构化](https://caddyserver.com/docs/logging) JSON 格式。如果由于遗留原因您仍然需要通用日志格式 (CLF) 的日志，您可以使用该 [`transform-encoder`](https://github.com/caddyserver/transform-encoder)插件。

### [](#代理🔗 "代理🔗")代理[🔗](https://caddyserver.com/docs/v2-upgrade#proxy)[](#代理🔗)

v2 等效项是 [`reverse_proxy`](https://caddyserver.com/docs/caddyfile/directives/reverse_proxy).

显着的子指令变化分别为`header_upstream`和；和负载平衡相关的子指令以 . 为前缀。`header_downstream``header_up``header_down``lb_`

另一个显着的区别是 v2 代理默认通过所有传入的标头（包括`Host`标头）并设置`X-Forwarded-For`标头。换句话说，v1 的 “透明” 模式基本上是 v2 中的默认模式（但如果您需要 X-Real-IP 等其他标头，则必须自己设置）。您仍然可以`Host`使用`header_up`子指令覆盖 / 自定义标头。

Websocket 代理在 v2 中 “正常工作”；无需像 v1 那样 “启用”websocket。

由于改进的匹配器支持，v2 中不再需要[重写黑客](https://caddyserver.com/docs/v2-upgrade#rewrite)，因此`without`子指令已被删除。

*   **v1：**

```
proxy / localhost:9005
```

*   **v2：**

```
reverse_proxy localhost:9005
```

### [](#重新目录🔗 "重新目录🔗")重新目录[🔗](https://caddyserver.com/docs/v2-upgrade#redir)[](#重新目录🔗)

[不变](https://caddyserver.com/docs/caddyfile/directives/redir)，除了一些关于可选状态码参数的细节。大多数配置不需要进行任何更改。

*   **v1：** `redir https://example.com{uri}`
*   **v2：** `redir https://example.com{uri}`

### [](#改写🔗 "改写🔗")改写[🔗](https://caddyserver.com/docs/v2-upgrade#rewrite)[](#改写🔗)

请求重写（“内部重定向”）的语义略有改变。如果您在 v1 中使用所谓的 “rewrite hack” 作为匹配请求而不是简单路径前缀的方式，那么在 v2 中这是完全没有必要的。

新[指令非常简单但非常强大，因为它](https://caddyserver.com/docs/caddyfile/directives/rewrite)[的`rewrite`](https://caddyserver.com/docs/caddyfile/directives/rewrite)大部分复杂性都由 v2 中的[匹配器处理：](https://caddyserver.com/docs/caddyfile/matchers)

*   **v1：**

```
rewrite {
	if {>User-Agent} has mobile
	to /mobile{uri}
}
```

*   **v2：**

```
@mobile {
	header User-Agent *mobile*
}
rewrite @mobile /mobile{uri}
```

请注意我们如何简单地使用 Caddy 2 的常用[匹配器令牌](https://caddyserver.com/docs/caddyfile/matchers)；它不再是该指令的特例。

首先删除所有重写黑客；将它们变成[命名匹配器](https://caddyserver.com/docs/caddyfile/concepts#named-matchers)。评估每个 v1`rewrite`以查看 v2 中是否真的需要它。提示：`rewrite`用于添加路径前缀然后删除相同前缀`proxy`的 v1 Caddyfile`without`是一种重写技巧，可以被消除。

您可能会发现新的 [`route`](https://caddyserver.com/docs/caddyfile/directives/route)和 [`handle`](https://caddyserver.com/docs/caddyfile/directives/handle)指令对于更好地控制高级路由逻辑很有用。

### [](#根🔗 "根🔗")根[🔗](https://caddyserver.com/docs/v2-upgrade#root)[](#根🔗)

[未更改](https://caddyserver.com/docs/caddyfile/directives/root)，但如果您的根路径以 开头`/`，则需要添加`*`匹配器标记以将其与[路径匹配器](https://caddyserver.com/docs/caddyfile/concepts#path-matchers)区分开来。

*   **v1：** `root /var/www`
*   **v2：** `root * /var/www`

因为它接受 v2 中的匹配器，这意味着您还可以根据请求更改站点根目录。

如果提供静态文件，请记住添加 [`file_server`指令](https://caddyserver.com/docs/caddyfile/directives/file_server)，因为默认情况下 Caddy 2 不假设这一点，而在 v1 中始终启用它。

### [](#状态🔗 "状态🔗")状态[🔗](https://caddyserver.com/docs/v2-upgrade#status)[](#状态🔗)

v2 等效的是 [`respond`](https://caddyserver.com/docs/caddyfile/directives/respond)，它也可以写一个响应体。

*   **v1：**

```
status 404 /secrets/
```

*   **v2：**

```
respond /secrets/* 404
```

### [](#模板🔗 "模板🔗")模板[🔗](https://caddyserver.com/docs/v2-upgrade#templates)[](#模板🔗)

指令的整体语法 [`templates`](https://caddyserver.com/docs/caddyfile/directives/templates)没有改变，但实际的模板动作 / 功能是不同的并且有很大的改进。例如，模板能够包含文件、渲染 markdown、制作内部子请求、解析前端内容等等！

[有关新功能的详细信息，请参阅文档](https://caddyserver.com/docs/modules/http.handlers.templates)。

*   **v1：** `templates`
*   **v2：** `templates`

### [](#tls🔗 "tls🔗")tls[🔗](https://caddyserver.com/docs/v2-upgrade#tls)[](#tls🔗)

该 [`tls`](https://caddyserver.com/docs/caddyfile/directives/tls)指令的基本原理没有改变，例如指定您自己的证书和密钥：

*   **v1：** `tls cert.pem key.pem`
*   **v2：** `tls cert.pem key.pem`

但是 Caddy 的[自动 HTTPS 逻辑](https://caddyserver.com/docs/automatic-https) _已经_改变，所以要注意这一点！

密码套件名称也发生了变化。

Caddy 2 中的一个常见配置是使用`tls internal`它为非开发主机名`localhost`或 IP 地址提供本地受信任的证书。

大多数网站根本不需要这个指令。

[](#服务文件🔗 "服务文件🔗")服务文件[🔗](https://caddyserver.com/docs/v2-upgrade#service-files)[](#服务文件🔗)
----------------------------------------------------------------------------------------------

我们建议使用[我们的官方 systemd 服务文件](https://caddyserver.com/docs/running#linux-service)之一进行 Caddy 部署。

如果您需要自定义服务文件，请以我们的为基础。出于充分的理由，他们已经仔细调整过！如果需要，请务必自定义您的。

[](#插件🔗 "插件🔗")插件[🔗](https://caddyserver.com/docs/v2-upgrade#plugins)[](#插件🔗)
--------------------------------------------------------------------------------

为 v1 编写的插件不会自动与 v2 兼容。v2 甚至不需要许多 v1 插件。另一方面，v2 比 v1 更容易扩展和灵活！

如果您想为 Caddy 2 编写插件，请[学习如何编写 Caddy 模块](https://caddyserver.com/docs/extending-caddy)。

### [](#使用插件构建-Caddy-2🔗 "使用插件构建 Caddy 2🔗")使用插件构建 Caddy 2[🔗](https://caddyserver.com/docs/v2-upgrade#building-caddy-2-with-plugins)[](#使用插件构建-Caddy-2🔗)

Caddy 2 可以在[交互式下载页面](https://caddyserver.com/download)通过插件下载。或者，您可以使用[自己构建 Caddy](https://caddyserver.com/docs/build)`xcaddy`并选择要包含的插件。`xcaddy`自动执行 Caddy 的 [main.go](https://github.com/caddyserver/caddy/blob/master/cmd/caddy/main.go) 文件中的指令。

[](#获得帮助🔗 "获得帮助🔗")获得帮助[🔗](https://caddyserver.com/docs/v2-upgrade#getting-help)[](#获得帮助🔗)
---------------------------------------------------------------------------------------------

如果您难以让 Caddy 正常工作，请先浏览我们的网站以获取文档。花时间尝试新事物并了解正在发生的事情 - v2 在很多方面与 v1 非常不同（但也非常熟悉）！

如果您仍然需要帮助，请加入[我们的社区](https://caddy.community/)！您可能会发现帮助他人也是帮助自己的最佳方式。

1.  部署静态网页

```
http://yousite.com {
	encode gzip 
	root * /var/web/wwwroot 
	file_server browse  
}
```

注意，如果配置根目录下有 index.html 文件，则会自动部署为静态网页，如果没有则为由 Caddy 提供的文件共享的浏览网页如下。

2.  部署 File_server

```
yousite.com {
   	root * /var/share 
   	file_server browse 
}
```

3.  反向代理

```
yousite.com {
     	reverse_proxy localhost:8082 
}
```

4.  部署
    
    ```
    caddy adapt  
    
    caddy fmt	 
    
    caddy start
    ```
    
    注意，如果为重新部署，请将最后一句 start 换为 `caddy reload`

[](#参考资源 "参考资源")参考资源[](#参考资源)
-----------------------------

1.  [Caddyserver Document](https://caddyserver.com/docs/v2-upgrade)