本文详解如何用 go 标准库 crypto/aes 和 crypto/cipher 安全加密文件，涵盖 iv 生成规范、流式加解密实现、密文结构设计及关键安全注意事项。
本文详解如何用 go 标准库 crypto/aes 和 crypto/cipher 安全加密文件，涵盖 iv 生成规范、流式加解密实现、密文结构设计及关键安全注意事项。
在 Go 中使用 AES 加密文件时，仅调用 XORKeyStream 并不能自动完成文件读写——它只是一个内存级字节异或操作，需开发者显式管理文件 I/O、IV 生成与密文封装。下面将从实践出发，提供一个生产就绪（production-ready）的加密函数，并逐项说明关键设计决策。
✅ 正确生成 IV：随机性 + 可复原性
IV（初始化向量）必须满足两个核心要求：唯一性（uniqueness）和不可预测性（unpredictability）。绝不能复用密钥派生 IV（如 iv := key[:aes.BlockSize]），这会严重削弱 CFB 模式的安全性。正确做法是：
- 使用 crypto/rand.Reader 生成密码学安全的随机 IV；
- 将 IV 明文前置到密文开头（标准做法），便于解密时直接读取；
- IV 长度恒为 aes.BlockSize（即 16 字节，对应 AES-128/192/256）。
iv := make([]byte, aes.BlockSize)
if _, err := io.ReadFull(rand.Reader, iv); err != nil {
return fmt.Errorf("failed to generate IV: %w", err)
}
⚠️ 注意：io.ReadFull 确保读满 16 字节；若用 rand.Read(iv)，需手动检查返回长度与错误。
Self-hosted Crypto Payment下载在 Next.js + Supabase 应用中集成自托管加密支付结账，支持 ETH、BTC、SOL、USDC、USDT 及 9 条链的25+ 币种，无需支付处理机构。
✅ 流式加密文件：避免内存爆炸
上述示例中 ioutil.ReadFile 会将整个文件加载进内存，对大文件（如 GB 级备份）极不友好。应改用 流式处理（streaming），结合 io.Pipe 或分块读写：
func encryptFile(srcPath, dstPath string, key []byte) error {
// 1. 打开源文件
src, err := os.Open(srcPath)
if err != nil {
return fmt.Errorf("failed to open source: %w", err)
}
defer src.Close()
// 2. 创建目标文件
dst, err := os.Create(dstPath)
if err != nil {
return fmt.Errorf("failed to create destination: %w", err)
}
defer dst.Close()
// 3. 生成并写入 IV（16 字节）
iv := make([]byte, aes.BlockSize)
if _, err := io.ReadFull(rand.Reader, iv); err != nil {
return fmt.Errorf("failed to generate IV: %w", err)
}
if _, err := dst.Write(iv); err != nil {
return fmt.Errorf("failed to write IV: %w", err)
}
// 4. 初始化 AES + CFB 加密器
block, err := aes.NewCipher(key)
if err != nil {
return fmt.Errorf("invalid key: %w", err)
}
stream := cipher.NewCFBEncrypter(block, iv)
// 5. 流式加密：读一块 → 加密一块 → 写一块
buf := make([]byte, 64*1024) // 64KB 缓冲区（可根据 I/O 性能调整）
for {
n, err := src.Read(buf)
if n > 0 {
stream.XORKeyStream(buf[:n], buf[:n])
if _, writeErr := dst.Write(buf[:n]); writeErr != nil {
return fmt.Errorf("failed to write encrypted data: %w", writeErr)
}
}
if err == io.EOF {
break
}
if err != nil {
return fmt.Errorf("failed to read source: %w", err)
}
}
return nil
}
? 关键安全与工程建议
- 密钥管理：示例中硬编码 []byte("example key 1234") 仅用于演示。生产环境必须通过环境变量、密钥管理服务（KMS）或派生函数（如 scrypt/PBKDF2）安全注入密钥。
- 模式选择：CFB 是流模式，适合加密任意长度数据，但不提供完整性校验。如需防篡改，务必叠加 HMAC（如 crypto/hmac）或改用 AEAD 模式（如 gcm，推荐）。
- 错误处理：所有 I/O 和密码学操作均需显式检查错误，避免静默失败。
- 文件权限：加密后文件应设置严格权限（如 0600）：os.Chmod(dstPath, 0600)。
- 解密对照：解密函数需先读取前 16 字节作为 IV，再用 cipher.NewCFBDecrypter 流式还原——逻辑对称，此处略。
✅ 完整调用示例
func main() {
key := []byte("your-32-byte-secret-key-for-aes-256") // 必须 16/24/32 字节
if err := encryptFile(
"/home/bacula/cloud-backup/logs/app.log",
"/home/bacula/cloud-backup/logs/app.log.aes",
key,
); err != nil {
log.Fatal("Encryption failed:", err)
}
log.Println("Encryption completed successfully.")
}
遵循以上实践，你将获得一个内存可控、IV 安全、结构清晰且符合密码学最佳实践的 Go 文件加密方案。记住：加密易，安全难——每一个细节（IV、密钥、模式、完整性）都决定最终防线是否牢不可破。
