vlambda博客
学习文章列表

Nginx 是一款非常流行的 Web 服务器，在 Github 上已有16K+Star，我们经常用它来做静态资源托管或反向代理。最近发现了一款全新的 Web 服务器Caddy，Star 数超越 Nginx，标星38K+Star。试用了一下Caddy，发现它使用起来比 Nginx 优雅多了，功能也很强大，推荐给大家！

Caddy 简介

Caddy 是一款功能强大，扩展性高的 Web 服务器，目前在 Github 上已有38K+Star。Caddy 采用 Go 语言编写，可用于静态资源托管和反向代理。

Caddy 具有如下主要特性：

• 对比 Nginx 复杂的配置，其独创的 Caddyfile配置非常简单；
• 可以通过其提供的 Admin API实现动态修改配置；
• 默认支持自动化 HTTPS 配置，能自动申请 HTTPS 证书并进行配置；
• 能够扩展到数以万计的站点；
• 可以在任意地方执行，没有额外的依赖；
• 采用 Go 语言编写，内存安全更有保证。

安装

首先我们直接在 CentOS 8 上安装 Caddy，使用 DNF 工具安装无疑是最简单的，Docker 安装方式之后也会介绍。

使用如下命令通过 DNF 工具安装 Caddy，安装成功后 Caddy 会被注册成系统服务；

dnf install 'dnf-command(copr)'
dnf copr enable @caddy/caddy
dnf install caddy

使用systemctl status caddy查看 Caddy 的状态，可以发现 Caddy 已被注册为系统服务，但是还没开启。

使用

下面我们体验下 Caddy 的基本使用，对于 Web 服务器来说都是常用的操作，你准能用的上！

基本使用

首先我们来个 Caddy 的入门使用，让 Caddy 运行在2015端口上并返回Hello, world!。

直接使用caddy命令将输出 Caddy 的常用命令，基本看介绍就知道如何使用了，标出来的是常用命令；

使用caddy start命令可以让 Caddy 服务在后台运行；

Caddy 默认使用 JSON 格式的配置文件，但由于 JOSN 格式配置书写比较麻烦，又提供了Caddyfile这种更加简洁的配置形式，使用如下命令能自动把Caddyfile转化为 JSON 配置；

caddy adapter

我们可以先创建一个名称为Caddyfile的文件，文件内容如下，然后使用caddy adapter将它转换为 JSON 配置，再使用caddy reload使配置生效，该配置将监听2015端口，并返回Hello, world!；

:2015
respond "Hello, world!"

然后，我们使用 curl 命令访问localhost:2015，将返回指定的信息；

当然了，我们还可以使用 Caddy 提供的Admin API来查看配置信息，使用如下命令即可；

curl localhost:2019/config/

当前 JSON 配置如下，如果你直接使用 JSON 配置的话需要书写如下配置，使用Caddyfile确实方便很多！

{
   "apps": {
      "http": {
         "servers": {
            "srv0": {
               "listen": [":2015"],
               "routes": [{
                  "handle": [{
                     "body": "Hello, world!",
                     "handler": "static_response"
                  }]
               }]
            }
         }
      }
   }
}

Caddyfile 基本语法

下面案例将使用Caddyfile来进行配置，我们有必要了解下它的语法，Caddyfile的具体语法规则如下。

介绍下上图中的关键字，有助于理解。

反向代理

反向代理就是当请求访问你的代理服务器时，代理服务器会对你的请求进行转发，可以转发到静态的资源路径上去，也可以转发到动态的服务接口上去。下面我们以对域名进行代理为例，来讲讲如何进行静态代理和动态代理。

静态代理

静态代理就是将请求代理到不同的静态资源路径上去，这里我们将对docs.macrozheng.com的请求代理到我的文档项目中，对mall.macrozheng.com的请求代理到 mall 的前端项目中。

首先我们修改下本机的 host 文件：

192.168.3.106 docs.macrozheng.com
192.168.3.106 mall.macrozheng.com

然后，将我们的文档项目和 mall 前端项目上传到 Caddy 的 html 目录中去，并进行解压操作：

修改Caddyfile文件，使用如下配置，修改完成后使用caddy reload命令刷新配置；

http://docs.macrozheng.com {
        root * /mydata/caddy/html/docs
        file_server browse
}

http://mall.macrozheng.com {
        root * /mydata/caddy/html/mall
        file_server browse
}

• 如果你的 Caddyfile文件格式不太合格的话，会出现如下警告，直接使用 caddy fmt --overwrite格式化并重写配置即可解决；

通过docs.macrozheng.com即可访问部署好的文档项目了：

