基于node-telegram-bot-api的Telegram机器人敏感用户数据本地存储方案咨询

1. 加密本地文件存储（推荐） #

• 以用户ID/对话ID作为唯一标识，将敏感数据加密后存入本地JSON文件或按用户划分的目录结构，比如为每个用户创建独立子文件夹，存放其加密后的专属数据文件。
• 利用Node.js内置的crypto模块实现加密，推荐使用AES-256-GCM算法，密钥通过环境变量管理（借助dotenv工具），绝对禁止硬编码密钥。
• 核心代码示例：

  const crypto = require('crypto');
  const fs = require('fs').promises;
  const path = require('path');
  const dotenv = require('dotenv');
  dotenv.config();
  
  // 32字节密钥，可通过crypto.randomBytes(32).toString('hex')生成
  const ENCRYPTION_KEY = Buffer.from(process.env.ENCRYPTION_KEY, 'hex');
  const IV_LENGTH = 16;
  
  // 加密函数
  function encrypt(text) {
    const iv = crypto.randomBytes(IV_LENGTH);
    const cipher = crypto.createCipheriv('aes-256-gcm', ENCRYPTION_KEY, iv);
    let encrypted = cipher.update(text);
    encrypted = Buffer.concat([encrypted, cipher.final()]);
    return `${iv.toString('hex')}:${encrypted.toString('hex')}:${cipher.getAuthTag().toString('hex')}`;
  }
  
  // 解密函数
  function decrypt(text) {
    const [ivHex, encryptedHex, tagHex] = text.split(':');
    const iv = Buffer.from(ivHex, 'hex');
    const encryptedText = Buffer.from(encryptedHex, 'hex');
    const tag = Buffer.from(tagHex, 'hex');
    const decipher = crypto.createDecipheriv('aes-256-gcm', ENCRYPTION_KEY, iv);
    decipher.setAuthTag(tag);
    let decrypted = decipher.update(encryptedText);
    decrypted = Buffer.concat([decrypted, decipher.final()]);
    return decrypted.toString();
  }
  
  // 保存用户数据
  async function saveUserData(userId, data) {
    const dirPath = path.join(__dirname, 'user-data', userId);
    await fs.mkdir(dirPath, { recursive: true });
    const encryptedData = encrypt(JSON.stringify(data));
    await fs.writeFile(path.join(dirPath, 'data.enc'), encryptedData);
  }
  
  // 获取用户数据
  async function getUserData(userId) {
    const filePath = path.join(__dirname, 'user-data', userId, 'data.enc');
    try {
      const encryptedData = await fs.readFile(filePath, 'utf8');
      const decryptedData = decrypt(encryptedData);
      return JSON.parse(decryptedData);
    } catch (err) {
      return null; // 处理文件不存在的情况
    }
  }
  

• 优势：完全本地存储，加密后即使文件泄露也无法解析数据，按用户隔离数据便于维护。
• 注意事项：定期备份加密文件，避免服务器故障导致数据丢失；密钥需妥善保管，丢失后无法恢复数据。

2. 内存缓存+定时加密持久化 #

• 用Map或lru-cache等工具在内存中存储用户数据，同时定时将内存中的数据加密后写入本地文件做持久化。
• 适合数据更新频繁、对读取速度要求高的场景，内存读写比文件IO更快，持久化可避免机器人重启后数据丢失。
• 核心思路示例：

  const userDataCache = new Map();
  const PERSIST_INTERVAL = 30 * 60 * 1000; // 每30分钟持久化一次
  
  // 定时触发持久化
  setInterval(async () => {
    for (const [userId, data] of userDataCache.entries()) {
      await saveUserData(userId, data); // 复用上述saveUserData函数
    }
  }, PERSIST_INTERVAL);
  
  // 优先从缓存读取，缓存无数据则从文件加载
  async function getUserData(userId) {
    if (userDataCache.has(userId)) {
      return userDataCache.get(userId);
    }
    const data = await getUserData(userId); // 复用上述getUserData函数
    if (data) {
      userDataCache.set(userId, data);
    }
    return data;
  }
  
  // 更新缓存数据
  function updateUserData(userId, newData) {
    userDataCache.set(userId, { ...userDataCache.get(userId) || {}, ...newData });
  }
  

• 优势：读写效率高，减少文件IO操作；持久化机制保障数据不丢失。
• 注意事项：机器人启动时需先从本地文件加载数据到缓存；可在进程退出时触发一次额外的持久化，避免意外终止导致数据丢失。

3. 原“存消息记ID”方案的优化 #

若坚持使用Telegram消息存储，需做以下优化：

• 先将敏感数据加密，再通过sendMessage发送给机器人自身账号，同时记录消息ID与对应用户ID的映射关系。
• 读取时调用getMessage获取加密内容，解密后使用。
• 劣势：Telegram服务器可能清理旧消息，存在数据丢失风险；API调用有频率限制，仅适合临时存储非核心敏感数据，不推荐作为主要存储方案。

核心注意事项 #

• 所有敏感数据必须加密存储，哪怕是本地文件，防止服务器被入侵后数据泄露。
• 密钥禁止硬编码在代码中，用dotenv管理并将.env文件加入.gitignore，生产环境建议使用专业密钥管理工具。
• 本地存储文件需设置严格权限（如Linux下设置chmod 600），仅允许机器人进程读写。

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