企业官网建设流程全解析

x_gift_bot 是一个 X Premium 礼品兑换平台（CLI + 兑换网站）：你生成兑换码发给用户，用户在网页输入兑换码和 X 用户名，系统自动完成下单与付款。它的数据安全设计核心是：所有敏感凭据（X Cookie、银行卡、代理配置、订单）在vault.db中以scrypt 密钥派生 + AES-256-GCM 逐条加密存储，没有密码文件，谁都读不出来。本文带你完整拆解这套加密存储是如何实现的。

🔑 第一道防线：唯一的钥匙——密码文件

整个保管库（vault）的安全性，只系于一个0600 权限的随机密码文件（默认sqlite/vault-password）：

• 首次运行时由xgift setup向导自动生成：32 字节随机数（来自操作系统crypto/rand），Base64 编码写入临时文件，见 NewPassword()
• 打开保管库时会强制校验该文件必须是"常规文件且仅属主可读写（0600）"，权限稍有泄露（比如组/其他可读）直接拒绝启动，见 Open() 权限检查
• 密码长度不足 32 字节直接报错；读取后立即从内存中清零

⚠️ 官方警告：密码文件丢失后所有加密数据无法恢复，请务必和数据库一起备份（详见 README.md）。

🔬 第二步：scrypt 密钥派生——把密码"磨"成 256 位密钥

拿到密码后，不能直接当 AES 密钥用。x_gift_bot 使用 scrypt 密钥派生函数：

key, err := scrypt.Key(password, salt, 32768, 8, 1, 32)

几个关键参数和机制：

salt 在 创建保管库时随机生成并落库；派生出的密钥用完立即clear清零。这一步的意义是：即使攻击者偷走vault.db和密码文件中的原始字节，scrypt 的慢速特性也让逐位破解在工程上不可行。

🧊 第三步：AES-256-GCM 逐条加密——每条记录独立密封

密钥就绪后，构建 AES-256 分组加密器并包装为 GCM 模式（cipher.NewGCM）。数据库结构极简：secrets(name, payload)一张表，每条敏感记录就是一行。

写入（Put），见 Put()：

1. 用crypto/rand生成一次性随机 nonce
2. aead.Seal(nonce, nonce, plain, aad)加密：密文 = nonce ∥ 密文 ∥ 认证标签，整体存入payload
3. AAD（附加认证数据）绑定"xgift-v1:"+name——每条记录被"签名"了它自己的名字

读取（Get），见 Get()：

1. 取出payload，前 12 字节是 nonce，其余交给aead.Open解密
2. 同样的 AAD 再参与一次校验——解密与认证一步完成

GCM 模式是 AEAD（认证加密）：它不只加密，还同时验证完整性。任何一位密文被篡改、或某条记录被挪到别的名字下，Open都会直接失败，而不会吐出错误数据。

为什么"逐条"加密很重要？

• 单条损坏或过期不影响全局：比如更新 X Cookie 只重密封cookies这一条，其余记录原封不动
• AAD 防"调包"：把 A 记录的密文改挂到 B 名字下也解不开，名字本身就是认证的一部分
• 每次写入新 nonce，避免重放同一密文

🛡️ 第四层：细节处的防御纵深

源码里还有不少"多此一举但很值"的设计：

• 数据库文件权限：vault.db同样要求 0600，且以_secure_delete=on、_synchronous=FULL打开 SQLite，删除时真正擦除而非留痕，见 数据库连接参数
• 内存清零：密码、派生密钥、解密出的明文在用完即调用内部clear()抹掉
• 自检记录：建库时写入vault-check = xgift-v1，每次打开都要能正确解密它，否则报vault authentication failed（密码错或库损坏），见 鉴权检查
• 原子归档：补单/换单场景用Archive/ReplaceArchived事务，"先解密核验快照→再密封归档→最后换名"，崩溃不会留下无主的付款记录，见 ReplaceArchived()
• 旁路隔离：site.db中的兑换码只存摘要和尾号、不存明文，与保管库分开（README · 数据与安全）

✅ 日常验证：一行命令确认所有密文完好

部署后随时可以跑：

./bin/xgift status

它会逐条解密校验cookies、proxy等记录并输出encrypted record verified，逻辑见 status 命令。六条记录全部verified，说明密钥派生链和每一条 AES-256-GCM 记录都完好无损。

📚 总结：x_gift_bot 数据安全链路一图流

随机密码文件(0600) │ ▼ scrypt 慢速派生（32字节 salt + N=32768） │ ▼ AES-256-GCM 密钥 │ ├── Put：逐条 Seal（随机 nonce + AAD 绑定记录名） ├── Get：逐条 Open（解密+完整性认证一步到位） └── 密码/密钥/明文：用完即内存清零

一句话概括：钥匙只有一个、派生足够慢、每条记录独立密封且自带防篡改签名、敏感内存不留痕。这也是 x_gift_bot 敢于把 Cookie 和银行卡这类高危凭据落在本地 SQLite 里的底气。

延伸阅读：

• 保管库核心实现：internal/vault/vault.go
• 记录命名与按前缀列举：internal/vault/names.go
• 部署与安全说明：README.md