使用 Caddy 替代 NGNIX 作为你的反向代理

Discourse · 2016 年12 月 23 日 16:35

以下是我使用 Caddy Server 运行我的测试 Discourse 实例的一些注意事项。

关于 Caddy 的优点：

他们使用 Discourse
免费 SSL，使用 Let’s Encrypt
HTTP2 和 QUIC 开箱即用
配置比 nginx 更简单

缺点：

不如 apache、nginx 等成熟。

如何操作

准备 Discourse

首先，您需要在 app.yml 中应用这些更改：

templates:
  - "templates/postgres.template.yml"
  - "templates/redis.template.yml"
  - "templates/web.template.yml"
  - "templates/web.ratelimited.template.yml"
  - "templates/web.socketed.template.yml" # <<<<<----- 这是新的

## 保留这两个注释掉
#  - "templates/web.ssl.template.yml"
#  - "templates/web.letsencrypt.ssl.template.yml"

## 保留这两个注释掉
expose:
#  - "8080:80"   # http
#  - "443:443" # https

env:
  ## 这应该被注释掉
  #LETSENCRYPT_ACCOUNT_EMAIL: mymail@gmail.com
  ## 当位于反向代理后面时，这是避免混合内容警告所必需的
  DISCOURSE_FORCE_HTTPS: true

准备 Caddy

本着 Discourse 的精神，让我们也把 Caddy 放在一个 Docker 镜像中

首先通过以下命令准备：

mkdir -p /var/caddy/data /var/caddy/config
nano /var/caddy/Caddyfile

将以下内容添加到 Caddyfile 中（使用 Caddy v2 语法）：

{
  email MYEMAILHERE@gmail.com
}

forum.example.com { # 您的域名在这里
  reverse_proxy unix//sock/nginx.http.sock
}

保存并退出。

让我们测试一下

现在您需要重建 Discourse：

cd /var/discourse
./launcher rebuild app

然后运行 Caddy：

docker run -d \
    -v /var/caddy/Caddyfile:/etc/caddy/Caddyfile \
    -v /var/caddy/data:/data \
    -v /var/caddy/config:/config \
    -v /var/discourse/shared/standalone:/sock \
    -p 80:80 -p 443:443 \
    -p 443:443/udp \
    --restart=always \
    --name caddy \
    caddy:latest

最后，您的论坛应该可以通过您的域名访问，使用 SSL + HTTP2 + QUIC。你还能比这更时髦吗。

mholt · 2016 年12 月 23 日 19:32

I run Caddy’s Discourse forums with this Caddyfile and no container:

forum.caddyserver.com

timeouts off
proxy / localhost:8080 {
	transparent
}

I just set up Discourse (with one easy tweak) and ran Caddy on the host machine.

^ This setup has been tested, and I can confirm it has been running with no glitches for months.

Whitestrake · 2016 年12 月 23 日 21:36

I like how you’ve proxied to the socket and left the ports unexposed.

Neat little guide that one can use as a guideline to easily incorporate their Discourse installation to an existing Caddy proxy, too. Cheers!

RoldanLT · 2017 年6 月 5 日 20:16

But using nginx, as I can see now.

Falco · 2017 年6 月 5 日 20:46

Well, I have more than 1 Discourse install with Caddy in the front, but I didn’t bother to replace the server header and it still shows nginx. Can be the same. Or they are just using the simple Discourse install and have no need to run a reverse proxy at all in the front.

pfaffman · 2017 年6 月 5 日 21:18

My Discourse sites behind Caddy show nginx as the server too. I guess that transparent setting might make Caddy, uh, transparent.

mholt · 2017 年6 月 14 日 14:55

That might be a bug from a recent change, it didn’t used to do that.

honggian · 2017 年9 月 8 日 19:16

Dear @Falco

Thank you so much for your posting.

I would like to install discourse using caddy condition, but I was confused with your docker command.

I never heard about the caddy, so I follow the digital ocean document

My question is, in the current server situation, Should I change the path
from etc/Caddyfile to /etc/caddy/Caddyfile?

docker run -d \
    -v /var/caddy/Caddyfile:/etc/Caddyfile \
    -v /var/caddy:/root/.caddy \
    -v /var/discourse/shared/standalone:/sock \
    -p 80:80 -p 443:443 \
    -p 80:80/udp -p 443:443/udp \
    --restart=always \
    --name caddy \
    --entrypoint "/usr/local/bin/caddy" \
    abiosoft/caddy -quic -email MYEMAILHERE@gmail.com -agree --conf /etc/Caddyfile --log stdout

Sincerely

tachibanalolo · 2021 年12 月 2 日 09:23

这在我的服务器上不起作用。对我来说，我使用了：

unix:/var/discourse/shared/standalone/nginx.http.sock

这是用于 caddy v1。对于 caddy v2，请使用：

unix//var/discourse/shared/standalone/nginx.http.sock

只需将“:”替换为“/”。

Falco · 2021 年12 月 2 日 13:55

如果您遵循 OP 中的指南并在 Docker 中运行 Caddy 并按规定挂载卷，那么该路径将有效。如果您没有遵循指南，那么路径将会不同。

RPaladin · 2022 年7 月 22 日 21:56

他们的论坛域名和子域名现在已在此下命名。

ARHAEEM · 2023 年6 月 10 日 22:30

