caddy简介及配置

0x01 前言

Caddy是一款快速，易用的生产型开源Web服务器，使您的工作效率更高。
适用于Windows，Mac，Linux，BSD，Solaris和Android。

在Nginx，Apache遍地的今天，你是否崇尚一个配置简单并却功能强大的web服务器呢？

0x02 特性

使用Caddyfile 轻松进行配置
默认情况下自动启用HTTPS
默认HTTP/2
虚拟主机，可以同时支持多个站点
TLS实现更安全的连接
可扩展的插件
运行在任何地方，没有外部依赖（甚至没有libc）

0x03 下载地址

直接下载

https://caddyserver.com/download/windows/amd64?license=personal

bash命令

curl https://getcaddy.com | bash -s personal

0x04 基本使用

安装目录下新建一个index.html文件

echo "hello world" > index.html

执行caddy.exe即可运行

D:\caddy_v0.10.9_windows_amd64_custom_personal>caddy.exe
Activating privacy features... done.
http://localhost:2015

caddy默认端口为2015，所以浏览器访问127.0.0.1:2015即可看到hello world。

0x05 配置

Caddyfile基本配置

新建Caddyfile文件，例如下面这样：

localhost

push
browse
websocket /echo cat
ext    .html
log    /var/log/access.log
proxy  /api 127.0.0.1:7005
header /api Access-Control-Allow-Origin *

Caddy在运行时会自动查找Caddyfile文件并应用其配置。

使用自己的域名

以管理员权限运行

caddy.exe -host example.com

使用真实的域名会触发Caddy的隐私功能，这些功能在端口80和443上运行.

0x06 Caddyfile配置详解

Caddyfile是置Caddy的配置文件。

Caddyfile位于不同的位置或名称不同，可用如下命令指定。

caddy.exe -conf D:\caddy\Caddyfile

示例如下：

localhost:8080
gzip
log ../access.log
markdown /blog {
    css /blog.css
    js  /scripts.js
}

第一行配置为站点地址
gzip是一个http指令
log为日志存储地址
包含空格的参数必须用引号括起来
Caddyfile里可以用“#”注释

使用单个Caddyfile配置多个站点时，每个站点需要使用大括号来分隔它们的配置：

mysite1.com {
    root /www/mysite1.com
}

mysite2.com {
    root /www/mysite2.com
    gzip
    log ../access.log
}

如果有许多配置相同的站点，可以使用：

https://mysite1.com, http://mysite2.com {
    ...
}

在地址和参数中允许使用环境变量。用大括号括起来即可，并且可以使用Unix或Windows可变格式：

localhost:{$PORT}
root {%SITE_ROOT%}

0x07 总结

如果你用不到nginx、apache里面的高级功能，并且急需一个配置简单，功能基本都能满足的web服务器（caddy的那么多插件可以说是很强大了），那caddy可能是不错的选择。

附：

更多配置参阅：https://caddyserver.com/docs

项目地址：https://github.com/mholt/caddy

官网：https://caddyserver.com/

欢迎访问我的个人博客 www.ixuchao.cn