萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> JSP 程式設計

JSP 整合 FCKeditor 富文本編輯器完整部署與精簡指南

FCKeditor (現已更名為 CKEditor 4/5) 曾是 Java Web 專案嵌入富文本編輯的首選方案。本文記錄 JSP 環境下 FCKeditor 2.x 的完整整合步驟、核心配置解析、安全硬化與體積精簡實戰,供維護舊系統參考;新專案強烈建議直接採用 CKEditor 5 (模組化、ES6、TypeScript、無相依 jQuery)。

一、 整合部署標準流程 (FCKeditor 2.2 + JSP Integration Pack 2.3)

1. 目錄結構佈放

webapp/
├── FCKeditor/                    # 主程式核心 (解壓 FCKeditor_2.2.zip)
│   ├── fckconfig.js              # 核心配置
│   ├── fckeditor.js              # 入口腳本
│   ├── fckstyles.xml             # 樣式定義
│   ├── fcktemplates.xml          # 模板定義
│   ├── editor/                   # 編輯器核心資源
│   │   ├── filemanager/          # 檔案管理/上傳連接器
│   │   │   ├── browser/          # 瀏覽伺服器端檔案
│   │   │   └── upload/           # 上傳處理
│   │   ├── skins/                # 皮膚
│   │   └── lang/                 # 語言包
│   └── ...
├── WEB-INF/
│   ├── web.xml                   # 註冊 Connector / SimpleUploader Servlet
│   └── lib/
│       ├── fckeditor.jar         # JSP 整合包核心類 (解壓 FCKeditor-2.3.zip 取得)
│       ├── commons-fileupload.jar
│       └── commons-io.jar

2. web.xml 註冊 Servlet (關鍵步驟)

<servlet>
    <servlet-name>Connector</servlet-name>
    <servlet-class>com.fckeditor.connector.ConnectorServlet</servlet-class>
</servlet>
<servlet-mapping>
    <servlet-name>Connector</servlet-name>
    <url-pattern>/FCKeditor/editor/filemanager/browser/default/connectors/jsp/connector</url-pattern>
</servlet-mapping>

<servlet>
    <servlet-name>SimpleUploader</servlet-name>
    <servlet-class>com.fckeditor.uploader.SimpleUploaderServlet</servlet-class>
</servlet>
<servlet-mapping>
    <servlet-name>SimpleUploader</servlet-name>
    <url-pattern>/FCKeditor/editor/filemanager/upload/simpleuploader</url-pattern>
</servlet-mapping>
注意:url-pattern 必須與 fckconfig.js 中 Connector / SimpleUploader 路徑設定完全一致。

3. JSP 頁面嵌入標籤

<%@ taglib prefix="FCK" uri="https://java.fckeditor.net/taglib" %>
<html>
<head>
    <script type="text/javascript" src="/FCKeditor/fckeditor.js"></script>
</head>
<body>
    <FCK:editor 
        id="content" 
        width="100%" 
        height="400" 
        toolbar="Default"
        imageBrowserURL="/FCKeditor/editor/filemanager/browser/default/browser.html?Type=Image&Connector=connectors/jsp/connector"
        linkBrowserURL="/FCKeditor/editor/filemanager/browser/default/browser.html?Connector=connectors/jsp/connector"
        flashBrowserURL="/FCKeditor/editor/filemanager/browser/default/browser.html?Type=Flash&Connector=connectors/jsp/connector"
        imageUploadURL="/FCKeditor/editor/filemanager/upload/simpleuploader?Type=Image"
        linkUploadURL="/FCKeditor/editor/filemanager/upload/simpleuploader?Type=File"
        flashUploadURL="/FCKeditor/editor/filemanager/upload/simpleuploader?Type=Flash"
        basePath="/FCKeditor/"
    >
        初始內容...
    </FCK:editor>
</body>
</html>

二、 生產環境精簡:體積瘦身 70%+

FCKeditor 完整包含 2000+ 檔案、10MB+。生產部署僅需核心功能,執行以下精簡:

  1. 刪除所有以 `_` 開頭的資料夾 (原始碼、測試樣本、文檔)。
  2. 根目錄僅保留:fckconfig.js、fckeditor.js、fckstyles.xml、fcktemplates.xml。
  3. 清空 editor/filemanager/upload:上傳處理由自訂 Servlet 接管,不使用預設實作。
  4. 皮膚只保留 default:刪除 editor/skins/office2003、silver 等。
  5. 語言包只保留必要:en.js、zh-cn.js、zh.js (繁體)、fcklanguagemanager.js。

精簡後僅約 300KB,大幅縮短部署時間與靜態資源下載。

三、 安全硬化:防止任意檔案上傳與 XSS

1. 前台使用者工具列精簡

編輯 fckconfig.js 約第 78 行 FCKConfig.ToolbarSets["Default"] 陣列,**移除** Image、Flash、Table、Form 等可上傳檔案或注入 HTML 的按鈕,僅保留基本排版、連結、清單等安全功能。

2. 連接器端驗證 (ConnectorServlet 子類化)

public class SecureConnectorServlet extends ConnectorServlet {
    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response) {
        // 1. 驗證登入 Session / 權限
        if (!isAuthorized(request)) {
            response.sendError(HttpServletResponse.SC_FORBIDDEN);
            return;
        }
        // 2. 檢查檔案類型白名單 (僅允許圖片)
        String type = request.getParameter("Type");
        if (!"Image".equalsIgnoreCase(type)) {
            response.sendError(HttpServletResponse.SC_BAD_REQUEST);
            return;
        }
        super.doGet(request, response);
    }
}

在 web.xml 替換 ConnectorServlet 為自訂安全版。

3. 上傳目錄執行權限隔離

  • 上傳目錄設定 **不可執行** (IIS: 移除 Script/Execute 權限;Nginx/Apache: location ~ \.php$ { deny all; })。
  • 檔案重命名為 UUID + 副檔名白名單驗證 (僅 .jpg/.png/.gif/.pdf)。
  • 資料庫記錄原始檔名、儲存路徑、上傳者、時間,審計追蹤。

四、 常見坑與解決方案

現象原因解決
上傳圖片報 content-handler 錯誤類路徑衝突:xalan.jar (XML 解析器) 與 JDK 內建衝突刪除 WEB-INF/lib/xalan*.jar,使用 JDK 內建 JAXP
瀏覽伺服器顯示空白/404Connector URL 路徑不匹配 / 權限不足檢查 web.xml url-pattern、fckconfig.js Connector 路徑、資料夾讀取權限
編輯器工具列不顯示/報 JS 錯誤basePath 錯誤 / fckeditor.js 載入失敗確保 basePath="/FCKeditor/" 以斜線結尾,網路面板確認 200 OK
Struts2/Spring MVC 衝突Struts 攔截器攔截 *.action 請求在 struts.xml 排除 /FCKeditor/** 或配置 struts.action.excludePattern

結語與遷移建議

FCKeditor 已停止維護 (EOL 2010),存在已知 XSS、上傳繞過漏洞 (CVE-2011-1719 等)。**強烈建議遷移至 CKEditor 5**:

  • NPM 安裝:npm install @ckeditor/ckeditor5-build-classic
  • 模組化打包 (Webpack/Vite),Tree-shaking 體積極小。
  • 內建 XSS 保護、無 jQuery 相依、TypeScript 類型定義完整。
  • Java 後端僅需提供標準 REST 上傳/瀏覽 API (JSON 格式),前後端徹底解耦。
copyright © 萬盛學電腦網 all rights reserved