使用Helia实现IPFS时，重启能否保留相同Node ID(PeerId)？

云原生阿岚

2026-6-26

如何在Helia-libp2p节点重启后保留相同的PeerId

当然可以实现PeerId的跨重启持久化，核心逻辑是复用节点的密钥对——因为PeerId是从节点的加密密钥派生而来的，只要重启时加载同一套密钥，就能得到完全相同的PeerId。

具体实现步骤

首次初始化节点时，将生成的密钥对持久化到本地存储（比如文件系统）
后续重启节点时，优先从本地读取已保存的密钥对，再传入libp2p的配置中

JavaScript代码示例

import { createHelia } from 'helia'
import { createLibp2p } from 'libp2p'
import { ed25519 } from '@libp2p/crypto/keys'
import fs from 'fs/promises'

async function startPersistentHeliaNode() {
  let keyPair
  const keyFilePath = './helia-node-key.json'

  // 尝试读取已保存的密钥
  try {
    const keyData = JSON.parse(await fs.readFile(keyFilePath, 'utf8'))
    keyPair = await ed25519.unmarshal(new Uint8Array(keyData))
  } catch (err) {
    // 本地无密钥则生成新的并保存
    keyPair = await ed25519.generateKeyPair()
    await fs.writeFile(keyFilePath, JSON.stringify(Array.from(keyPair.marshal())), 'utf8')
  }

  // 用加载的密钥创建libp2p实例
  const libp2p = await createLibp2p({
    keys: {
      peerId: await keyPair.peerId()
    },
    // 按需添加其他libp2p配置：如TCP传输、mdns发现等
    transports: [],
    peerDiscovery: []
  })

  const helia = await createHelia({ libp2p })
  console.log('当前节点PeerId:', helia.libp2p.peerId.toString())
  return helia
}

// 启动节点
startPersistentHeliaNode()