Docker 静态站点部署指南

# 宿主机 Nginx 反向代理配置模板（占位符 __DOMAIN__ 由 run.bash 自动替换）
#
# 推荐用法（在项目根目录执行，脚本会自动替换占位符、安装配置并重载 Nginx）：
#   ./run.bash <你的域名>
#
# 手工用法：
#   sed 's/__DOMAIN__/你的域名/g' docker/nginx/example.com.conf \
#     | sudo tee /etc/nginx/sites-available/你的域名
#   sudo ln -sfn /etc/nginx/sites-available/你的域名 /etc/nginx/sites-enabled/你的域名
#   sudo nginx -t && sudo systemctl reload nginx
#
# 前置条件：证书 /etc/nginx/ssl/fullchain.pem 与 /etc/nginx/ssl/privkey.key 已存在

# 强制 HTTP → HTTPS 跳转
server {
    listen 80;
    server_name __DOMAIN__;
    return 301 https://$host$request_uri;
}

# HTTPS 服务
server {
    # 注意：Ubuntu 24.04 自带 Nginx 1.24，须保留 "ssl http2" 写法；
    #       Nginx >= 1.25.1 建议改为 "listen 443 ssl;" + "http2 on;"
    listen 443 ssl http2;
    server_name __DOMAIN__;

    # SSL 证书（使用 acme.sh 申请泛域名证书后，所有站点共用）
    ssl_certificate     /etc/nginx/ssl/fullchain.pem;
    ssl_certificate_key /etc/nginx/ssl/privkey.key;

    # SSL 安全配置
    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 off;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 1d;

    # 日志
    access_log /var/log/nginx/doc-access.log;
    error_log  /var/log/nginx/doc-error.log;

    # 客户端上传大小限制
    client_max_body_size 64M;

    # 反代到本项目的 Docker Nginx
    location / {
        proxy_pass http://127.0.0.1:8002;
        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;
    }
}

# 使用 realip 模块从上游（宿主机 Nginx）获取真实客户端 IP
# 注意：容器经过端口映射后，请求来源是 Docker 网桥网关（172.16.0.0/12），
#      而不是 127.0.0.1，所以只写 127.0.0.1 会导致真实 IP 不被信任。
set_real_ip_from 172.16.0.0/12;
set_real_ip_from 127.0.0.1;
real_ip_header X-Real-IP;
real_ip_recursive on;

server {
    listen 80;
    server_name localhost;

    root /var/www/html;
    index index.html index.htm;

    # 不对外暴露 nginx 版本号
    server_tokens off;

    # gzip 压缩
    gzip on;
    gzip_types text/plain text/css text/xml application/json application/javascript application/xml image/svg+xml;
    gzip_min_length 1k;
    gzip_vary on;

    # 静态资源缓存
    location ~* \.(gif|jpe?g|png|bmp|swf|ico|svg|webp|woff2?|ttf|eot)$ {
        expires 30d;
        access_log off;
    }

    # JS/CSS（VuePress 产物文件名带 hash，可放心缓存）
    location ~* \.(js|css)$ {
        expires 7d;
        access_log off;
    }

    # 未命中的路径返回 VuePress 生成的 404 页面，并保留 404 状态码
    error_page 404 /404.html;
    location = /404.html {
        internal;
    }

    location / {
        # 依次尝试：真实文件 -> 目录 -> 同名 .html（VuePress 产物形态），
        # 都未命中则 404，避免把不存在的地址伪装成首页 200
        try_files $uri $uri/ $uri.html =404;
    }
}