xiaoxia-saas/infra/docker/nginx.conf

# ===========================================
# 小虾剪辑 SaaS — Nginx 配置 (Production 默认)
# ===========================================
#
# 环境隔离说明:
#   - staging 使用 nginx-staging.conf  → proxy_pass → xiaoxia-api-staging:8000
#   - production 使用此文件            → proxy_pass → xiaoxia-api-production:8000
#   - 构建时通过 ARG NGINX_CONF 选择配置文件
#

server {
    listen 80;
    server_name _;
    root /usr/share/nginx/html;
    index index.html;

    # Gzip compression
    gzip on;
    gzip_vary on;
    gzip_min_length 1024;
    gzip_types text/plain text/css text/xml text/javascript application/javascript application/json application/xml+rss;

    client_max_body_size 800m;

    # SPA routing - all routes to index.html
    # 注意：不能加 $uri/，否则 /assets 等与构建产物目录同名的路由会被当成目录访问，返回 403
    # index.html must never be cached — it contains chunk references
    location = /index.html {
        add_header Cache-Control "no-cache, no-store, must-revalidate";
        add_header Pragma "no-cache";
        expires 0;
    }

    location / {
        try_files $uri /index.html;
        # HTML 文档（含 try_files 回退的 SPA 路由，如 /login /app/dashboard）一律 no-cache，
        # 每次校验 ETag/Last-Modified，保证发版后旧标签页重新加载拿到新 chunk 引用；
        # 带 hash 的静态资源由下方 ~* \.(js|css...) location 优先匹配，不受影响、保持 immutable
        add_header Cache-Control "no-cache" always;
    }

    # API proxy
    # Production environment: proxy to production API container on isolated network
    # Use static container name to avoid URI stripping issues with variable-based proxy_pass
    resolver 127.0.0.11 valid=10s;
    resolver_timeout 5s;
    location /api/ {
        proxy_pass http://xiaoxia-api-production:8000/api/;
        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_read_timeout 300s;
        proxy_send_timeout 300s;
        proxy_request_buffering off;
    }

    # Generated files proxy
    location /generated-files/ {
        alias /app/generated/;
    }

    # Cache static assets
    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
        expires 1y;
        add_header Cache-Control "public, immutable";
    }
}