二进制包安装方式并不会将caddy安装为一个服务（service），仅仅是一个可以执行的程序。这种方式更适合开发和调试。直接到caddy的下载站点：https://caddyserver.com/download下载适合自己操作系统的压缩包就可以了。如果是Linux系统，将解压缩后的caddy命令复制到/usr/local/bin目录下就可以了。例如：

cp caddy_linux_amd64 /usr/local/bin/caddy

在Debian、Ubuntu或Raspbian基于debian包的系统可以使用deb包的安装方式。这种方式会将caddy安装为一个systemd service，同时，caddy-api这个服务也会被自动安装。

在caddy的配置方式中，Caddyfile文件对人来说是比较容易阅读的。我们编辑一个文件，名为Caddyfile（没有扩展名，C字母大写，其他字母小写！）。在Caddyfile中加入如下内容：

:2015
respond "Hello, world!"

现在停止caddy的运行，使用（Ctrl+C），如果是运行在守护进程状态下的话可以使用caddy stop命令。然后，使用如下的命令再次运行caddy

caddy run

这个命令会在当前目录下寻找Caddyfile文件，并直接加载它。如果Caddyfile这个文件保存在其他位置，那需要指明具体的路径：

caddy run --config /path/to/Caddyfile

实际上，上面的命令是下面一行命令的缩写，省掉了--adapter caddyfile，因为默认情况下caddy使用Caddyfile adapter，

caddy run --adapter caddyfile --config /path/to/Caddyfile

接下来，在另外一个终端中输入：curl https://localhost，就会看到”Hello World!“。

现在我们更改Caddyfile，在其中定义两个站点，内容如下：

localhost {
	respond "Hello, world!"
}

localhost:2016 {
	respond "Goodbye, world!"
}

我们使用API的方式将这些内容加载到系统中，使用如下的命令：

curl localhost:2019/load \
	-X POST \
	-H "Content-Type: text/caddyfile" \
	--data-binary @Caddyfile

然后使用curl https://localhost:2016命令，便会看到“Goodbye, world!”

使用caddy run或caddy start启动caddy，不要带任何配置文件。现在caddy已经在“空转”了，我们使用Heredoc^[4]的方式，通过API接口给它加载一些配置：

curl localhost:2019/load \
    -X POST \
    -H "Content-Type: application/json" \
    -d @- << EOF
    {
        "apps": {
            "http": {
                "servers": {
                    "hello": {
                        "listen": [":2015"],
                        "routes": [
                            {
                                "handle": [{
                                    "handler": "static_response",
                                    "body": "Hello, world!"
                                }]
                            }
                        ]
                    }
                }
            }
        }
    }
EOF

把这个配置加载到caddy以后，我们在客户端使用浏览器访问caddy服务器的2015端口，http://192.168.31.2:2015，或者也可以使用命令：curl http://192.168.31.2:2015。我们会看到“Hello, world!”

用Heredoc字符流的方式加载配置还是有点费劲的，前面的例子只是让我们知道caddy的这种工作方式。更常用的方式还是把配置写在一个文件中，然后再加载。

接下来我们把前面的配置内容写入到一个简单的JSON配置文件中，然后同样使用curl命令完成加载。文件名称为caddy.json，其内容如下：

  1 {
  2     "apps": {
  3         "http": {
  4             "servers": {
  5                 "hello": {
  6                     "listen": [":2015"],
  7                     "routes": [
  8                         {
  9                             "handle": [{
 10                                 "handler": "static_response",
 11                                 "body": "Hello, world!"
 12                             }]
 13                         }
 14                     ]
 15                 }
 16             }
 17         }
 18     }
 19 }

现在使用如下的命令加载这个配置文件：

curl localhost:2019/load \
	-X POST \
	-H "Content-Type: application/json" \
	-d @caddy.json

同样，我们可以在客户端通过浏览器或curl来访问一下2015端口：

curl http//192.168.31.2:2015

如果能看到Hello,world!那就代表刚才的配置文件已经生效了。

	提示
	实际上caddyAPI在大多数情况下，是为其他程序所设计的一种接口。

