FCKeditor 2.5 在 ASP.NET 中的完整集成指南：配置、引用與安全使用

FCKeditor 簡介

FCKeditor (後更名為 CKEditor) 是經典的 Web 富文本編輯器。本文記錄 2.5 版在 ASP.NET 環境下的集成步驟與關鍵配置。

安裝與配置步驟

1. 文件部署

• 下載地址：https://www.fckeditor.net/download
• 解壓至項目根目錄下的 /FCKeditor/ 文件夾
• 引用 bin/FredCK.FCKeditorV2.dll

2. Web.config 關鍵配置

<appSettings>
    <!-- 編輯器核心文件路徑 -->
    <add key="FCKeditor:BasePath" value="~/FCKeditor/" />
    
    <!-- 用戶上傳文件存儲路徑 (需寫入權限) -->
    <add key="FCKeditor:UserFilesPath" value="/Files" />
</appSettings>

3. 頁面集成步驟

1. 工具箱右鍵 → 「選擇項目」 → 瀏覽選中 FredCK.FCKeditorV2.dll
2. 設計視圖下拖拽控件至頁面，設置 ID (如 FCKeditor1)
3. 頁面指令添加 ValidateRequest="false" (允許 HTML 內容提交)

   <%@ Page Language="C#" ValidateRequest="false" %>

核心使用代碼

獲取內容 (入庫前編碼)

string content = Server.HtmlEncode(FCKeditor1.Value);

回顯內容 (讀庫後解碼)

FCKeditor1.Value = Server.HtmlDecode(dbContent);

判斷是否為空

if (!string.IsNullOrEmpty(FCKeditor1.Value)) { ... }

fckconfig.js 關鍵自定義配置

// 語言設置
FCKConfig.DefaultLanguage = 'zh-cn';

// 工具欄精簡
FCKConfig.ToolbarSets["Basic"] = [
    ['Bold', 'Italic', 'Underline'],
    ['OrderedList', 'UnorderedList'],
    ['Link', 'Unlink', 'Image'],
    ['Source']
];

// 文件上傳類型限制
FCKConfig.LinkBrowserURL = FCKConfig.BasePath + 'filemanager/browser/default/browser.html?Type=File';
FCKConfig.ImageBrowserURL = FCKConfig.BasePath + 'filemanager/browser/default/browser.html?Type=Image';

// 上傳目錄權限：需確保 IIS_IUSRS 對 /Files 文件夾有寫入權限

安全最佳實踐

1. XSS 防護：輸出前端顯示時使用 Server.HtmlEncode，或配合 AntiXSS 庫
2. 上傳驗證：限制文件類型、大小，重命名文件防止腳本執行
3. 請求驗證：ASP.NET 4.0+ 需在 web.config 設置 <httpRuntime requestValidationMode="2.0" /> 配合頁面 ValidateRequest="false"
4. 路徑遍歷防護：上傳組件需過濾 ../ 等路徑遍歷字符

常見問題排查