萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

百度 UEditor 編輯器關閉遠程圖片抓取功能配置指南

問題背景

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 設定

// ueditor.config.js
window.UEDITOR_CONFIG = {
  // ... 其他配置
  // 抓取遠程圖片是否開啟,預設 true
  catchRemoteImageEnable: false
};

驗證方式

  1. 修改配置後重新整理編輯器頁面。
  2. 複製一張外部圖片 (如 https://example.com/img.png) 貼上編輯器。
  3. 開啟開發者工具 Network 面板,確認無 catchimage 請求發送。
  4. 圖片應保持原外部 URL,不被下載至本地。

相關配置項補充

配置項說明預設值
catchRemoteImageEnable是否啟用遠程圖片抓取true
catcherLocalDomain白名單域名陣列,匹配域名不抓取[]
catcherActionName後端抓取接口 action 名稱catchimage
catcherFieldName上傳表單字段名source
catcherMaxSize抓取圖片最大尺寸 (bytes)2048000
catcherAllowFiles允許抓取的副檔名[.png,.jpg,.jpeg,.gif,.bmp]

常見坑點

  • 配置修改後需清除瀏覽器快取或強制重新整理 (Ctrl+F5),否則舊 JS 仍生效。
  • 後端 catchimage 接口若報 404/500,前端會重試,導致貼上卡頓;關閉功能可避免此問題。
  • 若僅想限制特定域名抓取,設定 catcherLocalDomain: ['localhost', '127.0.0.1', 'yourdomain.com'] 即可,無需完全關閉。

UEditor 遠程圖片抓取功能雖強大,但對伺服器環境有依賴。生產環境建議:關閉自動抓取,改由前端壓縮後直傳對象存儲 (OSS/S3),或由後端異步任務處理圖片遷移,減少請求阻塞與失風險。

copyright © 萬盛學電腦網 all rights reserved