Caddy标准HTTP指令简介

本文将对Caddy的29个标准HTTP指令做一个汇总，并简要的描述每个指令的作用．

所有的指令的详细介绍都可以在 https://caddyserver.com/docs/ 路径下查看,如查看proxy的详细介绍可访问 https://caddyserver.com/docs/proxy

指令	说明	默认情况的处理
basicauth	HTTP基本认证
bind	用于给TCP监听套接字绑定IP地址	默认绑定在为通配符地址
browse	目录浏览功能
errors	配置HTTP错误页面以及错误日志	响应码>=400的返回一个纯文本错误消息,也不记录日志
expvar	将运行时或者当前进程的一些信息(内存统计,启动命令,协程数等)以JSON格式暴露在某个路径下.
ext	对于不存在的路径,自动追加后缀名后再次尝试
fastcgi	fastcgi配置
gzip	gzip压缩配置	不压缩,但是如果网站目录下存在.gz或者.br压缩文件,Caddy就会使用. 如果客户端支持gzip格式的压缩压缩文件,Caddy确保不压缩图片,视频和已压缩文件
header	设置响应头,可以增加,修改和删除.如果是代理的必须在proxy指令中设置
import	从其他文件或代码段导入配置,减少重复
index	索引文件配置	index(default).html(htm/txt)
internal	X-Accel-Redirect 静态转发配置, 该路径外部不可访问,caddy配置的代理可以发出X-Accel-Redirect请求
limit	设置HTTP请求头( one limit applies to all sites on the same listener)和请求体的大小限制	默认无限制.设置了之后,如果超出了限制返回413响应
log	请求日志配置
markdown	将markdown文件渲染成HTML
mime	根据响应文件扩展名设置Content-Type字段
on	在服务器启动/关闭/刷新证书的时候执行的外部命令
pprof	在某个路径下展示profiling信息
proxy	反向代理和负载均衡配置
push	开启和配置HTTP/2服务器推
redir	根据请求返回重定向响应(可自己设置重定向状态码)
request_id	生成一个UUID,之后可以通过{request_id}占位符使用
rewrite	服务器端的重定向
root	网站根目录配置
status	访问某些路径时,直接返回一个配置好的状态码
templates	模板配置
timeouts	设置超时时间:读请求的时间/读请求头的时间/写响应的时间/闲置时间(使用keep-alive时)	Keep-Alive超时时间默认为5分钟
tls	HTTPS配置,摘自文档的一句话: Since HTTPS is enabled automatically, this directive should only be used to deliberately override default settings. Use with care, if at all.
websocket	提供一个简单的Websocket服务器

X-Accel-Redirect

X-Accel-Redirect一般用于需要验证权限的文件的下载

• nginx X-Accel-Redirect头的利用: 包含Python示例

占位符清单

https://caddyserver.com/docs/placeholders

via,https://toaco.github.io/2018/03/05/Caddy%E6%A0%87%E5%87%86HTTP%E6%8C%87%E4%BB%A4%E7%AE%80%E4%BB%8B/