SSR基盤の技術選定ガイド
Nginx × Node.js / Bun / Deno

選び方の現実的なパターン

公共案件では「動く」だけでなく「要求を証明できる」「長く直せる」「組織として維持できる」ことが重要。下表は典型的な評価項目であり、実際の必須要件は対象機関・システム分類・調達仕様・適用規程によって異なる。

services:
  nginx:
    image: nginx:stable-alpine  # 本番では検証済みの固定タグ/ダイジェストを使用
    ports: ["8080:80"]        # 例示用。公開経路は環境に応じて設計
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
    depends_on: [frontend, api]
    networks: [web]

  frontend:
    build: ./frontend           # Node/Bun/Deno + SSR アプリ
    expose: ["3000"]           # ホストへは公開しない
    networks: [web]

  api:
    build: ./backend
    expose: ["8080"]
    networks: [web]

networks:
  web:
    driver: bridge

server {
    listen 80;
    server_name _;

    # API コンテナが /api/ を受け取る想定
    location /api/ {
        proxy_pass http://api:8080;
        proxy_http_version 1.1;
        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_read_timeout 30s;
    }

    location / {
        proxy_pass http://frontend:3000;
        proxy_http_version 1.1;
        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;

        # Streaming SSR を妨げないための一例
        proxy_buffering off;
        proxy_read_timeout 60s;
    }
}

注意：この Nginx が HTTP で受ける場合、$scheme は http。上流 LB で HTTPS 終端しているなら、信用する LB からの Forwarded 情報を適切に受け継ぐ設計が必要。ユーザーが任意に送るヘッダーを無条件で信頼しない。

以下の条件が揃えば、Node.js / Bun / Deno の比較結果に監査可能な根拠を持たせやすくなります。

1. 同条件のデプロイ
   同じSSRフレームワーク、同じ依存パッケージ、同じ入力データ、同一クラスのCPU・RAM・ネットワーク。
2. 互換性確認
   認証、動的ルート、画像最適化、フォーム、Streaming SSR、例外処理、ファイル・暗号API、ネイティブ依存。
3. 性能と資源使用量
   同時接続・ピーク負荷・ウォームアップ・長時間運転で p50/p95/p99、エラー率、CPU、メモリ、起動時間を記録。
4. セキュリティ検証
   SAST/DAST/SCA、SBOM、イメージスキャン、権限チェック、秘密情報漏えい、キャッシュ・認証境界確認。
5. 運用・復旧検証
   異常終了時の再起動、ローリング更新、ロールバック、ログ相関、アラート、構成変更の監査証跡。
6. 選定理由の記録
   評価尺度、証跡URL、残リスク、保守責任、更新方針、再評価時期を設計審査記録として残す。