Caddy 使用教程：现代 Web 服务器和反向代理

Caddy Logo

概述

在现代 Web 开发中，Web 服务器和反向代理是确保应用稳定运行和安全访问的关键组件。无论是静态网站、动态应用还是微服务架构，都需要一个高效且可靠的服务器解决方案。Caddy 是一个功能强大的 Web 服务器和反向代理，旨在为开发者提供简单易用且功能丰富的工具，以快速搭建和管理 Web 应用。它支持自动 HTTPS、零配置和丰富的插件系统，帮助用户轻松实现复杂的功能需求。

什么是 Caddy？

Caddy 是一个开源的 Web 服务器和反向代理，由 Matt Holt 开发，并在 015 年发布。Caddy 的主要目标是简化 Web 服务器的配置和管理，提供一个零配置的解决方案。它支持自动 HTTPS、反向代理、负载均衡、静态文件服务等多种功能，并且通过插件系统可以进一步扩展其能力。Caddy 的设计理念是“简单、安全、自动化”，使得用户能够轻松地搭建和管理 Web 应用，而无需深入了解复杂的配置细节。

Caddy 的特点

自动 HTTPS：Caddy 自动为所有域名配置 HTTPS，使用 Let's Encrypt 免费证书，并自动进行证书的申请和续订。这不仅提高了安全性，还简化了证书管理流程。
零配置：Caddy 提供了零配置的解决方案，用户只需指定域名和目标路径，即可快速搭建 Web 服务器。这对于初学者和小型项目非常友好。
反向代理：Caddy 支持反向代理，可以将请求转发到后端服务器，实现负载均衡和高可用性。
负载均衡：Caddy 内置了负载均衡功能，可以轻松地将流量分发到多个后端服务器，提高系统的性能和可靠性。
插件系统：Caddy 提供了一个强大的插件系统，用户可以根据需要安装各种插件来扩展功能。例如，可以安装缓存插件来提高性能，安装认证插件来保护敏感资源。
跨平台支持：Caddy 支持多种操作系统，包括 Windows、macOS 和 Linux，确保了广泛的适用性和兼容性。
活跃的社区支持：由于其广泛的应用场景和技术优势，Caddy 拥有一个庞大而活跃的开发者社区。这不仅意味着可以获得大量的第三方资源和支持，也使得新特性能够迅速得到反馈和改进。

安装与配置

要开始使用 Caddy，首先需要完成安装过程。根据不同的操作系统和环境，具体的步骤可能会有所差异，但总体来说都非常简单。以下是针对 Windows、macOS 和 Linux 系统的基本安装指南：

在 Windows 上安装

下载安装包：访问 Caddy 官方网站并下载适用于 Windows 的安装包。
运行安装程序：双击下载的安装包，按照提示完成安装过程。确保勾选“Add Caddy to the system PATH”选项，以便后续快速启动。
启动 Caddy：安装完成后，可以通过命令行启动 Caddy。

caddy run

在 macOS 上安装

使用 Homebrew 安装：确保已经安装了 Homebrew。然后运行以下命令来安装 Caddy：

brew install caddy

启动 Caddy：安装完成后，可以通过命令行启动 Caddy。

caddy run

在 Linux 上安装

Caddy 提供了多种安装方式，包括包管理器、二进制文件和 Docker 镜像。以下是使用包管理器安装的示例：

使用 apt 安装（适用于 Debian/Ubuntu）

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

使用 yum 安装（适用于 CentOS/RHEL）

sudo rpm --import https://dl.cloudsmith.io/public/caddy/stable/gpg.key
sudo curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/config.rpm.txt' | sudo tee /etc/yum.repos.d/caddy-stable.repo
sudo yum install caddy

使用 snap 安装

sudo snap install caddy

配置 Caddy

Caddy 使用 Caddyfile 来配置服务器和反向代理。以下是一个简单的示例，展示了如何使用 Caddyfile 配置一个基本的 Web 服务器。

基本配置

创建 Caddyfile：在项目根目录下创建一个名为 Caddyfile 的文件。

example.com {
    root * /var/www/html
    file_server
}

启动 Caddy：在包含 Caddyfile 的目录下运行以下命令启动 Caddy。

caddy run

配置反向代理

Caddy 支持反向代理，可以将请求转发到后端服务器。以下是一个简单的示例，展示了如何使用 Caddyfile 配置反向代理。

反向代理配置

创建 Caddyfile：在项目根目录下创建一个名为 Caddyfile 的文件。

example.com {
    reverse_proxy localhost:8080
}

启动 Caddy：在包含 Caddyfile 的目录下运行以下命令启动 Caddy。

caddy run

配置自动 HTTPS

Caddy 自动为所有域名配置 HTTPS，使用 Let's Encrypt 免费证书，并自动进行证书的申请和续订。以下是一个简单的示例，展示了如何使用 Caddyfile 配置自动 HTTPS。

自动 HTTPS 配置

创建 Caddyfile：在项目根目录下创建一个名为 Caddyfile 的文件。

example.com {
    reverse_proxy localhost:8080
}

启动 Caddy：在包含 Caddyfile 的目录下运行以下命令启动 Caddy。

caddy run

Caddy 会自动检测域名并配置 HTTPS，无需手动申请和管理证书。

创建第一个 Caddy 服务器

有了可用的 Caddy 环境之后，就可以着手创建第一个 Caddy 服务器了。下面是一个简单的例子，展示了如何使用 Caddy 搭建一个静态网站服务器和反向代理服务器。

搭建静态网站服务器

创建项目目录：创建一个项目目录并添加静态文件。

mkdir my-static-site
cd my-static-site
echo "<h1>Hello, Caddy!</h1>" > index.html

创建 Caddyfile：在项目根目录下创建一个名为 Caddyfile 的文件。

example.com {
    root * .
    file_server
}

启动 Caddy：在包含 Caddyfile 的目录下运行以下命令启动 Caddy。

caddy run

搭建反向代理服务器

创建项目目录：创建一个项目目录并启动一个后端服务器（如 Node.js 应用）。

mkdir my-proxy-site
cd my-proxy-site
echo "console.log('Server running on port 8080');" > server.js
npm init -y
npm install express

创建 Node.js 应用：在项目根目录下创建一个名为 server.js 的文件。

// server.js
const express = require('express');
const app = express();

app.get('/', (req, res) => {
    res.send('<h1>Hello, Caddy Proxy!</h1>');
});

app.listen(8080, () => {
    console.log('Server running on port 8080');
});

启动 Node.js 应用：在项目根目录下运行以下命令启动 Node.js 应用。

node server.js

创建 Caddyfile：在项目根目录下创建一个名为 Caddyfile 的文件。

example.com {
    reverse_proxy localhost:8080
}

启动 Caddy：在包含 Caddyfile 的目录下运行以下命令启动 Caddy。

caddy run