抱歉顶起了旧帖子，我正在尝试让 Caddy 与 Discourse 协同工作。在您的 Caddy 配置中，您使用了“proxy”，但当我使用它时，它会显示语法错误并且无效。难道“proxy”现在已经被更改为“reverse_proxy”了吗？

这是我的配置：

forum.example.com {
    reverse_proxy / unix//var/discourse/shared/standalone/nginx.http.sock {
        transparent
    }
}

pfaffman · 2023 年6 月 11 日 11:40

我想是的。你试过了吗？

bananaman · 2025 年3 月 13 日 07:44

谢谢 Matt！
我可以确认，不使用容器的设置在 2025 年仍然有效

forum.website.com {
        reverse_proxy localhost:8080
}

只使用“proxy”不起作用。

manuel · 2025 年5 月 16 日 15:20

对我也很好用！

但是，我遇到了“混合内容”警告，这是遵循那个非常直接的设置出现的：

为了解决这些问题，我不得不在配置文件 (app.yml 或 web_only.yml) 的 env 部分添加一个额外的指令：

# 强制 SSL
DISCOURSE_FORCE_HTTPS: true

manuel · 2025 年6 月 3 日 09:57

作为参考，以下是使用 Caddy 作为反向代理的非 Docker 化设置的当前步骤：

1) 调整 Discourse 配置文件

注释掉证书

templates:
#  - "templates/web.ssl.template.yml"
#  - "templates/web.letsencrypt.ssl.template.yml"

更改端口映射并禁用 443 映射

expose:
- "8080:80"   # http
# - "443:443" # https

强制 HTTPS 来提供静态文件
```
env:
DISCOURSE_FORCE_HTTPS: true
```

2) 重建 Discourse

./launcher rebuild app

3) 设置 Caddy

安装 Caddy，仅使用官方默认设置：Install — Caddy Documentation
调整 /etc/caddy/Caddyfile
```
forum.example.com {
      reverse_proxy localhost:8080
}
```
如果您有多个站点，您可以仅列出您的域名：
```
forum.example.com, forum2.example.com, forum3.example.com {
      reverse_proxy localhost:8080
}
```
您还可以运行 systemctl status caddy 来验证默认配置文件位置。

4) 运行 Caddy

systemctl start caddy

更改后重新加载配置：

cd /etc/caddy
caddy reload

David_Ghost · 2025 年6 月 3 日 10:30

嘿，感谢你的教程。

对于非多站点设置，使用 Caddy 有什么优势吗？例如性能或其他方面？

manuel · 2025 年6 月 3 日 10:40

我不太清楚你说的是什么… 我现在只是在我的暂存服务器上使用这个设置，因为它真的很容易添加或更改实例，而不会遇到证书问题。

DeanMarkTaylor · 2025 年10 月 13 日 20:56

我在多站点设置中做了一些类似的事情来简化 SSL 设置……
……但更新到了 Caddy v2，并使用 docker-compose 进行多站点设置。

在 web.yml 中：

只使用 templates/web.socketed.template.yml，不使用 SSL yml 文件。
注释掉端口 \"443:443\"、\"80:80\" 等。
添加 DISCOURSE_HOSTNAME_ALIASES 和 DISCOURSE_FORCE_HTTPS: true

这使用了最新版本的 Caddy 2，这就是为什么它可能与上面此主题中提到的一些 Caddy v1 配置看起来不同。

这是最初创建相关文件并启动 caddy 的 bash 文件：

#!/usr/bin/env bash

# 创建必要的目录
mkdir -p /var/caddy
mkdir -p /var/caddy/data
mkdir -p /var/caddy/config



# 创建简化的 Caddyfile
cat > /var/caddy/Caddyfile << 'EOF'
{
    email your-email-address-here@example.com
}

community1.example.com, community2.example.com, community3.example.com {
    reverse_proxy unix//sock/nginx.http.sock
}
EOF

# 创建 docker-compose.yml
cat > /var/caddy/docker-compose.yml << 'EOF'
services:
  caddy:
    image: caddy:latest
    container_name: caddy-proxy
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
      - "443:443/udp"
    volumes:
      - /var/caddy/Caddyfile:/etc/caddy/Caddyfile
      - /var/caddy/data:/data
      - /var/caddy/config:/config
      - /var/discourse/shared/standalone:/sock
EOF

# 导航到 caddy 目录并启动
cd /var/caddy

# 启动 Caddy
docker compose up -d

lxbnks · 2025 年12 月 3 日 11:31

谢谢！我想从 Nginx 切换到 Caddy。你仍然有 unix//sock/nginx.http.sock——你是在同时使用 Nginx 和 Caddy 吗？

话题		回复	浏览量
Need help setting up discourse using Caddy as rproxy Self-hosting hosting	7	1591	2022 年9 月 9 日
Run other websites on the same machine as Discourse Self-Hosting advanced-setup , how-to	66	136767	2025 年2 月 23 日
Installing Discourse Behind Reverse Proxy using recommended (supported) installation Self-hosting	6	3473	2025 年2 月 10 日
Starting a second Discourse forum on the same VPS Self-hosting	4	3347	2017 年8 月 1 日
Installing Discourse With N8N using Caddy in same cloud server (Hetzner Cloud) Self-hosting unsupported-install	2	1002	2023 年6 月 10 日