Skip to content
FEE
Frontend Engineering Essentials
Senior Level

純 Single-Page Application(SPA)幾乎沒有伺服器端攻擊面,除了 API 層之外。「伺服器」只是一個提供靜態檔案的 CDN:HTML、JavaScript 與 CSS。不存在 Node.js 程序、環境變數存取、資料庫連線或檔案系統。能利用純 SPA 的攻擊者,只能在瀏覽器沙箱中活動。

然而,一旦 Next.js App Router、Nuxt、SvelteKit 或 Remix 進入技術棧,情況就完全不同了。前端程式碼現在在 Node.js 程序中執行,可存取環境變數、資料庫(透過 Prisma、Drizzle 或直接驅動程式)、私有網路上的內部 API,以及本機檔案系統。同一位原本構建安全 SPA 的開發者,現在正在操作一台伺服器——伴隨伺服器而來的安全紀律,必須完整適用。

最重要的心智模型轉變,是理解 Next.js 中的 Server Actions。一個標記了 'use server' 的函式,看起來像 TypeScript 函式呼叫,感覺像在調用輔助函式。但實際上,'use server' 會將這個函式編譯成位於 /_next/action 的 HTTP POST 端點,並賦予一個雜湊值作為 action ID。任何 HTTP 客戶端——curl、Postman、惡意網站上的腳本——都可以直接呼叫它,並傳入任意 payload。'use server' 的意思是「這在伺服器上執行」,而非「這受到保護」。身份驗證、授權、輸入驗證和速率限制,都不是框架提供的;它們是開發者的責任,必須在每個 action 上、每次都做到。

本文涵蓋從 SPA 遷移至 SSR 時,影響最大的五類威脅:Server-Side Request Forgery(SSRF)、環境變數暴露、伺服器端渲染中的 HTML 注入、Node.js 中的原型污染(Prototype Pollution),以及未受保護的 Server Actions。

設計思考 ​

為什麼 SSR 完全改變了前端安全模型 ​

純 SPA 無法被用於 Server-Side Request Forgery——因為根本沒有伺服器來發出請求。瀏覽器的同源政策(Same-Origin Policy)阻止客戶端 fetch 到 http://169.254.169.254/ 後讀取回應,而且雲端 metadata 服務本就無法從公共網際網路存取。

一旦 Next.js 或 Nuxt 進入技術棧,攻擊者只要在 SSR 路由中找到 URL 注入點,就能從 Node.js 程序發出請求。該程序在 VPC 內部運行,與內部服務處於同一網路,雲端 metadata 端點可達,環境變數已載入 process.env。SSRF、路徑穿越(path traversal)、憑證暴露與原型污染,全都成了前端團隊的責任——不是因為團隊選擇承擔後端工作,而是框架選擇執行伺服器程式碼。

為什麼 NEXT_PUBLIC_ 外洩如此普遍 ​

NEXT_PUBLIC_ 前綴系統是一個帶有誤導性命名慣例的破壞性陷阱(footgun)。在建置時,Next.js 執行全域搜尋替換:原始碼中對 process.env.NEXT_PUBLIC_STRIPE_SECRET_KEY 的每一個引用,都會被替換為字面字串值。最終產出的 JavaScript 會被推送到每個載入頁面的瀏覽器。

開發者從文件或 Stack Overflow 複製範例、倉促命名變數,或來自後端環境,認為「環境變數存放在伺服器上」。變數名稱中的 NEXT_PUBLIC_ 字串,是一個承諾:該值是公開的。建置完成後,沒有任何機制能讓 NEXT_PUBLIC_ 變數保密——值已內嵌在靜態 JavaScript 中。唯一的補救方式是改用正確命名的變數(不加前綴)並重新建置。

Nuxt 的 NUXT_PUBLIC_ 和 Vite-based 框架的 VITE_ 遵循相同的行為模式。

為什麼 Server Actions 需要 API 等級的審查 ​

Server Actions 的開發者體驗刻意設計成函式呼叫風格。你在 .ts 檔案中定義函式、匯出它、在 Client Component 中引入,並從事件處理器呼叫它。框架負責序列化。程式碼讀起來像是客戶端在調用本地函式。

