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 設定的耐久記錄。託管平台是已核准的目標架構，遷移仍在進行；在切換得到驗證前，本文不描述目前正式網站由什麼設施承載。