使用js-NaCl解密PyNaCl Box加密文件的问题求助

以下是针对PyNaCl Box加密、js-NaCl解密失败的具体排查方向和解决方案：

• 核对密钥与Nonce的格式及一致性
  PyNaCl的Box基于Curve25519-XSalsa20-Poly1305标准，要求：

  • 公钥/私钥必须是32字节的二进制数据，Nonce固定24字节；
  • 解密时必须使用加密时对应的密钥对（加密用发送方私钥+接收方公钥，解密用接收方私钥+发送方公钥）；
  • 禁止将密钥直接作为字符串传递，需在Node.js中用Buffer.from(keyHex, 'hex')或nacl.util.decodeHex(keyHex)转换为Uint8Array，确保字节完全匹配。

• 拆分加密数据结构
  PyNaCl的box.encrypt(plaintext)方法会自动生成24字节Nonce，并将其前缀到密文头部（密文已包含Poly1305 MAC）。解密时必须先拆分数据：

  1. 从加密二进制数据中截取前24字节作为Nonce；
  2. 剩余部分作为待解密的密文数据，传入js-NaCl的box.open方法。
     若手动指定Nonce加密，需确保解密时传入完全相同的Nonce，且Nonce不可重复用于同一密钥对的加密操作。

• 排查MAC验证失败问题
  js-NaCl的nacl.box.open在MAC验证不通过时会返回null，常见原因：

  • 密钥对不匹配（如误用自身公钥而非发送方公钥）；
  • 数据拆分错误（Nonce长度截取不对，导致密文偏移）；
  • 二进制数据处理错误（如用UTF-8编码存储/读取二进制加密数据，破坏字节结构）。
    建议用Base64或Hex格式存储加密数据，Node.js中解码后再转成Uint8Array。

• 替换为更兼容的库
  js-NaCl维护不活跃，部分版本对XSalsa20-Poly1305的支持存在问题。推荐替换为tweetnacl（标准NaCl实现，与PyNaCl兼容性更好），示例代码如下：

示例代码 #

PyNaCl 加密代码 #

from nacl.public import PrivateKey, Box
import base64

# 实际场景中密钥需提前生成并妥善存储
sender_priv = PrivateKey.generate()
sender_pub = sender_priv.public_key
receiver_priv = PrivateKey.generate()
receiver_pub = receiver_priv.public_key

# 初始化加密Box
box = Box(sender_priv, receiver_pub)
# 自动生成Nonce并加密，结果为Nonce+密文
encrypted_data = box.encrypt(b"your secret content")

# 以Base64格式保存（避免二进制存储问题）
with open("encrypted.bin", "w") as f:
    f.write(base64.b64encode(encrypted_data).decode())

Node.js（tweetnacl）解密代码 #

const nacl = require('tweetnacl');
const fs = require('fs');

// 读取加密数据并解码
const encryptedBase64 = fs.readFileSync("encrypted.bin", "utf8");
const encryptedBytes = nacl.util.decodeBase64(encryptedBase64);

// 拆分Nonce和密文
const nonce = encryptedBytes.slice(0, 24);
const ciphertext = encryptedBytes.slice(24);

// 转换密钥为Uint8Array（实际密钥需从安全存储读取）
const senderPubKey = nacl.util.decodeHex("sender_public_key_hex_string");
const receiverPrivKey = nacl.util.decodeHex("receiver_private_key_hex_string");

// 解密
const decryptedBytes = nacl.box.open(ciphertext, nonce, senderPubKey, receiverPrivKey);

if (decryptedBytes) {
    console.log("解密结果:", nacl.util.encodeUTF8(decryptedBytes));
} else {
    console.error("解密失败：密钥错误、数据篡改或格式不匹配");
}

内容的提问来源于stack exchange，提问作者ameyeralvarez