FastapiAdmin/docker/nginx/nginx.conf

# ============================================
# FastapiAdmin Nginx 配置文件
# ============================================

# 自动检测 CPU 核心数，多核服务器自动利用所有核心
worker_processes auto;

# 错误日志输出到 stdout（Docker 容器日志最佳实践）
error_log /var/log/nginx/error.log warn;
pid /var/run/nginx.pid;

events {
    worker_connections 2048;
    multi_accept on;
    use epoll;
}

http {
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;

    # ==================== 基础优化 ====================
    sendfile on;
    tcp_nopush on;
    tcp_nodelay on;
    keepalive_timeout 65;
    keepalive_requests 1000;
    types_hash_max_size 2048;
    client_max_body_size 50m;
    server_tokens off;

    # ==================== 日志格式 ====================
    log_format main '$remote_addr - $remote_user [$time_local] "$request" '
                    '$status $body_bytes_sent "$http_referer" '
                    '"$http_user_agent" "$http_x_forwarded_for" '
                    '$request_time $upstream_response_time';

    access_log /var/log/nginx/access.log main buffer=32k flush=5s;

    # ==================== Gzip 压缩 ====================
    gzip on;
    gzip_vary on;
    gzip_proxied any;
    gzip_comp_level 6;
    gzip_min_length 256;
    gzip_types
        text/plain
        text/css
        text/javascript
        application/javascript
        application/json
        application/xml
        application/x-javascript
        image/svg+xml
        image/x-icon;

    # ==================== 安全头 ====================
    # 全局安全头，默认被所有 server 块继承
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header X-Content-Type-Options "nosniff" always;
    add_header X-XSS-Protection "1; mode=block" always;
    add_header Referrer-Policy "strict-origin-when-cross-origin" always;

    # ==================== 速率限制 ====================
    # API 请求速率限制: 每 IP 每秒 30 个请求
    limit_req_zone $binary_remote_addr zone=api_limit:10m rate=30r/s;
    # 连接数限制: 每 IP 最多 100 个并发连接
    limit_conn_zone $binary_remote_addr zone=conn_limit:10m;

    # ==================== HTTP -> HTTPS 重定向 ====================
    server {
        listen 80;
        listen [::]:80;
        server_name service.fastapiadmin.com;

        # Let's Encrypt ACME 验证支持
        location /.well-known/acme-challenge/ {
            root /var/www/html;
        }

        # 健康检查端点（HTTP 同样响应）
        location /health {
            access_log off;
            return 200 "OK";
            add_header Content-Type text/plain;
        }

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

    # ==================== HTTPS Server ====================
    server {
        listen 443 ssl;
        listen [::]:443 ssl;
        http2 on;
        server_name service.fastapiadmin.com;

        # ==================== SSL 配置 ====================
        ssl_certificate     /etc/nginx/ssl/server.pem;
        ssl_certificate_key /etc/nginx/ssl/server.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;
        ssl_prefer_server_ciphers on;
        ssl_session_cache shared:SSL:10m;
        ssl_session_timeout 10m;
        ssl_session_tickets off;
        # HSTS (31536000 秒 = 1 年)
        add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;

        # ==================== 官网（根路径） ====================
        location / {
            root /usr/share/nginx/html/docs/dist;
            index index.html;
            try_files $uri $uri/ /index.html;
            expires 30d;
            add_header Cache-Control "public, no-transform";
        }

        # ==================== 前端（/web） ====================
        location /web {
            alias /usr/share/nginx/html/web/dist;
            index index.html;
            try_files $uri $uri/ /web/index.html;
            expires 30d;
            add_header Cache-Control "public, no-transform";
        }

        # ==================== 小程序 H5（/app） ====================
        location /app {
            alias /usr/share/nginx/html/app/dist/build/h5;
            index index.html;
            try_files $uri $uri/ /app/index.html;
            expires 30d;
            add_header Cache-Control "public, no-transform";
        }

        location /api/v1/common/health {
            access_log off;
            return 200 "OK";
            add_header Content-Type text/plain;
        }

        # ==================== 后端 API 代理 ====================
        location /api/v1/ {
            # 速率限制: 每 IP 每秒最多 30 个 API 请求
            limit_req zone=api_limit burst=20 nodelay;
            limit_conn conn_limit 100;

            # 后端服务器地址（结尾 / 会去掉 /api/v1 前缀再转发）
            proxy_pass http://backend:8001/;

            # WebSocket 支持
            proxy_http_version 1.1;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection "upgrade";
            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 60s;
            proxy_read_timeout 60s;

            # 代理缓存禁用
            proxy_buffering off;
            proxy_cache off;
        }

        # 不带 /api/v1/ 前缀的请求直接返回 404
        location = /api/v1 {
            return 404;
        }

        # ==================== Nginx 健康检查 ====================
        location /nginx-health {
            access_log off;
            return 200 "OK";
            add_header Content-Type text/plain;
        }

        # ==================== 错误页面 ====================
        error_page 500 502 503 504 /50x.html;
        location = /50x.html {
            root /usr/share/nginx/html;
            internal;
        }
    }
}