CIRCLean 项目安装与配置指南

CIRCLean 项目安装与配置指南

1. 项目基础介绍

CIRCLean 是一个旨在清理不信任的USB存储设备内容的开源项目。它可以安全地复制USB设备上的文件到另一个设备上，同时按照一定的规则对文件进行检查和转换。这个项目非常适合用于处理可能含有恶意软件的USB存储设备，而不直接将其接入你的主系统。

项目主要使用的编程语言包括 Python、Shell 脚本和 C 语言。

2. 项目使用的关键技术和框架

• libmagic: 用于检测文件类型。
• oletools: 用于分析可能的恶意 Microsoft Office 文件。
• FAT32/NTFS/exFAT filesystems: 支持这些文件系统的USB设备处理。
• Raspbian: 通常运行在 Raspberry Pi 上的操作系统。

3. 安装和配置准备工作

在开始安装 CIRCLean 之前，你需要准备以下物品：

• 一台 Raspberry Pi 设备（推荐使用 Raspberry Pi 3 或以上版本）。
• 一个大于 4GB 的 SD 卡，用于安装 Raspbian 操作系统和 CIRCLean。
• 一个 USB 键盘和鼠标（可选，如果通过 HDMI 连接显示器进行交互操作）。
• 一个显示器（可选，如果需要可视化安装过程）。
• 一个 5V 700mA+ 的电源适配器，用于给 Raspberry Pi 供电。
• 两个 USB 存储设备，一个用于作为源设备（可能含有恶意软件），另一个作为目标设备（用于存放清理后的文件）。

安装步骤

1. 下载 Raspbian 操作系统镜像

   从 Raspberry Pi 官方网站下载最新版本的 Raspbian Lite 镜像。

2. 写入 SD 卡

   使用 Win32DiskImager（Windows 系统）或 dd 命令（Linux/macOS 系统）将 Raspbian 镜像写入 SD 卡。

3. 设置 Raspberry Pi

   将 SD 卡插入 Raspberry Pi，然后连接键盘、鼠标（如果需要）、显示器和电源。

4. 首次启动和配置

   首次启动 Raspberry Pi，按照提示完成初始配置，包括设置语言、时区、键盘布局以及连接到网络。

5. 安装 CIRCLean

   在 Raspberry Pi 上，使用以下命令克隆 CIRCLean 项目仓库：

   git clone https://github.com/CIRCL/Circlean.git
   

   接着，按照项目中的 README.md 文件中的说明进行安装。

6. 准备 USB 设备

   根据项目说明，将不信任的USB设备插入 Raspberry Pi 的顶部 USB 插槽，将你的目标USB设备插入底部 USB 插槽。

7. 运行 CIRCLean

   按照项目说明，执行相应的 Shell 脚本来启动 CIRCLean 的清理过程。

   ./run_circlean.sh
   

   注意：这个过程可能需要一段时间，具体取决于源设备中的文件数量和类型。

8. 完成清理

   清理过程完成后，安全地移除两个 USB 设备，这时你的目标设备中应该包含了经过检查和转换的文件。

以上就是 CIRCLean 项目的详细安装和配置指南，按照这些步骤，即使是编程小白也可以顺利完成安装。