You need to enable JavaScript to run this app. WSL+Docker环境下Caddy反向代理获取客户端真实公网IP问题求助
优惠活动
大模型
产品
解决方案
定价
更多

WSL+Docker环境下Caddy反向代理获取客户端真实公网IP问题求助

可行解决方案

1. 优先替换Docker部署方式

弃用Docker Desktop的WSL集成方案,改为在WSL发行版内直接安装原生Docker服务,Docker Desktop的跨系统端口代理机制默认会抹除所有请求的源IP,是该问题的最高发诱因。
原生Docker安装完成后,确认你的容器网络配置符合要求:

  • 执行docker inspect caddy | grep NetworkMode确认返回值为host,确保Caddy容器直接共享WSL系统的网络栈
  • 可移除docker-compose中多余的自定义personnal网络配置,host模式下自定义网络不会生效,完整的docker-compose参考如下:
services:
  caddy:
    container_name: caddy
    image: caddy:alpine
    network_mode: host
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - caddy_data:/data
      - caddy_config:/config

volumes:
  caddy_data:
  caddy_config:

2. 配置Windows侧端口转发保留源IP

WSL2默认采用NAT网络模式,Windows侧默认的端口转发不会保留客户端源IP,需要手动修改配置(该特性仅支持Windows 11 22H2及以上版本):

  1. 打开管理员权限的PowerShell,执行wsl hostname -I获取你的WSL发行版的内网IP,记为WSL_IP
  2. 依次执行如下命令,替换端口转发规则并开启源IP保留:
# 删除原有80、443端口的转发规则
netsh interface portproxy delete v4tov4 listenport=80 listenaddress=0.0.0.0
netsh interface portproxy delete v4tov4 listenport=443 listenaddress=0.0.0.0
# 新增带源IP保留的转发规则,替换<WSL_IP>为你上一步获取的IP
netsh interface portproxy add v4tov4 listenport=80 listenaddress=0.0.0.0 connectport=80 connectaddress=<WSL_IP> protocol=tcp preserveclientip=enabled
netsh interface portproxy add v4tov4 listenport=443 listenaddress=0.0.0.0 connectport=443 connectaddress=<WSL_IP> protocol=tcp preserveclientip=enabled
# 开启WSL虚拟网卡的转发功能
netsh int ipv4 set interface "vEthernet (WSL)" forwarding=enabled
  1. 配置Windows防火墙允许80、443端口的入站请求。

如果使用的是Win10或低于22H2的Win11版本,无法使用preserveclientip参数,可执行wsl --set-version <你的发行版名称> 1将WSL切换为1版本,WSL1默认采用桥接网络,无需额外配置端口转发即可保留源IP。

3. 调整Caddy配置信任代理IP

Caddy默认不信任来自内网网段的代理请求头,需要显式配置信任规则,修改你的Caddyfile如下:

# 全局块配置信任所有内网网段,也可单独在站点块内配置
{
    trusted_proxies private_ranges
}

dev.my-domain.com {
    reverse_proxy remote_container:80 {
        header_up X-Real-IP {remote_host}
        header_up X-Forwarded-For {remote_host}
    }

    tls internal {
        on_demand
    }
}

配置完成后重启Caddy容器即可正常获取客户端真实公网IP。

内容的提问来源于stack exchange,提问作者Rekwian

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.22 04:45:00