Jpcap 在 Ubuntu 與 Windows 環境下的完整安裝配置指南

Jpcap 在 Ubuntu 與 Windows 環境下的完整安裝配置指南

Java 標準庫 java.net 僅支援傳輸層（TCP/UDP）操作，若需處理數據鏈路層（如抓包、造包、ARP 欺騙等），必須借助 Jpcap。Jpcap 底層調用 libpcap (Linux) / WinPcap (Windows)，為 Java 提供跨平台的統一接口。本文記錄兩大主流作業系統的安裝全流程與踩坑避坑指南，供日後查閱。

一、Ubuntu 環境配置

前置依賴

sudo apt-get update
sudo apt-get install build-essential libpcap-dev

libpcap-dev 提供編譯所需的頭文件與靜態庫；若 apt 版本過舊，可參考文末參考鏈接手動編譯最新版 libpcap。

下載並編譯 Jpcap 源碼

git clone --recursive https://github.com/mgodave/Jpcap.git
cd Jpcap/src/main/c
make

編譯成功會在當前目錄產生 libjpcap.so。

部署原生庫與 Jar 包

# 1. 複製 .so 到 JRE 原生庫目錄 (架構對應：amd64/i386 等)
sudo cp libjpcap.so $JAVA_HOME/jre/lib/amd64/

# 2. 複製 jar 到擴展類路徑
sudo cp ../lib/jpcap.jar $JAVA_HOME/jre/lib/ext/

# 3. 確保 CLASSPATH 包含上述目錄 (通常已默認包含)
export CLASSPATH=$CLASSPATH:$JAVA_HOME/jre/lib/ext/jpcap.jar

注意：Java 6 需放入 /usr/java/packages/lib/ext；Java 9+ 模組化後建議使用 -Djava.library.path 指定原生庫路徑，而非污染 JRE 目錄。

常見運行錯誤與解決

二、Windows 環境配置

前置條件

先安裝 WinPcap（或維護中的 Npcap，勾選「WinPcap API-compatible Mode」）。

方式一：官方安裝包 (JpcapSetup-0.7.exe)

1. 一路 Next，安裝路徑建議：
   Jpcap.dll → C:\Windows\System32
jpcap.jar → C:\Windows\Sun\Java\lib\ext
2. 為 IDE 識別方便，額外複製到 JRE 目錄：
   Jpcap.dll → %JAVA_HOME%\jre\bin
jpcap.jar → %JAVA_HOME%\jre\lib\ext

方式二：手動部署 (適用於無安裝包場景)

1. 下載 jpcap.dll、jpcap.jar
2. 放入：
   %JAVA_HOME%\jre\bin\jpcap.dll
%JAVA_HOME%\jre\lib\ext\jpcap.jar
3. IDE 中導入外部 Jar；若報 UnsatisfiedLinkError，在 VM 參數添加：
   -Djava.library.path=你的dll所在目錄

常見錯誤速查

• no dependence library → 未安裝 WinPcap/Npcap
• no jpcap in java.library.path → dll 未在 System32/JRE bin/指定路徑中

三、驗證測試

import jpcap.*;
public class TestJpcap {
    public static void main(String[] args) {
        NetworkInterface[] devices = JpcapCaptor.getDeviceList();
        for (NetworkInterface d : devices) {
            System.out.println(d.name + " - " + d.description);
        }
    }
}

輸出網卡列表即代表環境就緒。

參考資源

• Ubuntu 14.04 安裝 libpcap 詳解：CSDN-pdcxs007
• Jpcap 官方下載：bianceng.cn
• Npcap 現代替代品：nmap.org/npcap

避坑心得：生產環境建議容器化部署時將 libjpcap.so、jpcap.jar 打入鏡像，並以 --cap-add=NET_RAW 啟動容器，避免宿主機環境差異導致「開發機能跑、生產掛」的尷尬。