安裝並配置ImageMagick以使用 Experience Manager Assets install-and-configure-imagemagick-to-work-with-aem-assets

CAUTION
AEM 6.4已結束延伸支援,本檔案不再更新。 如需詳細資訊,請參閱 技術支援期. 尋找支援的版本 此處.

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 伺服器。 最後提供一些實用的資源。

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

安裝ImageMagick installing-imagemagick

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

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

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

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

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

設定命令行處理步驟 set-up-the-command-line-process-step

您可以為您的特定使用案例設定命令列處理步驟。 每次新增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像素的格式副本的詳細資訊。 此外,請指定i 影像/jpegMimetype 框。

    web_enabled_image

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

    note note
    NOTE
    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. 要檢查ImageMagic是否能夠正確處理影像,請將JPG影像上傳到 Assets. 驗證是否為翻轉的影像生成格式副本。

緩解安全漏洞 mitigating-security-vulnerabilities

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

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

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

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