通过mall.macrozheng.com即可访问到部署好的前端项目了。

动态代理

动态代理就是把代理服务器的请求转发到另一个服务上去，这里我们将把对api.macrozheng.com的请求代理到演示环境的 API 服务上去。

首先我们修改下本机的 host 文件，添加如下规则：

192.168.3.106 api.macrozheng.com

修改Caddyfile文件，使用如下配置，修改完成后使用caddy reload命令刷新配置；

http://api.macrozheng.com {
        reverse_proxy http://admin-api.macrozheng.com
}

之后通过api.macrozheng.com/swagger-ui.html即可访问到mall-admin的 API 文档页面了。

文件压缩

如果我们的服务器带宽比较低，网站访问速度会很慢，这时我们可以通过让 Caddy 开启 Gzip 压缩来提高网站的访问速度。这里我们以 mall 的前端项目为例来演示下它的提速效果。

我们需要修改Caddyfile文件，使用encode指令开启 Gzip 压缩，修改完成后使用caddy reload命令刷新配置；

http://mall.macrozheng.com {
        root * /mydata/caddy/html/mall
        encode {
            gzip
        }
        file_server browse
}

有个比较大的 JS 文件压缩前是1.7M；

压缩后为544K，访问速度也有很大提示；

另外，我们可以看下响应信息，如果有Content-Encoding: gzip这个响应头表明 Gzip 压缩已经启用了。

地址重写

http://docs.macrozheng.com {
        redir http://www.macrozheng.com
}

此时访问旧域名docs.macrozheng.com会直接跳转到www.macrozheng.com去。

按目录划分

有时候我们需要使用同一个域名来访问不同的前端项目，这时候就需要通过子目录来区分前端项目了。

比如说我们需要按以下路径来访问各个前端项目；

www.macrozheng.com #访问文档项目
www.macrozheng.com/admin #访问后台项目
www.macrozheng.com/app #访问移动端项目

我们需要修改Caddyfile文件，使用route指令定义路由，修改完成后使用caddy reload命令刷新配置。

http://www.macrozheng.com {
        route /admin/* {
                uri strip_prefix /admin
                file_server {
                        root /mydata/caddy/html/admin
                }
        }
        route /app/* {
                uri strip_prefix /app
                file_server {
                        root /mydata/caddy/html/app
                }
        }
        file_server * {
                root /mydata/caddy/html/www
        }
}

HTTPS

Caddy 能自动支持 HTTPS，无需手动配置证书，这就是之前我们在配置域名时需要使用http://开头的原因，要想使用 Caddy 默认的 HTTPS 功能，按如下步骤操作即可。

首先我们需要修改域名的 DNS 解析，直接在购买域名的网站上设置即可，这里以docs.macrozheng.com域名为例；

之后使用如下命令验证 DNS 解析记录是否正确，注意配置的服务器的80和443端口需要在外网能正常访问；

curl "https://cloudflare-dns.com/dns-query?name=docs.macrozheng.com&type=A" \
  -H "accept: application/dns-json"

修改Caddyfile配置文件，进行如下配置；

docs.macrozheng.com {
        root * /mydata/caddy/html/docs
        file_server browse
}

然后使用caddy run命令启动 Caddy 服务器即可，是不是非常方便！

caddy run

Docker 支持

当然 Caddy 也是支持使用 Docker 进行安装使用的，其使用和直接在 CentOS 上安装基本一致。

首先使用如下命令下载 Caddy 的 Docker 镜像；

docker pull caddy

然后在/mydata/caddy/目录下创建Caddyfile配置文件，文件内容如下；

http://192.168.3.105:80

respond "Hello, world!"

之后使用如下命令启动 caddy 服务，这里将宿主机上的Caddyfile配置文件、Caddy 的数据目录和网站目录挂载到了容器中；

docker run -p 80:80 -p 443:443 --name caddy \
    -v /mydata/caddy/Caddyfile:/etc/caddy/Caddyfile \
    -v /mydata/caddy/data:/data \
    -v /mydata/caddy/html:/usr/share/caddy \
    -d caddy

之后使用docker exec进入 caddy 容器内部执行命令；

docker exec -it caddy /bin/sh

输入 Caddy 命令即可操作，之后的操作就和我们直接在 CentOS 上安装一样了。

总结

今天体验了一把 Caddy，其强大的指令功能，让我们无需多余的配置即可实现各种功能，使用起来确实非常优雅！尤其是其能自动配置实现 HTTPS，非常不错！Nginx 能实现的功能 Caddy 基本都能实现，大家可以对比下之前写的Nginx 使用教程 ，你就会发现使用 Caddy 来实现有多么优雅！