UEditor 預設開啟「遠程圖片抓取」:貼上非白名單域名圖片時,自動下載至本地伺服器。若伺服器無寫入權限、跨域限制或單純不想佔用頻寬,需關閉此功能。官方文檔未明確說明關閉參數,需查閱源碼。
檔案:ueditor.all.js → plugins/catchremoteimage.js
UE.plugins['catchremoteimage'] = function() {
var me = this, ajax = UE.ajax;
// 關鍵判斷:若配置為 false 直接 return,不註冊插件
if (me.options.catchRemoteImageEnable === false) return;
me.setOpt({ catchRemoteImageEnable: false }); // 預設強制關閉?實測需在 config 設定
// ... 後續抓取邏輯
};
// ueditor.config.js
window.UEDITOR_CONFIG = {
// ... 其他配置
// 抓取遠程圖片是否開啟,預設 true
catchRemoteImageEnable: false
};
https://example.com/img.png) 貼上編輯器。catchimage 請求發送。| 配置項 | 說明 | 預設值 |
|---|---|---|
catchRemoteImageEnable | 是否啟用遠程圖片抓取 | true |
catcherLocalDomain | 白名單域名陣列,匹配域名不抓取 | [] |
catcherActionName | 後端抓取接口 action 名稱 | catchimage |
catcherFieldName | 上傳表單字段名 | source |
catcherMaxSize | 抓取圖片最大尺寸 (bytes) | 2048000 |
catcherAllowFiles | 允許抓取的副檔名 | [.png,.jpg,.jpeg,.gif,.bmp] |
catchimage 接口若報 404/500,前端會重試,導致貼上卡頓;關閉功能可避免此問題。catcherLocalDomain: ['localhost', '127.0.0.1', 'yourdomain.com'] 即可,無需完全關閉。UEditor 遠程圖片抓取功能雖強大,但對伺服器環境有依賴。生產環境建議:關閉自動抓取,改由前端壓縮後直傳對象存儲 (OSS/S3),或由後端異步任務處理圖片遷移,減少請求阻塞與失風險。