Nginx的Web服务器caddy怎么使用

Caddy简介

Caddy是一款功能强大、高度可扩展的Web服务器，目前已经获得了38K+ Star的GitHub关注。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

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

:2015

respond "Hello, world!"

当前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压缩已经启用了。

地址重写

有的时候我们的网站更换了域名，但还有用户在使用老的域名访问，这时可以通过Caddy的地址重写功能来让用户跳转到新的域名进行访问。

我们需要修改Caddyfile文件，使用redir指令重写地址，修改完成后使用caddy reload命令刷新配置；

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
}

然后在/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

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