PeerSim 入門實戰：P2P 網絡模擬器安裝、配置、Chord/Pastry 協議運行全流程

PeerSim 快速上手指南：從 JDK 配置到 Chord/Pastry 覆蓋網絡模擬運行

PeerSim 是基於 Java 的 P2P 網絡模擬框架，支援千萬節點級離散事件模擬，內建 Chord、Pastry、Kademlia 等經典覆蓋協議。本文記錄 Windows 下 JDK 配置、PeerSim 解壓、Eclipse/IDEA 導入、官方示例運行、第三方協議包編譯部署全流程。

一、環境準備：JDK 1.8+ 配置

# 系統環境變量
JAVA_HOME=C:\Program Files\Java\jdk1.8.0_202
CLASSPATH=.;%JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar
PATH=%PATH%;%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin

驗證：java -version、javac -version 均顯示 1.8.x

二、PeerSim 下載與目錄結構

• 官網：https://peersim.sourceforge.net
• 下載：peersim-1.0.5.zip（含 JAR、源碼、示例配置、文檔）
• 解壓後關鍵文件：
  • peersim-1.0.5.jar 核心框架
  • jep-2.3.0.jar 數學表達式解析引擎
  • djep-1.0.0.jar 擴展數學函數
  • example/config-example1.txt 入門示例配置
  • src/peersim/Simulator.java 入口類

三、方式一：命令行直接運行示例

cd peersim-1.0.5
java -cp peersim-1.0.5.jar;jep-2.3.0.jar;djep-1.0.0.jar peersim.Simulator example/config-example1.txt

輸出示例：節點初始化、協議啟動、模擬步進、統計指標打印。

四、方式二：IDEA/Eclipse 導入項目調試

IDEA 步驟

1. File → New → Project from Existing Sources 選中解壓目錄
2. 選 Import project from external model → Maven（若無 pom.xml 選「Create project from existing sources」）
3. 右鍵 lib 目錄下三個 JAR → Add as Library
4. 標記 src 為 Sources Root，example 為 Resources Root
5. 創建 Run Configuration：
   • Main class: peersim.Simulator
   • Program arguments: example/config-example1.txt
   • Working directory: 項目根目錄
6. Run → 控制台輸出同命令行

五、配置文件解讀：config-example1.txt

# 模擬參數
simulation.endtime 100          # 模擬步數
simulation.cycles 1             # 重複運行次數
random.seed 12345               # 隨機種子

# 協議棧定義
protocol.1 peersim.core.Transport
protocol.2 peersim.cdsim.CDProtocol
protocol.3 peersim.kademlia.KademliaProtocol

# 協議參數
transport.port 9090
kademlia.k 20
kademlia.alpha 3

# 觀察器
observer.1 peersim.cdsim.CDObserver
observer.2 peersim.viz.Visualizer

核心模式：protocol.x 定義節點協議棧，observer.x 定義統計/可視化組件。

六、第三方協議包編譯部署：Chord / Pastry 實戰

官網 Chord 項目 提供源碼，需自行編譯 JAR。

編譯步驟

1. 下載 chord-src.zip 解壓
2. 進入源碼目錄，執行 ant jar 或 javac -d bin src/... && jar cf chord.jar -C bin .
3. 產出 chord.jar

運行 Chord 模擬

# 將 peersim 三大 JAR + chord.jar 放同一目錄
java -cp "peersim-1.0.5.jar;jep-2.3.0.jar;djep-1.0.0.jar;chord.jar" peersim.Simulator chord-example.cfg

注意：Windows 用分號 ;，Linux/Mac 用冒號 : 分隔 classpath。

七、常見問題與避坑

1. NoClassDefFoundError：classpath 缺少 jep/djep 或協議 JAR，檢查分隔符與路徑
2. 配置文件路徑錯誤：Program arguments 必須相對 working directory，或用絕對路徑
3. 內存不足：大規模模擬 (100k+ 節點) 需 -Xmx2g -Xms2g
4. 隨機種子固定：random.seed 保證可復現，論文實驗必備
5. 可視化卡頓：關閉 Visualizer 或降低 simulation.endtime

八、擴展開發：自定義協議

public class MyProtocol implements Protocol {
    private final String prefix;
    public MyProtocol(String prefix) { this.prefix = prefix; }
    
    @Override public Object clone() { return new MyProtocol(prefix); }
    
    // 每個周期調用
    public void nextCycle(Node node, int protocolID) {
        // 發送消息、更新狀態、選鄰居...
    }
}

配置文件註冊：protocol.5 MyProtocol

九、總結

• PeerSim = 離散事件模擬核心 + 豐富協議庫 + 可插拔觀察器
• 三步走通：JDK 配置 → 核心 JAR 路徑 → 配置文件參數
• 第三方協議（Chord/Pastry）需**源碼編譯 JAR** 再加入 classpath
• 論文級實驗：固定種子、多輪平均、導出 CSV 統計、可視化驗證拓撲