在底層,Next.js 為每個匯出的 'use server' 函式分配一個雜湊值,將其註冊為 /_next/action 的 HTTP POST 處理器,並依 action ID 路由進來的請求。沒有內建的身份驗證閘道器。一個會刪除資料庫記錄的 Server Action,可以這樣被調用:

bash
curl -X POST https://your-app.com/ \
  -H "Next-Action: <action-hash>" \
  -H "Content-Type: application/json" \
  -d '["target-record-id"]'

框架會執行它。每一條適用於 Express 路由處理器的安全紀律,同樣適用於 Server Action。Next.js 文件明確指出:「你應該將 Server Actions 視為可以透過直接 POST 請求觸達,並在每個 action 內部驗證身份驗證和授權。」

一個關鍵補充:Next.js Middleware 在 Edge runtime 上執行;Server Actions 在 Node.js runtime 上執行。它們是獨立的請求處理器。在 Middleware 層進行身份驗證,無法保護直接繞過 Middleware 發出 POST 請求的 Server Action。

為什麼序列化最少資料很重要 ​

當 Server Component 從資料庫取得一筆資料列,並將其作為 prop 傳遞給 Client Component 時,整個物件都會被序列化進嵌入 HTML 回應的 RSC payload。任何工程師都可以開啟瀏覽器 DevTools,前往 Network 分頁,找到初始頁面載入回應,並審查跨越 Server/Client 邊界傳遞的每個物件的每個欄位。

Prisma model 通常包含因內部目的而添加的欄位:軟刪除用的 deletedAt、排名演算法用的 internalScore、客服人員用的 adminNotes、連結帳單的 stripeCustomerId。這些欄位都不該出現在客戶端 bundle 中。正確的做法是定義一個 mapper,只選取 Client Component 需要的欄位,並只傳遞映射後的物件。這就是資料最小化原則:RSC payload 只包含必要內容。

最佳實踐 ​

必須(MUST)使用 @t3-oss/env-nextjs 或 t3-env 定義環境變數,並設定明確的 server 和 client schema。 從 Client Component 模組存取伺服器端變數,必須(MUST)在建置時丟出錯誤,在部署前攔截意外的前綴暴露問題。

必須(MUST)為每個接受使用者提供 URL 的 SSR fetch 實作 URL 驗證輔助函式。 使用 new URL() 解析,確認 protocol === 'https:',解析 hostname,並拒絕 RFC 1918 私有範圍(10.x.x.x、172.16-31.x.x、192.168.x.x)、loopback(127.x.x.x、::1)和 link-local(169.254.x.x)中的任何位址。每個接受使用者提供 URL 的 SSR 路由,必須(MUST)在將 URL 傳入 fetch() 之前呼叫此輔助函式。

必須(MUST)在每個 Server Action 的最開頭加入 auth() 呼叫。 使用 NextAuth 的 auth()、Clerk 的 currentUser() 或你的 session 函式庫。若未通過身份驗證,必須(MUST)在讀取任何輸入之前立即拋出錯誤。Middleware 身份驗證無法保護 Server Action 免受直接 POST 請求的攻擊。

必須(MUST)使用 Zod 以明確的 schema 驗證 Server Action 輸入。 在任何資料庫操作之前呼叫 inputSchema.parse(rawInput)。Zod schema 也是封鎖原型污染鍵(prototype-pollution keys)的注入點:必須(MUST)添加 .refine() 以拒絕任何名為 __proto__、constructor 或 prototype 的鍵。

必須(MUST)為每個跨越 Server/Client 邊界的資料庫查詢結果建立 selectFields mapper 函式。 Mapper 必須(MUST)明確列出 Client Component 需要的每個欄位。所有其他欄位在源頭就被捨棄,而非事後過濾。

必須(MUST)在 <script> 標籤中嵌入 JSON 時使用 serialize-javascript(或手動轉義)。 禁止(MUST NOT)對內聯 <script> 內容使用原始的 JSON.stringify——包含 </script> 的使用者值會終止標籤並允許任意 HTML 注入。

應該(SHOULD)對包含環境變數存取、資料庫客戶端和內部 API 憑證的模組使用 server-only 套件。 客戶端引入時的建置錯誤會在 CI 中被捕捉;執行時的資料洩漏則會在資安事故通知中被發現。應該(SHOULD)將此套件視為所有伺服器專屬模組的強制防護措施。

運作原理 ​

