文档
一个 项目

反向代理快速入门

本指南将向您展示如何快速启动并运行一个生产就绪的、带或不带 HTTPS 的反向代理。

前提条件

  • 基本的终端/命令行技能
  • caddy 已添加到您的 PATH 环境变量
  • 一个正在运行的后端进程用于代理

本教程假设您有一个后端 HTTP 服务正在 127.0.0.1:9000 运行。这些命令适用于 Linux，但相同的原则适用于其他操作系统。

您可以无需配置文件即可运行一个简单的反向代理，或者您可以使用配置文件以获得更高的灵活性和控制力。

命令行

要在您的机器上启动一个从端口 2080 到端口 9000 的明文 HTTP 代理

caddy reverse-proxy --from :2080 --to :9000

然后尝试一下

curl -v 127.0.0.1:2080

reverse-proxy 命令 旨在用于快速简便的反向代理。（如果您的需求很简单，您可以在生产环境中使用它。）

Caddyfile

在当前工作目录中，创建一个名为 Caddyfile 的文件，内容如下

:2080

reverse_proxy :9000

该配置文件大致相当于上面的 caddy reverse-proxy 命令。

然后，从同一目录运行

caddy run

然后尝试您的代理

curl -v 127.0.0.1:2080

如果您更改了 Caddyfile，请务必 重新加载 Caddy。

这是一个简单的例子。您可以使用 reverse_proxy 指令 做更多的事情。

从客户端到代理的 HTTPS

如果 Caddy 知道主机名（域名），它将 自动且默认地 通过 HTTPS 提供您的代理服务。如果您省略 --from 标志，caddy reverse-proxy 命令将默认使用 localhost，或者您可以将 Caddyfile 的第一行替换为代理的域名。

  • 如果您使用 localhost 或任何以 .localhost 结尾的域名，Caddy 将使用自动续订的自签名证书。首次执行此操作时，您可能需要输入密码，因为 Caddy 尝试将其 CA 的根证书安装到您的信任存储中。
  • 如果您使用任何其他域名，Caddy 将尝试获取一个公开信任的证书；请确保您的 DNS 记录指向您的机器，并且端口 80 和 443 对公众开放并指向 Caddy。

如果您不指定端口，Caddy 默认使用 443 端口用于 HTTPS。在这种情况下，您还需要绑定到低端口的权限。以下是在 Linux 上执行此操作的几种方法

  • 以 root 身份运行（例如 sudo -E）。
  • 或者运行 sudo setcap cap_net_bind_service=+ep $(which caddy) 以授予 Caddy 此特定功能。

这是最基本的 caddy reverse-proxy 命令，可为您提供 HTTPS

caddy reverse-proxy --to :9000

然后尝试一下

curl -v https://localhost

您可以使用 --from 标志自定义主机名

caddy reverse-proxy --from example.com --to :9000

如果您没有绑定到低端口的权限，您可以从更高的端口进行代理

caddy reverse-proxy --from example.com:8443 --to :9000

如果您正在使用 Caddyfile，只需将第一行更改为您的域名，例如

example.com

reverse_proxy :9000

从代理到后端的 HTTPS

如果后端支持 TLS，Caddy 也可以在自身和后端之间使用 HTTPS 进行代理。只需在您的后端地址中使用 https://

caddy reverse-proxy --from :2080 --to https://localhost:9000

这要求后端的证书受到运行 Caddy 的系统的信任。（除非明确配置，否则 Caddy 不信任自签名证书。）

当然，您也可以在两端都使用 HTTPS

caddy reverse-proxy --from example.com --to https://example.com:9000

这提供从客户端到代理以及从代理到后端的 HTTPS。

如果您要代理到的主机名与您要代理自的主机名不同，您将需要使用 --change-host-header 标志

caddy reverse-proxy \
	--from example.com \
	--to https://localhost:9000 \
	--change-host-header

默认情况下，Caddy 会传递所有 HTTP 标头，包括 Host 标头，并且 Caddy 从 Host 标头派生 TLS ServerName。--change-host-header 将 Host 标头重置为后端的 Host 标头，以便 TLS 握手可以成功完成。在上面的示例中，它将从 example.com 更改为 localhost:9000（并且 localhost 将在 TLS 握手中使用）。