Docker部署Caddy无法反向代理至宿主机Code-Server求助

我已经在Caddy社区发布过这个问题，现在也希望在这里获得帮助。

问题详情 #

• 目标：让Docker容器内的Caddy将pancakepuncher.com/code的流量转发到宿主机上以systemd服务运行的Code-Server。
• 限制条件：
  • Code-Server不容器化，需直接与宿主机交互（终端访问、本地文件操作等）；
  • Caddy容器不使用Host或Bridge模式，需保留Docker网络优势以支持未来转发到其他容器（如Portainer、个人项目）。
• 现状：Code-Server监听0.0.0.0:8080，Caddy作为系统服务运行时正常转发，但容器化后完全失败；已确认Docker网络网关为172.20.0.1，但仍无法连通。

错误信息 #

Caddy日志关键错误：

dial tcp 172.20.0.1:8080: i/o timeout

请求返回502状态码。

环境配置 #

• Caddy版本：v2.7.6
• 系统环境：Debian 12 + Docker Compose
• 启动命令：docker compose up -d
• Docker Compose、Caddyfile配置详见原文

已尝试方案 #

• 测试过hostname -I列出的所有非公网IP；
• 修改Code-Server监听地址为网关IP、同网段IP、0.0.0.0、localhost、127.0.0.1；
• 用whoami容器做连通性测试，Caddy可正常转发到该容器，但无法连接宿主机的Code-Server。

解决方案 #

1. 开放宿主机防火墙的网段访问权限 #

Debian 12默认使用ufw，需允许Docker所在网段访问Code-Server的8080端口：

# 允许Docker网关所属网段访问8080
sudo ufw allow from 172.20.0.0/16 to any port 8080
# 重启防火墙生效
sudo ufw reload

若使用iptables等其他防火墙工具，需对应配置允许该网段的端口访问规则。

2. 确认Code-Server的监听配置 #

打开Code-Server的配置文件（通常路径为~/.config/code-server/config.yaml），确保bind-addr设置为0.0.0.0:8080（允许所有网卡监听），而非仅绑定127.0.0.1。修改后重启服务：

sudo systemctl restart code-server

3. 使用Docker内置的宿主机映射（推荐） #

Docker 20.10+版本支持通过extra_hosts直接映射宿主机，避免网关IP变动的问题。在Docker Compose配置中添加：

services:
  caddy:
    # 其他原有配置（镜像、端口、卷挂载等）
    extra_hosts:
      - "host.docker.internal:host-gateway"

之后在Caddyfile中将反向代理目标改为http://host.docker.internal:8080即可。

4. 容器内连通性验证 #

进入Caddy容器内部，测试与宿主机的连通性，定位问题：

# 进入Caddy容器（替换为你的容器名称）
docker exec -it caddy sh
# 测试ping宿主机网关
ping 172.20.0.1
# 测试端口连通性
telnet 172.20.0.1 8080

如果ping不通，检查Docker网络的配置；如果telnet不通，回到第一步确认防火墙规则。

5. 正确配置Caddy反向代理路径 #

确保Caddyfile的路径转发规则正确，示例配置：

pancakepuncher.com {
    handle_path /code* {
        reverse_proxy http://172.20.0.1:8080 {
            header_up Host {host}
            header_up X-Real-IP {remote_host}
            header_up X-Forwarded-For {remote_host}
            header_up X-Forwarded-Proto {scheme}
        }
    }
    # 其他站点配置（如Portainer等）
}

handle_path会自动去除/code前缀后转发给Code-Server，若需保留路径，可改用handle并调整路径转发逻辑。

内容的提问来源于stack exchange，提问作者Alex A.