Linux 安裝 ImageMagick 與 JMagick 完整教學：RPM 與原始碼編譯雙軌並行

Java 專案若需高效能圖片處理（縮圖、轉檔、銳化、特效），ImageMagick 是 C 語言撰寫的業界標準庫，但 Java 無法直接透過 JNI 呼叫。JMagick 以 C 實作 JNI 橋接層，讓 Java 經由 JMagick → ImageMagick 完成圖片運算。本文涵蓋：依賴套件安裝、ImageMagick RPM/編譯安裝、JMagick 32/64 位元 RPM 與原始碼編譯、常見錯誤排解、Tomcat 整合驗證，適用 CentOS/RHEL 6/7 系列。

一、前置依賴套件 (yum 一鍵安裝)

yum install -y libjpeg libjpeg-devel libpng libpng-devel \
  libtiff libtiff-devel libungif libungif-devel freetype zlib
# 驗證
rpm -qa | grep -E 'libjpeg|libpng|libtiff|freetype|zlib'

二、ImageMagick 安裝

方式 A：RPM 安裝 (推薦，快速穩定)

yum remove -y ImageMagick   # 移除舊版
yum install -y ImageMagick  # 自動解決依賴

方式 B：原始碼編譯 (需特定版本/參數時)

cd /usr/local/src
wget https://downloads.jmagick.org/6.4.0/ImageMagick-6.4.0-0.tar.gz
tar zxvf ImageMagick-6.4.0-0.tar.gz
cd ImageMagick-6.4.0
./configure --enable-shared --without-perl
make && make install && make check

驗證：

find / -name convert
convert --version
convert -geometry 100x200 src.jpg out.gif   # 測試指令列轉檔

三、JMagick 安裝

共同前置：安裝 JDK 與建立 jman 帳號

yum install -y java-1.8.0-openjdk-devel
/usr/sbin/useradd -u 1000 -s /sbin/nologin jman

32 位元系統 RPM 安裝

rpm -ivh jmagick-6.4.0-3.i386.rpm
rpm -ivh jmagick-6.4.0-3.src.rpm

64 位元系統 RPM 安裝

rpm -ivh jmagick-6.4.0-3.x86_64.rpm
rpm -ivh jmagick-6.4.0-3.src.rpm
rpm -ivh jmagick-debuginfo-6.4.0-3.x86_64.rpm

若 src.rpm 報 cannot create %sourcedir /usr/src/redhat/SOURCES：

mkdir -p /usr/src/redhat/SOURCES

原始碼編譯 (跨平台通用)

tar zxvf jmagick-6.4.0-src.tar.gz
cd jmagick-6.4.0-src
./configure --prefix=/opt/jmagick-6.4.0 \
  --with-java-home=/usr/lib/jvm/java-1.8.0 \
  --with-magick-home=/usr/local/ImageMagick-6.4.0
make all && make install

產出 /opt/jmagick-6.4.0/lib/jmagick-6.4.0.jar。

四、整合 Tomcat 驗證

# 複製 jar 至 Tomcat classpath (建議放在 shared/lib 或 webapp WEB-INF/lib)
cp /opt/jmagick-6.4.0/lib/jmagick-6.4.0.jar /usr/local/tomcat/lib/

# 重啟 Tomcat 使 JNI 庫載入
systemctl restart tomcat

關鍵提醒：JMagick 編譯時綁定的 JDK 版本 (如 1.8) 必須與執行環境一致，跨大版本 (1.7 vs 1.8) 會導致 UnsatisfiedLinkError。

五、常見錯誤與解決方案

六、替代方案：JNA 直接呼叫 ImageMagick C API

若不想維護 JMagick 原始碼，可改用 JNA (Java Native Access) 直接映射 ImageMagick C 函式，僅需 jna.jar 與 libMagickCore.so 即可，部署更輕量。