Golang Echo框架结合Nginx配置反向代理-Golang-PHP中文网

echo服务默认监听127.0.0.1导致公网不可访问，且不自动识别x-forwarded-*头，需启用forwardedbyclientip、设置trustedproxies并手动修正request.url.scheme为https。

golang echo框架结合nginx配置反向代理

为什么 `echo.New()` 启动的服务不能直接暴露给公网

因为默认监听 127.0.0.1:8080（或类似地址），Nginx 反向代理时若后端配置为 http://127.0.0.1:8080，在非本机访问时会失败；更关键的是，Echo 默认不自动识别 X-Forwarded-For 和 X-Forwarded-Proto，导致 c.RealIP() 返回空、c.Request().URL.Scheme 始终是 http，即使 Nginx 已配 HTTPS。

解决办法不是改 Nginx，而是让 Echo 主动信任代理 IP 并解析头信息：

调用 e.ForwardedByClientIP = true 启用客户端 IP 解析
设置 e.IPExtractor = echo.ExtractIPFromXFFHeader（或自定义提取逻辑）
必须显式指定可信代理网段，例如：e.TrustedProxies = []string{"127.0.0.1", "::1", "192.168.0.0/16"} —— 如果 Nginx 在同一台机器，至少要包含 127.0.0.1

Nginx 配置里 `proxy_pass` 的末尾斜杠怎么影响路径

这直接决定请求路径是否被“重写”。假设 Echo 路由注册了 GET /api/users，而 Nginx 配置如下：

location /api/ {
    proxy_pass http://127.0.0.1:8080/;
}

此时浏览器访问 /api/users，Nginx 会把 /api/ 前缀去掉，转发 /users 到 Echo —— 这是正确行为。但如果写成：

location /api/ {
    proxy_pass http://127.0.0.1:8080;
}

则会原样转发 /api/users，Echo 找不到该路由（除非你注册了 /api/users）。所以规则很简单：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

如果 proxy_pass 值以 / 结尾，Nginx 自动 strip 匹配的 location 前缀
如果没结尾斜杠，Nginx 不做路径替换，原样转发
推荐统一用带尾部 / 的写法，并确保 Echo 路由不带前缀（如只写 /users）

如何让 Echo 正确生成 HTTPS 链接（比如重定向、JWT issuer）

仅靠 Nginx 转发 HTTPS 请求还不够。Echo 默认从 c.Request().TLS 判断是否为 HTTPS，但反向代理后该字段为 nil。必须结合两个动作：

Nginx 中添加头： proxy_set_header X-Forwarded-Proto $scheme;
Echo 中启用协议感知： e.Use(middleware.HTTPSRedirect()) 本身不生效，需配合 middleware.SecureWithConfig 或手动检查头

更稳妥的做法是在中间件中统一修正 URL Scheme：

e.Use(func(next echo.HandlerFunc) echo.HandlerFunc {
    return func(c echo.Context) error {
        if c.Request().Header.Get("X-Forwarded-Proto") == "https" {
            c.Request().URL.Scheme = "https"
        }
        return next(c)
    }
})

这样后续所有 c.Request().URL.String() 或 c.Echo().Reverse() 都能拿到正确协议。

静态文件 404 或 MIME 类型错误的常见原因

当 Echo 用 e.Static("/static", "./public") 提供静态资源，Nginx 却返回 404 或把 .js 当作 text/plain，问题往往不在 Echo，而在 Nginx 是否接管了这些路径：

如果 Nginx 的 location /static/ 没配 alias 或 root，请求会落到 proxy_pass，Echo 尝试处理但找不到对应路由（因 Static() 是按前缀匹配，且不处理子目录嵌套）
正确做法是：Nginx 直接服务静态文件，不走代理。例如：
```
location /static/ {
    alias /path/to/your/public/;
    expires 1y;
}
```
若坚持让 Echo 处理，必须确保 Nginx 的 location 不截断路径，且 Echo 的 Static() 第一个参数与 location 完全一致（包括末尾斜杠）