Linux 之 Caddy

Published on 2022-08-01

Caddy V2 介绍

Caddy 2 是一个强大的、企业级的、开源的 Web 服务器，具有用 Go 编写的自动 HTTPS。也是当前唯一默认自动使用 TLS 的 Web 服务器。 使用 Caddy 2 轻松部署和扩展 HTTPS 。（静态文件、反向代理、负载平衡等）。

在线安装 Caddy

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install caddy

编写 Caddy 文件 静态文件、后端负载均衡

vim /etc/caddy/Caddyfile

linuxnbg.com {
		encode gzip
        root * /code/linuxnbg/dm-blog/public
        file_server
        
        reverse_proxy /api/* {
        to  localhost:9000 localhost:3000
        lb_policy round_robin
  }
}

反向代理

1
2
3

gitea.linuxnbg.com {
    reverse_proxy localhost:3000
}

重定向至其他域名例如百度

1
2
3

baidu.linuxnbg.com {
	redir https://www.baidu.com
}

将 linuxnbg.com 重定向至 www.linuxnbg.com

linuxnbg.com {
		redir https://www.linuxnbg.com
}

www.linuxnbg.com {
        root * /code/linuxnbg/dm-blog/public
        file_server
}

将 linuxnbg.com 重定向至 linuxnbg.com

www.linuxnbg.com {
		redir https://linuxnbg.com
}

linuxnbg.com {
        root * /code/linuxnbg/dm-blog/public
        file_server
}

负载均衡示例

linuxnbg.com {
        reverse_proxy  {
        to  localhost:9000 localhost:3000
        lb_policy round_robin
        }
}

# lb_policy 参数
first：选取第一个可用的上游
random：随机选取一个可用的上游
least_conn：选取当前请求数最少的上游,这个比较适合长连接的场景
ip_hash：根据IP的Hash值选取一个固定的上游
random_choose ：随机选取2个或者更多个上游，然后再从中选择负载最小的，n通常为2
header：这个是根据请求头的Hash选取一个固定的上游，和 ip_hash 很像，只不过它是根据指定的请求头的值进行Hash，然后选取上游的。所以这里的用法是 header <request_header_name> ，要指定一个请求头。
uri_hash：这个也和 ip_hash 很像，只不过它是根据请求的URI进行Hash，然后选取一个上游。
round_robin：这个策略是循环迭代，挨个使用一个个上游，每个上游都可以被用到，轮着来。
cookie [ []] ：如果你理解了以上几个基于Hash的负载均衡策略，那么这个 cookie 的也会很好理解，其实它就是通过cookie的值的hash来选取一个上游。在这里 name 表示要获取cookie值的 name ，默认是 lb ， secret 是用于Hash的密钥，使用的是Hamc256算法

启动服务

systemctl enable caddy && systemctl start caddy

官网：V1 与 V2 区别
https://caddyserver.com/docs/v2-upgrade

Docker 使用：

参考：https://hub.docker.com/_/caddy

docker-compose：

version: "3.7"

services:
  caddy:
    image: caddy:<version>
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
      - "443:443/udp"
    volumes:
      - $PWD/Caddyfile:/etc/caddy/Caddyfile
      - $PWD/site:/srv
      - caddy_data:/data
      - caddy_config:/config

volumes:
  caddy_data:
    external: true
  caddy_config:

version: "3.7"

services:
  caddy:
    image: caddy:<version>
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
      - "443:443/udp"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - ./site:/srv
      - ./caddy_data:/data
      - ./caddy_config:/config

数据目录不能被视为缓存。它的内容不是短暂的，也不是仅仅为了表演。Caddy 将 TLS 证书、私钥、OCSP 订书钉和其他必要信息存储到数据目录中。如果不了解其含义，则不应将其清除。