骡子快跑Nginx反代配置教程

本文详细介绍了如何通过 Nginx 反向代理将“骡子快跑”服务安全、灵活地暴露为统一访问入口，涵盖从入门到进阶的五种实战配置方案：轻量级 80 端口直转、多服务共存的域名路由、兼顾安全与兼容的 HTTPS SSL 终止、适配内网集成的路径前缀挂载，以及面向生产环境的 upstream 高可用部署；无论你是刚起步的开发者还是运维老手，都能快速掌握按需定制的代理策略，轻松隐藏后端细节、提升服务可访问性与健壮性。

如果您在使用“骡子快跑”服务时，希望将其通过 Nginx 暴露为统一入口或隐藏后端地址，则需配置 Nginx 反向代理。以下是实现该目标的多种可行方法：

一、基础反向代理配置（监听 80 端口直转）

该方法适用于“骡子快跑”已运行在本地某端口（如 8081），且无需域名、仅需 IP 直达的轻量场景。Nginx 将所有请求无修改转发至该端口，并透传客户端真实信息。

1、编辑 Nginx 自定义配置文件：/etc/nginx/conf.d/luozikuaipao.conf

2、写入以下内容（请将 http://127.0.0.1:8081 替换为实际的“骡子快跑”服务地址）：

server {
  listen 80;
  server_name _;
  location / {
    proxy_pass http://127.0.0.1:8081;
    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 X-Forwarded-Proto $scheme;
  }
}

3、验证语法并重载配置：

nginx -t && nginx -s reload

二、基于域名的反向代理（支持多服务共存）

该方法适用于已绑定域名（如 luozi.example.com）并与其他服务共用同一台 Nginx 服务器的场景。通过 server_name 区分路由，避免端口暴露。

1、确保 DNS 已将域名解析至当前服务器 IP 地址

2、创建配置文件：/etc/nginx/conf.d/luozi-domain.conf

3、填入以下配置（替换 luozi.example.com 和后端地址）：

server {
  listen 80;
  server_name luozi.example.com;
  location / {
    proxy_pass http://127.0.0.1:8081;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_redirect off;
  }
}

4、执行配置校验与热重载：

nginx -t && systemctl reload nginx

三、HTTPS 安全反向代理（含 SSL 终止）

该方法在 Nginx 层完成 HTTPS 解密，后端仍以 HTTP 通信，兼顾安全性与兼容性。“骡子快跑”无需改造即可接入 HTTPS 访问。

1、获取并部署 SSL 证书（例如使用 Certbot）：

certbot --nginx -d luozi.example.com

2、Certbot 会自动修改配置；若需手动配置，请确认 server 块中包含：

listen 443 ssl;
ssl_certificate /etc/letsencrypt/live/luozi.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/luozi.example.com/privkey.pem;

3、在 location / 中保留与方法二一致的 proxy_pass 及 header 设置

4、添加 HTTP 强制跳转（可选）：

server {
  listen 80;
  server_name luozi.example.com;
  return 301 https://$server_name$request_uri;
}

5、重载生效：

nginx -t && nginx -s reload

四、路径前缀代理（与其它应用共享根路径）

该方法适用于“骡子快跑”需挂载在主站子路径下（如 https://example.com/luozi/），不占用独立域名或端口，适合内网管理集成场景。

1、修改“骡子快跑”启动参数，确保其内部资源路径支持子路径（如设置 base URL 为 /luozi/）

2、在主站 Nginx 配置中添加 location 块：

location /luozi/ {
  proxy_pass http://127.0.0.1:8081/;
  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_redirect http://127.0.0.1:8081/ /luozi/;
}

3、注意 proxy_pass 结尾的 /：它会剥离 /luozi/ 前缀再转发，避免后端收到冗余路径

4、测试配置并重载：

nginx -t && nginx -s reload

五、健康检查 + 备用后端代理（高可用增强）

该方法适用于“骡子快跑”存在多实例或需故障自动切换的生产环境。Nginx 通过 upstream 模块定义后端组，并启用简单健康探测。

1、在 http 块顶层（非 server 内）定义 upstream：

upstream luozikuaipao_backend {
  server 127.0.0.1:8081 max_fails=3 fail_timeout=30s;
  server 192.168.10.22:8081 backup;
}

2、在 server 的 location / 中引用：

proxy_pass http://luozikuaipao_backend;

3、确保已在 http 块中启用健康检查模块（Nginx 开源版需编译时启用 ngx_http_upstream_check_module；若未启用，则删除 max_fails/fail_timeout 参数，仅保留基础负载分发）

4、校验并重载配置：

nginx -t && nginx -s reload

以上就是《骡子快跑Nginx反代配置教程》的详细内容，更多关于骡子快跑的资料请关注golang学习网公众号！