如何在Laravel Forge中配置Nginx以访问Metabase

在Laravel Forge环境下部署Metabase后，配置Nginx反向代理时出现502网关错误及端口3000连接超时问题，核心原因是原有Laravel站点的Nginx配置与Metabase代理逻辑冲突，同时缺少必要的代理头和超时配置。以下是具体修改方案：

错误原因分析 #

1. 直接在原有location /块中同时配置try_files和proxy_pass会导致Nginx路由逻辑混乱，try_files会优先处理Laravel的静态文件和路由请求，不会将请求转发到Metabase。
2. 502错误通常是Metabase服务未正常监听127.0.0.1:3000，或Nginx缺少必要的代理头部，或连接超时设置过短导致。

方案一：使用子路径代理（不影响原有Laravel站点） #

保留原有Laravel站点的Nginx配置，新增专门的location块用于代理Metabase请求：

# 保留原有Laravel项目的根路径配置
location / {
    try_files $uri $uri/ /index.php?$query_string;
}

# 添加Metabase代理配置，通过 http://你的服务器IP/metabase 访问
location /metabase/ {
    # 注意末尾的斜杠，确保路径转发正确
    proxy_pass http://127.0.0.1:3000/;
    # 传递必要的请求头，确保Metabase能正确识别客户端信息
    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;
    # 增加超时配置，解决连接超时问题
    proxy_connect_timeout 30s;
    proxy_send_timeout 30s;
    proxy_read_timeout 30s;
}

方案二：使用独立域名代理（推荐，更清晰） #

如果有额外域名，在Laravel Forge中创建新站点，使用独立域名配置Metabase代理：

# FORGE CONFIG (DO NOT REMOVE!)
include forge-conf/metabase-site/before/*;

server {
    listen 80;
    listen [::]:80;
    server_name metabase.yourdomain.com;
    server_tokens off;

    # FORGE SSL (DO NOT REMOVE!)
    # ssl_certificate;
    # ssl_certificate_key;

    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384;
    ssl_prefer_server_ciphers off;
    ssl_dhparam /etc/nginx/dhparams.pem;

    add_header X-Frame-Options "SAMEORIGIN";
    add_header X-XSS-Protection "1; mode=block";
    add_header X-Content-Type-Options "nosniff";

    # FORGE CONFIG (DO NOT REMOVE!)
    include forge-conf/metabase-site/server/*;

    location / {
        proxy_pass http://127.0.0.1:3000;
        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;
        proxy_connect_timeout 30s;
        proxy_send_timeout 30s;
        proxy_read_timeout 30s;
    }

    access_log off;
    error_log  /var/log/nginx/metabase-error.log error;
}

# FORGE CONFIG (DO NOT REMOVE!)
include forge-conf/metabase-site/after/*;

验证步骤 #

修改配置后，执行以下操作确保服务正常：

1. 重启Nginx：sudo nginx -s reload
2. 验证Metabase服务状态：
   • 执行curl http://127.0.0.1:3000，若返回Metabase的HTML内容，说明服务正常监听
   • 若使用systemd管理Metabase，执行systemctl status metabase确认服务处于active (running)状态
3. 检查防火墙：本地代理无需开放3000端口，但确保服务器内部无防火墙规则阻止127.0.0.1的3000端口连接

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