Clappeer：构建分布式节点网络的利器
Clappeer是一个强大的库，用于创建支持节点间消息交换的分布式节点网络。该网络允许节点之间安全地交换明文和加密消息。 项目地址：https://www.php.cn/link/ed4c1b66c7147f042c4cd33dbede174c
核心功能：
- 节点间消息中转： Clappeer利用中间节点实现消息可靠传输。
- TTL机制防止消息循环： 内置的生存时间(TTL)机制有效防止消息在网络中无限循环。
- 安全的消息交换： 支持RSA和AES加密算法，保障数据安全。
快速上手示例：
const { clappeer, dm, crypto_dm, error } = require('clap-peer');
// 节点1
const node1 = new clappeer(1001, 'a');
node1.on(dm, msg => console.log('普通消息:', msg));
node1.on(crypto_dm, msg => console.log('加密消息:', msg));
// 节点2
const node2 = new clappeer(1002, 'b');
node2.connect({ host: '127.0.0.1', port: 1001 });
node2.send(node1.nodeid, { hello: '加密问候' })
.catch(err => console.error('发送加密消息错误:', err));
node2.publish(node1.nodeid, { hello: '普通问候' });
节点连接方式：
Clappeer提供两种灵活的节点连接方式：
方法一：使用 .connect() 方法
const node = new clappeer(1001, 'a');
node.connect({ host: '127.0.0.1', port: 1002 });
这种方式将节点创建和连接逻辑分离，更易于管理。
方法二：在创建节点时传递配置对象
const node = new clappeer(1002, 'a', { host: '127.0.0.1', port: 1002 });
此方法适合需要立即连接的场景，简化代码。
消息发送：
Clappeer 提供两种消息发送方法：
1. send() 方法：发送加密消息
send() 方法用于发送加密消息。它会自动检查目标节点的公钥，如果密钥不存在则会先请求公钥再发送消息。
node.send(node2.nodeid, { text: '加密信息' }).catch(err => console.error('发送错误:', err));
2. publish() 方法：发送明文消息
publish() 方法发送未加密的明文消息。
node.publish(node2.nodeid, { text: '明文信息' });
消息发送方法对比：
| 方法 | 加密 | 公钥检查 | 公钥请求 | 中间节点路由 |
|---|---|---|---|---|
send() |
✅ | ✅ | ✅ | ✅ |
publish() |
❌ | ❌ | ❌ | ✅ |
消息接收：
节点通过监听事件来接收消息：
1. dm 事件：接收明文消息
dm 事件用于处理 publish() 方法发送的明文消息。
node.on(dm, msg => console.log('收到明文消息:', msg));
2. crypto_dm 事件：接收加密消息
crypto_dm 事件用于处理 send() 方法发送的加密消息。
node.on(crypto_dm, msg => console.log('收到加密消息:', msg));
消息接收事件对比：
| 事件 | 生成消息的方法 | 消息类型 | 说明 |
|---|---|---|---|
dm |
publish() |
明文消息 | 未加密消息 |
crypto_dm |
send() |
加密消息 | 加密后传输的消息 |
错误处理：
Clappeer 提供 error 事件用于处理各种错误：
node.on(error, (messageError, originalError) => {
console.error('错误信息:', messageError);
console.error('原始错误:', originalError);
});
messageError.message 可能包含以下错误信息：
-
timeout_error_message：邻居检查超时 -
timeout_error_request：RSA密钥请求超时 -
解密错误：消息解密失败 -
send_error：消息发送失败 -
publish_error：消息发布失败
希望以上信息对您有所帮助！
