在go-zero框架中配置nginx反向代理,核心做法是在nginx的server块中使用proxy_pass指令将请求转发到go-zero服务监听的本地端口,并配合proxy_set_header设置正确的host和x-forwarded-for头信息。这样做能让go-zero正确识别客户端真实ip和域名,同时保持http/1.1连接以支持keep-alive。若未配置这些头部,go-zero可能无法正确处理跨域或生成正确的重定向url。

Nginx如何转发请求到Go-Zero服务
Nginx通过location块匹配路径,使用proxy_pass将流量指向Go-Zero服务所在的地址。通常Go-Zero服务运行在localhost的特定端口(如8080),Nginx作为入口接收外部请求并转发。关键配置包括设置proxy_http_version为1.1以启用长连接,以及传递Client-IP等头部供Go-Zero日志或鉴权使用。

server {
listen 80;
server_name api.example.com;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Connection "";
}
}
上述配置中,proxy_pass指向本地8080端口,这是Go-Zero默认启动的服务端口。proxy_set_header确保后端能获取原始请求信息。Connection设为空字符串可清除Nginx添加的Close头,允许TCP长连接复用。测试时可通过curl -H "Host: api.example.com" http://127.0.0.1访问,验证Nginx是否正确路由。
如何处理Go-Zero的静态资源与API分离
当Go-Zero服务同时提供API和静态文件时,需在Nginx中区分处理。API请求转发至Go-Zero进程,而/static等路径直接由Nginx读取磁盘文件。这种分离提升性能,避免Go-Zero处理不必要的静态请求。配置时需明确location优先级,防止静态路径被错误代理。

server {
listen 80;
server_name api.example.com;
root /var/www/html;
location /static/ {
expires 30d;
add_header Cache-Control "public, immutable";
}
location /api/ {
proxy_pass http://127.0.0.1:8080;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
此配置中,/static/路径由Nginx直接响应,设置缓存头优化加载速度。/api/路径则代理至Go-Zero。注意location顺序:更具体的路径应放在前面,或确保无冲突。若Go-Zero返回404,检查proxy_pass是否遗漏斜杠,例如proxy_pass http://127.0.0.1:8080/会保留原URI,而http://127.0.0.1:8080会追加location路径。
Go-Zero服务在Nginx后如何获取真实客户端IP
Go-Zero服务通过X-Real-IP或X-Forwarded-For头部获取真实客户端IP。Nginx配置proxy_set_header X-Real-IP $remote_addr后,Go-Zero中间件或日志组件可解析该值。若未正确传递,服务可能记录Nginx内网IP而非用户IP,影响安全审计或地域限制逻辑。需确保Go-Zero代码中显式读取这些头部,或使用内置中间件自动处理。











