rust-libp2p

去中心化世界的网络层标准件——libp2p 规范的 Rust 实现

更新于 2026-09-03

一句话定位

P2P 网络的乐高积木

libp2p 规范的 Rust 实现：把点对点网络拆成可插拔的模块——传输（TCP/QUIC/WebRTC）、加密（Noise/TLS）、流复用、NAT 穿越（relay/打洞）、服务发现（Kademlia DHT/mDNS）、订阅广播（gossipsub），像搭积木一样组装出自己的 P2P 应用。Polkadot、以太坊 Lighthouse、Filecoin 等数十条区块链和网络都用它做网络层。适合做去中心化应用、区块链节点、私有 P2P 通信的开发者。

核心数据

数据来源：GitHub API，采集于 2026-09-03。维护者 Elena Frank、João Oliveira；每周维护者例会 + 双周社区电话；dependabot 持续滚动依赖升级。

libp2p 是什么，Rust 版是什么地位

自底向上五层积木

Swarm 双接口：写 P2P 应用只碰两个 trait

15 个应用协议，按功能分组

另有 perf（吞吐基准）与 stream（通用子流）。每个协议都是独立 crate，不用就不编译。

P2P 最难的问题，协议族给了完整答案

30 行组装一个能跑的 P2P 节点

// Cargo.toml: libp2p = { version = "0.56", features = ["tokio","tcp","noise","yamux","gossipsub","mdns"] }
let mut swarm = SwarmBuilder::with_new_identity()
    .with_tokio()
    .with_tcp(tcp::Config::default(), noise::Config::new, yamux::Config::default)?  // TCP + Noise 加密 + yamux 复用
    .with_behaviour(|key| {
        MyBehaviour {
            gossipsub: gossipsub::Behaviour::new(MessageAuthenticity::Signed(key.clone()), cfg)?,
            mdns: mdns::tokio::Behaviour::new(mdns::Config::default(), key.public().to_peer_id())?,
        }
    })?
    .with_swarm_config(|c| c.with_idle_connection_timeout(Duration::from_secs(60)))
    .build();

swarm.behaviour().gossipsub.subscribe(&topic)?;   // 订阅话题
loop {
    match swarm.select_next_some().await {          // 事件循环
        SwarmEvent::Behaviour(MyBehaviourEvent::Gossipsub(e)) => { /* 收到消息 */ }
        SwarmEvent::NewListenAddr { address, .. } => println!("监听: {address}"),
        _ => {}
    }
}

• builder 链式组装：传输（with_tcp）、升级（noise/yamux）、行为三个组合点是主要 API 面
• examples/ 目录 20+ 可运行示例：chat、file-sharing、dht、relay、浏览器节点，从 demo 起步最快

区块链行业的「TCP/IP」

21 个官方列出项目 + 大量未列的——「网络层不自己写，用 libp2p」在 Rust 去中心化生态里已是默认共识。

九年长跑的工程纪律

上手前要知道的

• 学习曲线陡：Transport/upgrade/muxer/swarm/behaviour/handler 六层概念，心智负担重——「组装积木」的代价是先学会每种积木
• 0.x 破坏性变更多：minor 也 breaking，升级常需要改代码；锁版本 + 看 CHANGELOG 是日常
• 文档分散：docs.rs API 全，但教程级内容少；examples 是最好的老师，概念解释要跨 spec/discuss 论坛拼凑
• 编译重：tokio + 多 crate + proc-macro，全功能首次编译数分钟；按 feature 裁剪是必须的
• 生态绑定 Rust + tokio：想要浏览器节点要走 wasm/websys 路线，与桌面版特性矩阵不完全对齐
• 应用协议自定义要写两套 trait：request-response 能覆盖大部分 RPC 需求，但完全自定义协议的样板代码不少

打分

综合 9/10。P2P 基础设施里的「央行级」资产——不性感、不上新闻，但区块链与去中心化应用的每一层都压在它上面。AI Agent 点对点协作若成气候，它是现成的传输底座。

适合谁，不适合谁