.NET Core 中如何流式加密/解密80MB+大文件

这个问题我之前也帮人梳理过，其实核心思路就是把.NET Core数据保护系统和CryptoStream结合起来用——既利用数据保护系统的密钥自动管理能力，又实现大文件的流式加解密（不用把整个80MB+的文件加载到内存），完美兼顾你的所有需求。

核心逻辑说明 #

数据保护系统确实只支持字节数组的加解密，但我们可以用它来保护一个随机生成的对称加密密钥，然后用这个对称密钥配合CryptoStream做流式的文件加解密。这样既不用自己手动管理密钥（数据保护系统会帮你处理密钥的存储、轮换等），又能实现大文件的流式操作。

具体实现步骤 #

1. 加密流程（生成加密文件） #

• 生成一个随机的对称加密密钥和初始化向量（IV），推荐用AES算法
• 用IDataProtector加密这个密钥和IV，把加密后的字节写入文件开头（或者单独存储，存在文件开头最方便后续读取）
• 创建CryptoStream，把第三方库生成的原始数据流通过CryptoStream加密后写入磁盘

2. 解密流程（MVC下载时解密） #

• 读取加密文件开头的加密密钥和IV，用IDataProtector解密得到原始密钥和IV
• 创建CryptoStream，把磁盘上的加密文件流通过CryptoStream解密，再通过FileStreamResult返回给浏览器

代码示例 #

先确保数据保护服务已配置（.NET 6+ Program.cs） #

builder.Services.AddDataProtection()
    .PersistKeysToFileSystem(new DirectoryInfo(@"C:\YourKeyStoragePath")) // 密钥持久化位置，按需调整
    .SetApplicationName("YourAppUniqueName"); // 确保应用名称唯一，避免密钥混淆

加密大文件的方法 #

private async Task EncryptLargeFileAsync(Stream sourceStream, string outputFilePath, IDataProtector dataProtector)
{
    // 生成AES密钥和IV
    using var aes = Aes.Create();
    aes.KeySize = 256;
    aes.GenerateKey();
    aes.GenerateIV();

    // 用数据保护系统加密密钥和IV
    var protectedKey = dataProtector.Protect(aes.Key);
    var protectedIV = dataProtector.Protect(aes.IV);

    using var outputFileStream = new FileStream(outputFilePath, FileMode.Create, FileAccess.Write);
    // 先写入加密后的密钥/IV长度，方便后续读取解析
    await outputFileStream.WriteAsync(BitConverter.GetBytes(protectedKey.Length));
    await outputFileStream.WriteAsync(BitConverter.GetBytes(protectedIV.Length));
    // 写入加密后的密钥和IV
    await outputFileStream.WriteAsync(protectedKey);
    await outputFileStream.WriteAsync(protectedIV);

    // 创建CryptoStream做流式加密
    using var cryptoStream = new CryptoStream(outputFileStream, aes.CreateEncryptor(), CryptoStreamMode.Write);
    // 把第三方库的源数据流复制到CryptoStream，自动完成加密
    await sourceStream.CopyToAsync(cryptoStream);
}

MVC下载时的解密动作方法 #

private async Task<Stream> DecryptLargeFileStreamAsync(string encryptedFilePath, IDataProtector dataProtector)
{
    var inputFileStream = new FileStream(encryptedFilePath, FileMode.Open, FileAccess.Read);

    // 读取加密后的密钥和IV的长度
    var keyLengthBytes = new byte[4];
    await inputFileStream.ReadAsync(keyLengthBytes, 0, 4);
    var keyLength = BitConverter.ToInt32(keyLengthBytes, 0);

    var ivLengthBytes = new byte[4];
    await inputFileStream.ReadAsync(ivLengthBytes, 0, 4);
    var ivLength = BitConverter.ToInt32(ivLengthBytes, 0);

    // 读取加密后的密钥和IV
    var protectedKey = new byte[keyLength];
    await inputFileStream.ReadAsync(protectedKey, 0, keyLength);
    var protectedIV = new byte[ivLength];
    await inputFileStream.ReadAsync(protectedIV, 0, ivLength);

    // 用数据保护系统解密得到原始密钥和IV
    var key = dataProtector.Unprotect(protectedKey);
    var iv = dataProtector.Unprotect(protectedIV);

    // 创建AES解密器和CryptoStream
    using var aes = Aes.Create();
    var cryptoStream = new CryptoStream(inputFileStream, aes.CreateDecryptor(key, iv), CryptoStreamMode.Read);

    // 返回解密后的流（MVC会自动处理流的释放）
    return cryptoStream;
}

// MVC下载动作
public async Task<IActionResult> DownloadEncryptedFile()
{
    var encryptedFilePath = @"C:\EncryptedFiles\large_sensitive_file.dat";
    // 用途字符串要和加密时完全一致，确保密钥上下文正确
    var dataProtector = _dataProtectionProvider.CreateProtector("FileEncryption:SensitiveData");
    var decryptedStream = await DecryptLargeFileStreamAsync(encryptedFilePath, dataProtector);

    return new FileStreamResult(decryptedStream, "application/octet-stream")
    {
        FileDownloadName = "decrypted_file.zip" // 根据实际文件类型调整MIME类型和文件名
    };
}

其他可选方案？ #

目前这个方案是最贴合你需求的：

• 复用了已有的.NET Core数据保护系统，避免两套密钥管理逻辑
• 完全基于流式操作，不会把大文件加载到内存，性能友好
• 敏感文件存储在磁盘时是加密状态，符合安全要求

如果你不想自己写CryptoStream的逻辑，也可以考虑一些第三方流式加密库，但本质上还是基于「对称加密+密钥保护」的思路，不如自己结合数据保护和CryptoStream来得直接可控。

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