Genarrative/deploy/nginx/genarrative.conf

# 生产域名需要在部署前替换为真实域名，并由 certbot 或等价流程写入 HTTPS 证书配置。
log_format genarrative_upstream
    '$remote_addr - $remote_user [$time_local] "$request" '
    '$status $body_bytes_sent "$http_referer" "$http_user_agent" '
    'request_time=$request_time upstream_connect_time=$upstream_connect_time '
    'upstream_header_time=$upstream_header_time upstream_response_time=$upstream_response_time '
    'upstream_status=$upstream_status request_id=$request_id';

upstream genarrative_api {
    server 127.0.0.1:8082;
    keepalive 64;
}

limit_conn_zone $binary_remote_addr zone=genarrative_api_conn:10m;
limit_req_zone $binary_remote_addr zone=genarrative_api_rps:10m rate=300r/s;
limit_req_zone $binary_remote_addr zone=genarrative_admin_rps:10m rate=30r/s;

# 维护期间允许真实 TCP 内网来源继续访问整站；不信任请求头伪造的客户端地址。
geo $remote_addr $genarrative_internal_client {
    default 0;
    127.0.0.0/8 1;
    10.0.0.0/8 1;
    172.16.0.0/12 1;
    192.168.0.0/16 1;
    169.254.0.0/16 1;
    ::1 1;
    fc00::/7 1;
    fe80::/10 1;
}

server {
    listen 80;
    server_name genarrative.example.com;
    access_log /var/log/nginx/genarrative.access.log genarrative_upstream;
    error_log /var/log/nginx/genarrative.error.log warn;
    limit_conn_status 429;
    limit_conn_log_level warn;
    limit_req_status 429;
    limit_req_log_level warn;

    location /.well-known/acme-challenge/ {
        root /var/www/html;
    }

    location / {
        return 301 https://$host$request_uri;
    }
}

server {
    listen 443 ssl http2;
    server_name genarrative.example.com;
    access_log /var/log/nginx/genarrative.access.log genarrative_upstream;
    error_log /var/log/nginx/genarrative.error.log warn;
    limit_conn_status 429;
    limit_conn_log_level warn;
    limit_req_status 429;
    limit_req_log_level warn;

    gzip on;
    gzip_vary on;
    gzip_proxied any;
    gzip_comp_level 5;
    gzip_min_length 1024;
    gzip_types
        text/plain
        text/css
        text/javascript
        application/javascript
        application/json
        application/xml
        application/xml+rss
        image/svg+xml;

    # __GENARRATIVE_BROTLI_DIRECTIVES__

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

    root /srv/genarrative/web;
    index index.html;

    include /etc/nginx/snippets/genarrative-maintenance.conf;

    location ^~ /admin/api/ {
        default_type application/json;
        limit_conn genarrative_api_conn 64;
        limit_req zone=genarrative_admin_rps burst=16 nodelay;

        if ($genarrative_maintenance) {
            return 503 '{"ok":false,"error":{"code":"MAINTENANCE","message":"服务维护中"}}';
        }

        proxy_pass http://genarrative_api/admin/api/;
        proxy_http_version 1.1;
        proxy_set_header Connection "";
        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_set_header X-Request-Id $request_id;
    }

    location = /admin {
        error_page 503 /maintenance.html;

        if ($genarrative_maintenance) {
            return 503;
        }

        return 301 /admin/;
    }

    location ^~ /admin/assets/ {
        error_page 503 /maintenance.html;

        if ($genarrative_maintenance) {
            return 503;
        }

        try_files $uri =404;
    }

    location ^~ /admin/ {
        error_page 503 /maintenance.html;

        if ($genarrative_maintenance) {
            return 503;
        }

        try_files $uri $uri/ /admin/index.html;
    }

    location ^~ /assets/ {
        try_files $uri =404;
    }


    # 临时兼容主站仍在使用的 /api/* HTTP facade；前端完成 SpacetimeDB SDK 迁移后删除。
    location ~ ^/api(?:/|$) {
        default_type application/json;
        # 中文注释：创作接口会携带参考图 Data URL，Nginx 只放行到 api-server；真实大小限制仍由路由 DefaultBodyLimit 和业务字节校验负责。
        client_max_body_size 64m;
        limit_conn genarrative_api_conn 64;
        limit_req zone=genarrative_api_rps burst=64 nodelay;

        if ($genarrative_maintenance) {
            return 503 '{"ok":false,"error":{"code":"MAINTENANCE","message":"服务维护中"}}';
        }

        proxy_pass http://genarrative_api;
        proxy_http_version 1.1;
        proxy_buffering off;
        proxy_read_timeout 3600s;
        proxy_send_timeout 3600s;
        add_header X-Accel-Buffering no always;
        proxy_set_header Connection "";
        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_set_header X-Forwarded-Host $host;
        proxy_set_header X-Request-Id $request_id;
    }

    # 生产公网不再暴露旧生成资源代理和健康检查入口。
    location ~ ^/(generated-|healthz|readyz) {
        return 404;
    }

    # SpacetimeDB 只开放 TypeScript SDK 运行所需的最小公网路由。
    location ~ ^/v1/database/[^/]+/subscribe$ {
        if ($genarrative_maintenance) {
            return 503;
        }

        proxy_pass http://127.0.0.1:3101;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";
        proxy_set_header Host $host;
        proxy_read_timeout 3600s;
    }

    location ^~ /v1/identity {
        if ($genarrative_maintenance) {
            return 503;
        }

        proxy_pass http://127.0.0.1:3101;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";
        proxy_set_header Host $host;
    }

    location ^~ /v1/ {
        return 404;
    }

    # BEGIN GENARRATIVE MAIN SPA ROUTES
    location = / {
        error_page 503 /maintenance.html;

        if ($genarrative_maintenance) {
            return 503;
        }

        try_files /index.html =404;
    }

    location ~* "^/(?:creation|editor/canvas|profile|project)/?$" {
        error_page 503 /maintenance.html;

        if ($genarrative_maintenance) {
            return 503;
        }

        try_files $uri /index.html =404;
    }
    # END GENARRATIVE MAIN SPA ROUTES

    location / {
        error_page 503 /maintenance.html;
        error_page 404 /404.html;

        if ($genarrative_maintenance) {
            return 503;
        }

        try_files $uri $uri/ =404;
    }
}