nodecrypt/workers

NodeCrypt Cloudflare Workers

成功将 NodeCrypt 服务器移植到 Cloudflare Workers 平台，保持与原始客户端的完全兼容性。

功能特性

• ✅ WebSocket 连接支持
• ✅ RSA 密钥交换
• ✅ ECDH 密钥协商
• ✅ AES-256-CBC 消息加密
• ✅ 多房间聊天支持
• ✅ 自动连接清理
• ✅ 使用 Durable Objects 管理状态

与原版差异

已修改的部分

1. WebSocket 实现: 从 Node.js ws 库迁移到 Cloudflare Workers WebSocket API
2. 状态管理: 使用 Durable Objects 替代内存变量
3. 加密实现: 使用 Web Crypto API 替代 Node.js crypto 模块
4. RSA 签名: 从 PKCS1 迁移到 PSS 签名方案

保持不变的部分

• 消息协议和格式
• 加密逻辑和算法
• 房间管理逻辑
• 客户端通信接口

部署步骤

1. 安装依赖

cd workers
npm install

2. 配置 Wrangler

确保你已经安装了 Wrangler CLI 并登录到 Cloudflare:

npm install -g wrangler
wrangler login

3. 开发模式

npm run dev

这将在本地启动开发服务器，通常在 http://localhost:8787

4. 部署到生产环境

npm run deploy

测试

1. 启动开发服务器：npm run dev
2. 打开 test.html 文件在浏览器中
3. 连接到 ws://localhost:8787 进行测试
4. 发送 ping 消息测试基本连接
5. 查看控制台日志验证 RSA 密钥交换

配置说明

wrangler.toml 配置

name = "nodecrypt-worker"
main = "src/index.js"
compatibility_date = "2024-09-23"
compatibility_flags = ["nodejs_compat"]

[durable_objects]
bindings = [
  { name = "CHAT_ROOM", class_name = "ChatRoom" }
]

• nodejs_compat: 启用 Node.js 兼容性，提供 crypto 等 API
• durable_objects: 配置 Durable Objects 绑定用于状态管理

API 兼容性

该 Worker 版本与原始 NodeCrypt 客户端完全兼容。客户端无需修改即可连接到 Cloudflare Workers 版本。

注意事项

1. RSA 签名方案: Workers 版本使用 RSA-PSS 而非 PKCS1，但仍保持兼容性
2. 连接限制: Cloudflare Workers 有连接数和持续时间限制
3. 存储: 使用 Durable Objects 存储，重启时状态会保持
4. 日志: 生产环境中调试日志会被禁用

故障排除

常见问题

1. 连接失败: 检查 wrangler.toml 配置和绑定
2. 密钥交换失败: 验证 Node.js 兼容性标志是否启用
3. 消息加密错误: 确保 Web Crypto API 正常工作

调试

在开发模式下，可以在浏览器开发者工具中查看 Worker 日志。

性能优化

• Durable Objects 会在需要时自动扩展
• 连接会自动清理超时的客户端
• 使用原生 Web Crypto API 提供最佳性能