Docker中Caddy无法识别UPSTREAMS环境变量问题求助

问题背景 #

在Docker中使用Caddy作为反向代理对接Node.js服务时，通过环境变量UPSTREAMS传递多个上游地址，Caddy无法识别；但直接在Caddyfile中硬编码上游地址时，reverse_proxy可以正常工作。

问题原因 #

1. Docker Compose环境变量引号问题：原配置中UPSTREAMS被双引号包裹，导致环境变量实际值包含引号，Caddy将带引号的整个字符串视为单个无效上游地址。
2. 变量解析逻辑限制：即使去掉引号，直接使用{$UPSTREAMS}时，Caddy的文本替换后可能无法自动将空格分隔的字符串拆分为多个上游参数。

解决步骤 #

1. 修正Docker Compose配置 #

编辑docker-compose.yaml，移除UPSTREAMS的双引号：

services:
  caddy:
    build:
      context: .
      dockerfile: Dockerfile.caddy
    container_name: caddy
    restart: unless-stopped
    environment:
      - DOMAIN=${DOMAIN:-http://localhost:80}
      - CERT_EMAIL=$CERT_EMAIL
      - UPSTREAMS=node-server-1:5000 node-server-2:5000
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - ./caddy_data:/data
      - ./caddy_config:/config
    ports:
      - 80:80
      - 443:443

2. 调整Caddyfile的上游配置 #

修改Caddyfile中reverse_proxy块的to指令，使用split函数显式拆分环境变量值：

{$DOMAIN} {
    rate_limit {
        zone myzone {
            key {remote_ip}
            events 20
            window 1m
        }
    }

    handle {
        reverse_proxy {
            to {split({env.UPSTREAMS})}
            lb_policy round_robin
            lb_try_duration 1s
        }
    }

    handle_errors 429 {
        respond "You're being rate limited. Please try again in 1 minute."
    }
}

3. 验证配置 #

重启Caddy容器使修改生效：

docker-compose up -d --force-recreate caddy

查看容器日志确认启动正常：

docker logs caddy

额外说明 #

• {split({env.UPSTREAMS})}会将环境变量按空格拆分为多个独立的上游地址，确保Caddy正确识别每个Node.js服务。
• 如果你的Caddy版本支持直接解析空格分隔的{$UPSTREAMS}替换结果，也可以保留to {$UPSTREAMS}，但split方式兼容性更强。

内容的提问来源于stack exchange，提问作者Inder