FCKeditor (現已更名為 CKEditor 4/5) 曾是 Java Web 專案嵌入富文本編輯的首選方案。本文記錄 JSP 環境下 FCKeditor 2.x 的完整整合步驟、核心配置解析、安全硬化與體積精簡實戰,供維護舊系統參考;新專案強烈建議直接採用 CKEditor 5 (模組化、ES6、TypeScript、無相依 jQuery)。
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
<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路徑設定完全一致。
<%@ 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>
FCKeditor 完整包含 2000+ 檔案、10MB+。生產部署僅需核心功能,執行以下精簡:
fckconfig.js、fckeditor.js、fckstyles.xml、fcktemplates.xml。editor/filemanager/upload:上傳處理由自訂 Servlet 接管,不使用預設實作。default:刪除 editor/skins/office2003、silver 等。en.js、zh-cn.js、zh.js (繁體)、fcklanguagemanager.js。精簡後僅約 300KB,大幅縮短部署時間與靜態資源下載。
編輯 fckconfig.js 約第 78 行 FCKConfig.ToolbarSets["Default"] 陣列,**移除** Image、Flash、Table、Form 等可上傳檔案或注入 HTML 的按鈕,僅保留基本排版、連結、清單等安全功能。
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 為自訂安全版。
location ~ \.php$ { deny all; })。| 現象 | 原因 | 解決 |
|---|---|---|
上傳圖片報 content-handler 錯誤 | 類路徑衝突:xalan.jar (XML 解析器) 與 JDK 內建衝突 | 刪除 WEB-INF/lib/xalan*.jar,使用 JDK 內建 JAXP |
| 瀏覽伺服器顯示空白/404 | Connector 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 install @ckeditor/ckeditor5-build-classic