攻擊向量 1 — SSRF: 使用者控制的 URL 參數被傳遞給 SSR 路由中的 fetch()。Node.js 程序從 VPC 內部發出請求,觸達雲端 metadata 服務或公共網際網路無法存取的內部服務。

攻擊向量 2 — 環境變數暴露: 以 NEXT_PUBLIC_ 前綴命名的密鑰,在建置時被內嵌進 JavaScript bundle。任何開啟 DevTools 的訪客都能讀取它。

攻擊向量 3 — HTML 注入: 未轉義的使用者資料,透過 dangerouslySetInnerHTML 或 <script> 標籤中的原始 JSON.stringify,流入 SSR 輸出。XSS payload 在初始 HTML 回應中傳遞——在 hydration 之前,在 CSP nonce 套用之前。

範例 ​

1. URL 驗證輔助函式(SSRF 防護) ​

typescript
// lib/validate-url.ts
import { isIP } from 'net';

const PRIVATE_RANGES = [
  /^10\.\d+\.\d+\.\d+$/,
  /^172\.(1[6-9]|2\d|3[01])\.\d+\.\d+$/,
  /^192\.168\.\d+\.\d+$/,
  /^127\.\d+\.\d+\.\d+$/,
  /^169\.254\.\d+\.\d+$/,
  /^::1$/,
  /^fc00:/i,
  /^fe80:/i,
];

export function assertSafeUrl(raw: string): URL {
  let parsed: URL;
  try {
    parsed = new URL(raw);
  } catch {
    throw new Error('無效的 URL');
  }

  if (parsed.protocol !== 'https:') {
    throw new Error('只允許 HTTPS URL');
  }

  const hostname = parsed.hostname.toLowerCase();

  // 拒絕落在私有範圍內的原始 IP 位址
  if (isIP(hostname) !== 0) {
    for (const range of PRIVATE_RANGES) {
      if (range.test(hostname)) {
        throw new Error('URL 解析至私有或保留位址');
      }
    }
  }

  // 拒絕已知的內部主機別名
  if (hostname === 'localhost' || hostname.endsWith('.internal')) {
    throw new Error('URL 解析至內部位址');
  }

  return parsed;
}

// 在 SSR 路由處理器中使用
// app/api/og-preview/route.ts
import { assertSafeUrl } from '@/lib/validate-url';

export async function GET(request: Request) {
  const { searchParams } = new URL(request.url);
  const rawUrl = searchParams.get('url') ?? '';

  const safeUrl = assertSafeUrl(rawUrl); // 若為 SSRF 目標則拋出錯誤

  const response = await fetch(safeUrl.toString(), {
    headers: { Accept: 'text/html' },
    redirect: 'error', // 不跟隨可能繞過 hostname 檢查的重新導向
  });

  // ... 處理並回傳 OG metadata
}

2. 含有身份驗證、Zod 驗證和速率限制的 Server Action ​

typescript
// app/actions/delete-post.ts
'use server';

import { auth } from '@/lib/auth';           // NextAuth / Clerk / 你的 auth 函式庫
import { rateLimit } from '@/lib/rate-limit'; // 例如:Upstash Redis rate limiter
import { db } from '@/lib/db';
import { z } from 'zod';

const deletePostInput = z.object({
  postId: z.string().uuid(),
}).strict(); // 拒絕任何額外的鍵

export async function deletePost(rawInput: unknown) {
  // 1. 身份驗證——最優先,在其他任何事之前
  const session = await auth();
  if (!session?.user) {
    throw new Error('未通過身份驗證');
  }

  // 2. 速率限制
  const { success } = await rateLimit(session.user.id, 'delete-post', { max: 10, window: '1m' });
  if (!success) {
    throw new Error('超過速率限制');
  }

  // 3. 輸入驗證
  const input = deletePostInput.parse(rawInput);

  // 4. 授權——驗證所有權
  const post = await db.post.findUnique({ where: { id: input.postId } });
  if (!post) throw new Error('找不到資源');
  if (post.authorId !== session.user.id) {
    throw new Error('禁止存取');
  }

  // 5. 執行變更
  await db.post.delete({ where: { id: input.postId } });
}

3. 使用 @t3-oss/env-nextjs 的型別安全環境變數 ​

