許多開發者嘗試在前端「過濾惡意標籤」防禦 XSS,但**前端過濾無法作為主要防線**——攻擊者可繞過瀏覽器直接發送 API 請求。前端處理的正確定位:
DOMPurify 是經過安全審計、廣泛採用的 HTML 淨化庫,支援瀏覽器與 Node.js。
// npm / yarn / pnpm
npm install dompurify
// ES Module
import DOMPurify from 'dompurify';
// CDN (瀏覽器)
<script src="https://cdn.jsdelivr.net/npm/dompurify@3.0.6/dist/purify.min.js"></script>
// 1. 預設:保留安全標籤,移除危險屬性/標籤
const clean = DOMPurify.sanitize(userHTML);
// 2. 嚴格模式:僅保留純文字
const textOnly = DOMPurify.sanitize(userHTML, { ALLOWED_TAGS: [] });
// 3. 自訂允許清單(如富文本編輯器輸出)
const richText = DOMPurify.sanitize(userHTML, {
ALLOWED_TAGS: ['p', 'br', 'b', 'i', 'em', 'strong', 'a', 'ul', 'ol', 'li', 'blockquote', 'h1', 'h2', 'h3'],
ALLOWED_ATTR: ['href', 'target', 'rel', 'class', 'id'],
// 強制 a 標籤加上安全屬性
ADD_ATTR: ['target'],
ADD_URI_SAFE_ATTR: ['href']
});
// 4. 回傳 TrustedHTML (配合 Trusted Types)
const trusted = DOMPurify.sanitize(userHTML, { RETURN_TRUSTED_TYPE: true });
element.innerHTML = trusted; // 滿足 Trusted Types 政策
| 選項 | 預設 | 說明 |
|---|---|---|
ALLOWED_TAGS | 安全標籤清單 | 覆蓋預設允許標籤 |
FORBID_TAGS | [] | 額外禁止標籤 |
ALLOWED_ATTR | 安全屬性清單 | 覆蓋預設允許屬性 |
FORBID_ATTR | ['on*', 'style', ...] | 額外禁止屬性(預設禁用事件處理器、style) |
KEEP_CONTENT | false | true 時移除標籤但保留內容 |
SANITIZE_DOM | false | true 時接受 Document/Element 節點 |
RETURN_DOM | false | true 時回傳 DocumentFragment |
RETURN_TRUSTED_TYPE | false | true 時回傳 TrustedHTML(需瀏覽器支援) |
Trusted Types 瀏覽器機制強制要求 innerHTML、document.write 等接收 TrustedHTML 物件,杜絕字串直接注入。
<meta http-equiv="Content-Security-Policy"
content="trusted-types dompurify; require-trusted-types-for 'script';">
// 應用層
const sanitized = DOMPurify.sanitize(input, { RETURN_TRUSTED_TYPE: true });
element.innerHTML = sanitized; // 僅接受 TrustedHTML
// 範例:嚴格 CSP
Content-Security-Policy:
default-src 'self';
script-src 'self' 'nonce-{random}'; // 禁止 inline script
style-src 'self' 'unsafe-inline'; // 允許 inline style (或用 nonce)
img-src 'self' data: https:;
font-src 'self' data:;
object-src 'none';
base-uri 'self';
form-action 'self';
frame-ancestors 'none';
| 階段 | 動作 | 工具/方法 | 目的 |
|---|---|---|---|
| 輸入 | 驗證格式、長度、型別 | Zod, Yup, Joi, filter_var | 商務邏輯正確性 |
| 儲存 | 參數化查詢,原始儲存 | PDO, ORM | 防 SQL 注入,保留原始資料 |
| 輸出(HTML) | 情境化編碼 | htmlspecialchars, 模板引擎自動逃逸 | 防 XSS 核心 |
| 輸出(JS) | JSON 編碼 | json_encode, JSON.stringify | 防 JS 注入 |
| 瀏覽器 | CSP、Trusted Types | HTTP Header、Meta 標籤 | 縱深防禦、限制注入面 |
script-src、object-src 'none')HttpOnly、Secure、SameSite=Strict/Lax前端 HTML 過濾以 DOMPurify 為標準工具,但真正的 XSS 防護在於「輸出端情境化編碼」與「瀏覽器安全機制(CSP/Trusted Types)」,三者缺一不可。