WebSocket数据加密传输方法 WebSocket内容加密解密方案【实战】-js教程-PHP中文网

wss://仅保障传输层tls安全，无法防止终端被控或tls终止点后明文泄露，必须在应用层用aes-gcm等方案做端到端加密。

websocket数据加密传输方法 websocket内容加密解密方案【实战】

WebSocket 本身不加密消息内容，wss:// 只保障传输层（TLS）安全，一旦终端被控或 TLS 被绕过，明文消息仍可被直接读取。真正在生产环境防窃听、防篡改，必须做应用层端到端加密。

为什么不能只靠 `wss://`？

很多人上线后只配了 Nginx 的 wss 代理，就以为“已经加密了”，结果审计时发现聊天记录、用户 ID、金额字段全是明文 JSON。这是因为：

wss 加密的是 TCP 流，解密发生在 Nginx 或服务端 TLS 终止点之后——从 Nginx 到后端 WebSocket 服务（如 Spring Boot、Ratchet、Netty）之间走的是普通 ws:// 或内网 HTTP 协议，数据是裸奔的
浏览器内存 dump、调试器 hook、恶意扩展都能在 onmessage 回调前/后截获原始消息
服务端日志若未脱敏，console.log(event.data) 会把解密后的内容打满日志系统

前端用 `Web Crypto API` 做 AES-GCM 加密

别再引入 CryptoJS 或硬编码密钥。现代浏览器原生支持 window.crypto.subtle，更安全、无依赖、性能好。重点不是“能不能加”，而是“怎么加才不白加”：

密钥必须由服务端动态下发，绑定 session_id 或短期 access_token，绝不能写死在 JS 里
固定使用 AES-GCM：它自带认证标签（tag），解密失败直接丢弃，避免填充预言攻击
IV 必须每次随机生成且长度为 12 字节（96 bit），和密文一起 base64 传给服务端；不要复用 IV
加密前把消息转成 Uint8Array，不要对字符串直接 encodeURI —— 中文会乱码
附加数据（additionalData）建议传时间戳 + client_id，服务端解密后校验是否超时/来源合法

示例片段（发送端）：

WebSocket 8.18.2

WebSocket 8.18.2 是该协议规范的一个重要迭代版本，主要优化了连接稳定性与数据传输效率。它通过全双工通信机制，允许客户端与服务器在单一长连接上实时交换数据，大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力，适用于即时通讯、在线游戏及金融行情推送等低延迟场景，为开发者提供更可靠的实时网络交互基础。

下载

const encoder = new TextEncoder();
const data = encoder.encode(JSON.stringify({ action: 'transfer', amount: 1000 }));
const iv = window.crypto.getRandomValues(new Uint8Array(12));
const key = await importKeyFromServer(); // 从服务端获取的密钥

const encrypted = await window.crypto.subtle.encrypt(
  { name: 'AES-GCM', iv, additionalData: encoder.encode(Date.now() + clientId) },
  key,
  data
);

const msg = {
  iv: btoa(String.fromCharCode(...iv)),
  data: btoa(String.fromCharCode(...new Uint8Array(encrypted))),
  tag: btoa(String.fromCharCode(...new Uint8Array(encrypted).slice(-16)))
};

服务端解密必须严格对齐参数

前后端 AES-GCM 参数错一个字节，就会解密失败。常见翻车点：

前端用 12 字节 IV，服务端却按 16 字节解析（比如误用 AES-CBC 模式逻辑）
前端传的 tag 是最后 16 字节，服务端没截取、或截多了/少了
服务端用 UTF-8 解码 base64 后的密文，但前端加密的是原始字节数组（需用 Buffer 或 Uint8Array 处理）
没校验 additionalData：攻击者重放旧消息，只要密钥没换就能通过解密

以 PHP 为例，关键校验代码：

$iv = base64_decode($payload['iv']);
$ciphertext = base64_decode($payload['data']);
$tag = base64_decode($payload['tag']);
$full_ciphertext = $ciphertext . $tag;

// 必须指定 tag length，否则 openssl_decrypt 自动忽略认证
$decrypted = openssl_decrypt($full_ciphertext, 'aes-256-gcm', $key, OPENSSL_RAW_DATA, $iv, $tag, $additionalData);