typescript
// env.ts(在各處引入此檔案,而非直接使用 process.env)
import { createEnv } from '@t3-oss/env-nextjs';
import { z } from 'zod';

export const env = createEnv({
  server: {
    // 這些變數永遠不會傳送至客戶端。從 Client Component 存取 = 建置錯誤。
    DATABASE_URL: z.string().url(),
    STRIPE_SECRET_KEY: z.string().min(1),
    NEXTAUTH_SECRET: z.string().min(32),
    INTERNAL_API_KEY: z.string().min(1),
  },
  client: {
    // 這些變數會被內嵌進客戶端 bundle。只放真正公開的值。
    NEXT_PUBLIC_APP_URL: z.string().url(),
    NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY: z.string().startsWith('pk_'),
  },
  // 讓 T3 env 在 Next.js 中正確讀取 process.env
  runtimeEnv: {
    DATABASE_URL: process.env.DATABASE_URL,
    STRIPE_SECRET_KEY: process.env.STRIPE_SECRET_KEY,
    NEXTAUTH_SECRET: process.env.NEXTAUTH_SECRET,
    INTERNAL_API_KEY: process.env.INTERNAL_API_KEY,
    NEXT_PUBLIC_APP_URL: process.env.NEXT_PUBLIC_APP_URL,
    NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY: process.env.NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY,
  },
});

4. 最少資料序列化(mapper 模式) ​

typescript
// app/dashboard/page.tsx — Server Component
import { db } from '@/lib/db';
import { auth } from '@/lib/auth';
import { UserCard } from './UserCard'; // 'use client'

// Prisma User model 包含:id、name、email、avatarUrl、passwordHash、
// stripeCustomerId、internalScore、adminNotes、deletedAt...
type PublicUser = {
  id: string;
  name: string;
  avatarUrl: string | null;
};

function toPublicUser(user: Awaited<ReturnType<typeof db.user.findUniqueOrThrow>>): PublicUser {
  // 明確的允許清單——只有 Client Component 渲染所需的三個欄位
  return {
    id: user.id,
    name: user.name,
    avatarUrl: user.avatarUrl,
  };
}

export default async function DashboardPage() {
  const session = await auth();
  const user = await db.user.findUniqueOrThrow({ where: { id: session!.user.id } });

  // 只傳遞公開的資料形狀——passwordHash、stripeCustomerId 等永遠不會進入 RSC payload
  return <UserCard user={toPublicUser(user)} />;
}

5. 內嵌 script 資料的 JSON 注入防護 ​

typescript
// 危險——含有 </script> 的使用者資料會破壞標籤結構
export function UnsafeInlineData({ data }: { data: unknown }) {
  return (
    <script
      dangerouslySetInnerHTML={{
        // 若 data = { name: '</script><script>alert(1)</script>' }
        // 以下程式碼會終止 script 標籤並注入任意 HTML
        __html: `window.__INITIAL_DATA__ = ${JSON.stringify(data)}`,
      }}
    />
  );
}

// 安全——使用 serialize-javascript,它會轉義 </script>、行分隔符等字元
import serialize from 'serialize-javascript';

export function SafeInlineData({ data }: { data: unknown }) {
  return (
    <script
      dangerouslySetInnerHTML={{
        __html: `window.__INITIAL_DATA__ = ${serialize(data, { isJSON: true })}`,
      }}
    />
  );
}

// 同樣安全——在沒有 serialize-javascript 的環境中手動轉義
function escapeForScriptTag(json: string): string {
  return json
    .replace(/</g, '\\u003c')
    .replace(/>/g, '\\u003e')
    .replace(/&/g, '\\u0026')
    .replace(/\u2028/g, '\\u2028')
    .replace(/\u2029/g, '\\u2029');
}

常見錯誤 ​

對未消毒的伺服器資料使用 dangerouslySetInnerHTML

React 的 JSX 插值({value})會自動轉義文字內容。dangerouslySetInnerHTML 則不會。將使用者控制的資料直接傳入 dangerouslySetInnerHTML 的 Server Component,會在初始 HTML 回應中傳遞 XSS——在 hydration 之前,在 CSP nonce 套用之前。使用 DOMPurify(透過 jsdom 在伺服器端)進行消毒,或對不受信任的內容完全避免使用 dangerouslySetInnerHTML。

相關 FEE ​

參考資料 ​