安裝並配置ImageMagick以使用 Experience Manager Assets

ImageMagick是用於建立、編輯、合成或轉換點陣圖影像的軟體插件。 它可以讀取和寫入各種格式(超過200個)的影像,包括PNG、JPEG、JPEG-2000、GIF、TIFF、DPX、EXR、WebP、Postscript、PDF和SVG。 使用ImageMagick調整影像大小、翻轉、鏡像、旋轉、扭曲、剪切和轉換影像。 您還可以使用ImageMagick調整影像顏色、應用各種特殊效果,或繪製文本、線、多邊形、橢圓和曲線。

使用 Adobe Experience Manager 從命令行處理媒體處理程式,通過ImageMagick處理影像。 若要使用ImageMagick處理各種檔案格式,請參閱 Assets檔案格式最佳實務. 若要了解所有支援的檔案格式,請參閱 Assets支援的格式.

要使用ImageMagick處理大型檔案,請考慮高於通常的記憶體要求、IM策略所需的潛在更改以及對效能的整體影響。 記憶體需求取決於各種因素,如解析度、位深度、顏色配置檔案和檔案格式。 如果要使用ImageMagick處理非常大的檔案,請正確對 Experience Manager 伺服器。 最後提供一些實用的資源。

注意

如果您使用 Experience Manager on Adobe Managed Services (AMS),如果您打算處理許多高解析度PSD或PSB檔案,請聯絡Adobe客戶支援。 Experience Manager 可能無法處理超過30000 x 23000像素的高解析度PSB檔案。

安裝ImageMagick

各種作業系統均提供多個版本的ImageMagic安裝檔案。 使用適合您作業系統的版本。

  1. 下載適當的 ImageMagick安裝檔案 作業系統。

  2. 在托管的磁碟上安裝ImageMagick Experience Manager 伺服器,啟動安裝檔案。

  3. 將路徑環境變數設定為ImageMagic安裝目錄。

  4. 要檢查安裝是否成功,請執行 identify -version 命令。

設定命令行處理步驟

您可以為您的特定使用案例設定命令列處理步驟。 每次新增JPEG影像檔案至時,請執行這些步驟以產生翻轉的影像和縮圖(140x100、48x48、319x319和1280x1280) /content/dam 在 Experience Manager 伺服器:

  1. 在 Experience Manager 伺服器,請前往工作流程控制台(https://[aem_server]:[port]/workflow)並開啟 DAM更新資產 工作流程模型。

  2. DAM更新資產 工作流模型,開啟 EPS縮圖(由ImageMagick提供) 步驟。

  3. 「參數」頁簽,新增 image/jpegMime類型 清單。

    mime_types_jpeg

  4. 命令 框中,輸入以下命令:

    convert ./${filename} -flip ./${basename}.flipped.jpg

  5. 選取 刪除生成的格式副本生成Web格式副本 標幟。

    select_flags

  6. 啟用Web的映像 標籤,指定尺寸為1280x1280像素的格式副本的詳細資訊。 此外,請指定 image/jpegMimetype 框。

    web_enabled_image

  7. 按一下 確定 以儲存變更。

    注意

    convert 命令在某些Windows版本(例如Windows SE)中不能運行,因為它與本機版本衝突 convert 是Windows安裝的一部分的實用程式。 在此案例中,請提及ImageMagick公用程式的完整路徑。 例如,指定

    "C:\Program Files\ImageMagick-6.8.9-Q16\convert.exe" -define jpeg:size=319x319 ./${filename} -thumbnail 319x319 cq5dam.thumbnail.319.319.png

  8. 開啟 處理縮圖 步驟,然後添加MIME類型 image/jpeg跳過Mime類型.

    skip_mime_types

  9. 啟用Web的映像 頁簽,添加MIME類型 image/jpeg略過清單. 按一下 確定 以儲存變更。

    web_enabled

  10. 儲存工作流程。

  11. 若要驗證處理是否正確,請將JPG影像上傳至 Assets. 處理完成後,檢查是否產生翻轉的影像和轉譯。

降低安全漏洞

使用ImageMagick處理映像時存在多個安全漏洞。 例如,處理使用者提交的影像時,可能會有遠端程式碼執行(RCE)的風險。

此外,各種影像處理插件依賴於ImageMagick庫,包括但不限於PHP的影像、Ruby的影像和回形夾,以及nodejs的影像。

如果您使用ImageMagick或受影響的程式庫,Adobe建議您透過執行下列至少一項工作(但最好同時執行兩項工作),以緩解已知弱點:

  1. 驗證所有映像檔案的開頭都是 "魔術位元組" 與您支援的影像檔案類型相對應,再傳送至ImageMagick進行處理。
  2. 使用策略檔案禁用有漏洞的ImageMagick編碼器。 有關ImageMagick的全球策略,請參見 /etc/ImageMagick.

本頁內容