Fankex

长期札记

共享 VPS 上 Nginx 路由的最小可用方案

一台历史 VPS 同时承载静态站、Node API 和 WebSocket 服务时的 Nginx 路由与 TLS 边界。

发布于

拓扑

:443 ─ Nginx ─┬─→ / ────────→ /var/www/blog/ (静态文件)
              ├─→ /api/* ────→ 127.0.0.1:3001 (Node API)
              └─→ ws-service ─→ 127.0.0.1:10086 (WebSocket)

这份历史配置只使用一个 443 入口，由 Nginx 按路径把请求分发给静态站和本地服务。

精简配置

server {
  listen 443 ssl http2;
  server_name fankex.com;

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

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

  location / {
    try_files $uri $uri/ =404;
  }

  location /api/ {
    proxy_pass http://127.0.0.1:3001/;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
  }

  location /socket {
    if ($http_upgrade != "websocket") { return 404; }
    proxy_pass http://127.0.0.1:10086;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
  }
}

三个容易踩的坑

  1. proxy_pass 末尾斜杠会改变转发后的路径，应当明确决定是否保留前缀。
  2. WebSocket 代理需要显式设置升级请求头。
  3. 带内容哈希的字体、图片、样式和脚本适合长期不可变缓存；HTML 不适合套用同样策略。

这是 VPS 配置的耐久记录。托管平台是已批准的目标架构，迁移仍在推进；在切换得到验证前，本文不描述当前生产站点由什么设施承载。