Contents

Ubuntu安装Caddy V2

caddy官方目前在主推v2系列。v2系列与之前的v1系列差异很大,之前写的在 Ubuntu 中安装 Caddy Server已经不适用了。

所以重写一篇,记录caddy v2.0 的安装与配置。

如果是从caddy v1.0 升级到 v2.0,可直接看官方的 upgrade guide

安装

1
2
3
4
echo "deb [trusted=yes] https://apt.fury.io/caddy/ /" \
    | sudo tee -a /etc/apt/sources.list.d/caddy-fury.list
sudo apt update
sudo apt install caddy

上面的命令安装完之后,caddy会安装到/usr/bin/caddy,而之前v1.0系列默认安装到/usr/local/bin/caddy,这里也会导致很多坑。默认使用的配置文件依然是/etc/caddy/Caddyfile,但语法已经改变了,所以依然很多坑。

此外,https/ssl的证书的存放路径,也由之前的/etc/ssl/caddy变到了/var/lib/caddy

配置

caddy.service

早期的 caddy v1.0脚本,默认以 www-data用户运行 caddy;但是,caddy v2.0默认以caddy用户运行caddy,这会导致很多坑,例如与PHP配合时会提示permission denied等。

所以,还是以www-data 运行caddy比较好。需要修改配置文件caddy.service

1
sudo nano /lib/systemd/system/caddy.service

将其中的

1
2
3
[Service]
User=caddy
Group=caddy

改为

1
2
3
[Service]
User=www-data
Group=www-data

修改之后,caddy.service内容为:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
[Unit]
Description=Caddy
Documentation=https://caddyserver.com/docs/
After=network.target

[Service]
User=www-data
Group=www-data
ExecStart=/usr/bin/caddy run --environ --config /etc/caddy/Caddyfile
ExecReload=/usr/bin/caddy reload --config /etc/caddy/Caddyfile
TimeoutStopSec=5s
LimitNOFILE=1048576
LimitNPROC=512
PrivateTmp=true
ProtectSystem=full
AmbientCapabilities=CAP_NET_BIND_SERVICE

[Install]
WantedBy=multi-user.target

修改之后,需要重载,并需要修正文件/文件夹的权限。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
sudo groupadd -g 33 www-data
sudo useradd \
  -g www-data --no-user-group \
  --home-dir /var/www --no-create-home \
  --shell /usr/sbin/nologin \
  --system --uid 33 www-data
sudo mkdir /var/log/caddy
sudo touch /var/log/caddy/access.log
sudo touch /var/log/caddy/common_log  
sudo chown -R www-data:www-data /var/lib/caddy/
sudo chown -R www-data:www-data /etc/caddy/
sudo chown -R www-data:www-data /var/log/caddy/
sudo systemctl daemon-reload
sudo systemctl restart caddy
sudo systemctl enable caddy

Caddyfile

caddy v2系列的配置文件与v1有了较大的变化,常见的变化可参考官方的 upgrade guide

目前,我使用的是:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
example.com {

    ## log
    log {
	output file         /var/log/caddy/access.log
	format single_field /var/log/caddy/common_log
    }

    # encode
    encode zstd gzip

    # web root.
    root * /var/www/example.com

    # Enable the static file server.
    file_server

    # websocket proxy to backend 45232
    @example_websocket_proxy {
        path /example_ws_path
        header Connection Upgrade
        header Upgrade websocket
    }
    reverse_proxy @example_websocket_proxy localhost:45232

    # serve a PHP site through php-fpm:
    #  php_fastcgi localhost:9000
    php_fastcgi unix//run/php/php-fpm.sock
}
# Refer to the Caddy docs for more information:
# https://caddyserver.com/docs/caddyfile

caddy v1.0 系列支持http/2代理(也称h2ch2),但v2.0目前却缺乏这方面的支持。不知何时才能支持。