接下来我们更新一下caddy.json文件，定义两个站点，一个在2015端口，一个在2016端口：

  1 {
  2     "apps": {
  3         "http": {
  4             "servers": {
  5                 "hello": {
  6                     "listen": [":2015"],
  7                     "routes": [
  8                         {
  9                             "handle": [{
 10                                 "handler": "static_response",
 11                                 "body": "Hello, world!"
 12                             }]
 13                         }
 14                     ]
 15                 },
 16                 "bye": {
 17                     "listen": [":2016"],
 18                     "routes": [
 19                         {
 20                             "handle": [{
 21                                 "handler": "static_response",
 22                                 "body": "Goodbye, world!"
 23                             }]
 24                         }
 25                     ]
 26                 }
 27             }
 28         }
 29     }
 30 }

然后再次使用如下的命令来加载这个文件：

curl localhost:2019/load \
	-X POST \
	-H "Content-Type: application/json" \
	-d @caddy.json

然后在客户端分别访问：http://192.168.31.2:2015和http://192.168.31.2:2016，会看到“Hello, world!”及“Goodbye, world!”。

	提示
	caddy.json这个文件也可以通过命令行来使用：caddy start --config caddy.json

在caddy启动以后，我们随时都可以在caddy server上使用curl命令通过GET请求来查看配置：

curl localhost:2019/config/

这个命令直至输出的结果是JSON格式的，非常不易读，可以使用jq命令来将其格式化：

curl localhost:2019/config/ | jq

可以看出，输出的结果和我们的配置是一致的。可以使用这个命令将当前的配置导出。

我们会看到一个JSON输出，caddy使用caddyfile adapter（config adapter），将Caddyfile转换为JSON（Caddy's native JSON structure）格式。

在使用caddy run或caddy start启动caddy以后，可以在另外一个终端中运行下面的命令：

curl localhost:2019/config/

通过这个命令，可以查看当前的配置。

使用命令启动文件服务器，可以在终端中切换到站点所在的目录，例如：/var/www/html，然后在这个目录下执行：caddy file-server，这样一个基本的静态文件服务器就在80端口开始运行了。如果在/var/www/html目录下有个index.html文件的话，在客户端的浏览器中输入：http://192.168.31.2/就可以直接看到这个文件了。

如果想要caddy运行在其他的端口，可以使用caddy file-server --listen :2015这个命令。

如果目录中没有index.html文件，并且想能够列出/var/www/html中的文件，可以使用caddy file-server --browse这个命令。

如果想要使用指定的目录作为根目录，可以使用caddy file-server --root /path/to/yourSite这个命令。

使用Caddyfile配置文件的方式实现文件服务器也非常简单，如果只是简单的启动它，下面的两行配置就够了：

localhost
file_server

如果想要变换端口，只需要将localhost更改为localhost:2015就可以了。

如果想要目录下的文件可列表浏览，可以将file_server替换为file_server browse

如果想要从客户端的浏览器中可以访问，我们需要下面的配置：

192.168.31.2
root * /var/www/
file_server browse

使用如下的命令：

caddy reverse-proxy --from :2016 --to 192.168.31.10:80

当我们在客户端的浏览器中输入http://192.168.31.2:2016时，就会看到Server1站点的内容。

更改Caddyfile的内容，如下：

:2016

reverse_proxy 192.168.31.10:9000

然后使用caddy run命令来启动caddy，再次在客户端的浏览器中输入http://192.168.31.2:2016时，就会看到Server1站点的内容。

建立一个根目录/usr/local/work/lognovel.com，在这个目录里建立一个index.html文件，Caddyfile配置如下：

lognovel.com www.lognovel.com {
	root * /usr/local/work/lognovel.com
	file_server
}

在浏览器中输入http://lognovel.com或http://www.lognovel.com，会看到index.html里的内容。我们可以通过浏览器地址栏左的小锁icon来查看https证书的情况。

图 2.2. caddy https

使用下面的命令也可以达到上面配置文件相同的效果：

caddy file-server --domain lognovel.com --root /usr/local/work/lognovel.com