Nginx 配置 Finch

Nginx 作为 Finch 应用的反向代理。这支持 SSL 处理、静态文件服务和负载均衡。

反向代理概念

客户端 → Nginx（端口 80/443）→ Finch（端口 8080）

Nginx 接收请求，处理 SSL，并将它们转发给后端运行的 Finch。

Nginx 配置

upstream finch_app {
    server finch:8080;
}

server {
    listen 80;
    server_name example.com www.example.com;

    # 直接提供静态文件
    location /public/ {
        alias /app/public/;
        expires 30d;
        add_header Cache-Control "public, immutable";
    }

    # 其他所有请求转发到 Finch
    location / {
        proxy_pass http://finch_app;
        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;

        # WebSocket 支持
        proxy_http_version 1.1;
        proxy_set_header Upgrade \$http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

HTTPS 支持

server {
    listen 443 ssl;
    server_name example.com;

    ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

    location / {
        proxy_pass http://finch_app;
        proxy_set_header X-Forwarded-Proto https;
        # ... 其余 headers
    }
}

# HTTP 重定向到 HTTPS
server {
    listen 80;
    server_name example.com;
    return 301 https://\$host\$request_uri;
}

try_files 指令

对于单页应用使用 try_files：

location / {
    try_files \$uri \$uri/ @finch;
}

location @finch {
    proxy_pass http://finch_app;
}