跳转至

安全考虑

本页面详细介绍二维码文件传输系统中的安全机制，包括数据完整性保护、哈希链验证以及配置安全选项，为高级开发者提供全面的安全实现解析。

数据完整性保护

系统通过多层次的哈希计算与验证机制，确保数据在传输过程中的完整性。每个关键操作步骤都会生成对应的哈希值并记录到区块链中：

  • 文件压缩阶段：对压缩后的文件计算哈希值，确保文件压缩前后的一致性
  • Base64编码阶段：对编码后的字符串计算哈希，防止编码过程中数据损坏
  • 数据块分割阶段：每个数据块独立计算哈希并嵌入二维码，确保单块数据完整性
  • 二维码生成阶段：记录生成的二维码数量，确保输出结果的完整性

哈希计算支持多种算法，包括 SHA256（默认）、SHA512 和 MD5，可根据安全需求进行选择。系统使用 Crypto.Hash 库实现哈希计算，确保密码学安全性。

flowchart TD
    A[原始文件] -->|压缩| B[压缩文件]
    B -->|计算哈希| C[压缩文件哈希]
    C -->|写入区块链| D[区块链区块]
    B -->|Base64编码| E[Base64字符串]
    E -->|计算哈希| F[Base64哈希]
    F -->|写入区块链| D
    E -->|分割数据块| G[数据块列表]
    G -->|每块计算哈希| H[块哈希列表]
    H -->|嵌入二维码| I[二维码数据]
    I -->|记录数量| J[二维码数量哈希]
    J -->|写入区块链| D

Sources: main.py, modules/validator.py

区块链（哈希链）验证

系统实现了轻量级的哈希链（Blockchain）机制，用于记录和追溯整个数据传输流程：

  • 创世块：系统启动时自动创建，作为哈希链的起点
  • 操作记录：每个关键操作（压缩、编码、二维码生成等）都会创建新的区块
  • 链接机制：每个新区块包含前一个区块的哈希值，形成不可篡改的链式结构
  • 持久化存储：哈希链保存在 hash_chain.json 文件中，采用"先写临时文件再重命名"的策略防止写入中断导致文件损坏
  • 并发安全：使用线程锁确保多线程环境下的哈希链写入安全

通过哈希链，可以验证整个传输流程的完整性，防止数据被篡改或操作被伪造。

classDiagram
    class Block {
        +float timestamp
        +str operation_type
        +str task_id
        +str data_hash
        +str previous_hash
        +str hash
        +calculate_hash()
        +to_dict()
        +from_dict()
    }
    class Blockchain {
        +list chain
        +str chain_file
        +bool is_enabled
        +_lock
        +_load_chain()
        +_save_chain()
        +_create_genesis_block()
        +add_block()
        +is_chain_valid()
        +get_chain_length()
        +get_block_by_index()
        +get_blocks_by_task_id()
        +get_blocks_by_operation_type()
    }
    Blockchain "1" --> "*" Block : contains

Sources: modules/blockchain.py

配置安全选项

系统提供了灵活的安全配置选项，可在 config.ini 文件中进行调整：

配置项 说明 可选值 默认值 安全建议
Blockchain.Enabled 是否启用哈希链功能 True/False True 保持启用以获得完整审计追踪
Blockchain.HashAlgorithm 哈希算法选择 SHA256/SHA512/MD5 SHA256 高安全场景使用 SHA512，避免 MD5
Blockchain.ChainFile 哈希链文件存储路径 任意有效路径 hash_chain.json 限制文件访问权限，定期备份
Log.LogLevel 日志级别 DEBUG/INFO/WARNING/ERROR/CRITICAL INFO 生产环境使用 INFO 或 WARNING
Log.LogFile 日志文件路径 任意有效路径 qrcode_transfer.log 限制文件访问权限，定期归档

Sources: config.ini

安全最佳实践

为确保系统在使用过程中的安全性，建议遵循以下最佳实践：

  1. 定期备份哈希链：定期备份 hash_chain.json 文件，防止意外丢失
  2. 选择合适的哈希算法：根据安全需求选择适当的哈希算法，SHA512 提供最高安全性
  3. 保护配置文件：限制 config.ini 文件的访问权限，防止未经授权的修改
  4. 监控日志文件：定期检查 qrcode_transfer.log 日志文件，及时发现异常操作
  5. 验证数据完整性：在接收完成后，使用 验证区块链完整性 功能确保数据未被篡改
  6. 安全存储临时文件：确保临时文件目录（默认 temp）的访问权限受限，系统会自动清理临时文件但仍需注意
  7. 隔离生产环境：在生产环境中使用独立的用户账户运行系统，避免使用管理员权限

下一步

了解了安全机制后，您可能还想查看：