1. 项目概述：为什么需要 Faraday？

如果你是一名安全工程师、渗透测试人员，或者负责企业安全运营，那么“漏洞管理”这个词对你来说一定不陌生。每天，你可能要面对来自各种扫描器、人工测试、第三方报告的海量漏洞数据，它们格式不一、描述混乱，散落在 Excel、PDF、邮件甚至聊天记录里。手动整理、去重、分配、跟踪和复测，不仅效率低下，还极易出错，一个高危漏洞被遗漏的风险会直线上升。

Faraday 就是为了解决这个痛点而生的。它是一个开源的漏洞协同与管理平台（Vulnerability Management Platform），你可以把它理解为一个专为安全团队打造的“漏洞数据中心”和“协同作战室”。它不是一个扫描器，而是一个强大的聚合器和管理器。它能将来自 Nessus、Nmap、Burp Suite、Metasploit、Qualys 等数十种主流安全工具的扫描结果，自动导入、解析、归一化，并以统一的视图呈现出来。所有漏洞信息、资产信息、证据（截图、PoC）、团队讨论、修复状态都集中在一个地方，实现从发现到修复的闭环跟踪。

我最初接触 Faraday 是因为团队内部漏洞流转全靠人工表格，混乱不堪。在对比了多个开源和商业方案后，最终选择了 Faraday。原因很简单：它足够轻量、灵活，且完全由社区驱动，没有商业产品的黑盒和绑定。你可以完全掌控自己的数据，并根据团队的工作流进行深度定制。对于中小型安全团队或预算有限的个人研究者而言，Faraday 提供了一个近乎完美的起点。

接下来，我将以一个“从零到一”的视角，带你完整走一遍 Faraday 的安装、配置和核心使用流程。我会分享官方文档里不会写的细节，以及我在实际部署和日常使用中踩过的坑和总结的技巧。无论你是想在个人实验环境搭建一个玩一玩，还是准备为团队部署一套生产级系统，这篇指南都能给你提供直接的参考。

2. 环境准备与安装方案选型

在真正动手安装之前，花点时间规划你的部署方案至关重要。Faraday 提供了多种安装方式，选择哪种取决于你的使用场景、技术栈和运维能力。

2.1 理解 Faraday 的架构与依赖

Faraday 是一个典型的客户端-服务器（C/S）架构应用：

• Faraday Server： 这是核心，一个基于 Web 的应用程序，负责数据存储、API 接口和用户界面。它后端主要依赖 PostgreSQL 数据库和 Redis（用于缓存和消息队列）。
• Faraday Client： 这是一个命令行工具（CLI），安装在你的工作机上。你通过它来执行命令，将扫描报告上传到 Faraday Server，或者直接从 CLI 启动一些集成工具（如 Nmap）并将结果实时流式传输到服务器。

因此，安装 Faraday 本质上是在部署一个包含 Web 应用、数据库和缓存服务的微服务栈。

2.2 主流安装方案对比与选择

官方和社区主要推荐以下几种方式，我为你梳理了各自的优劣和适用场景：

方案一：Docker Compose（推荐给绝大多数用户）这是目前最主流、最省心的安装方式。官方提供了完整的docker-compose.yml文件，一键拉起所有服务（Server, PostgreSQL, Redis）。

• 优点： 隔离性好，部署极快，几乎无需关心系统依赖和版本冲突。升级和迁移也相对容易。
• 缺点： 需要你对 Docker 和 Docker Compose 有基本了解。数据持久化需要正确配置卷（Volume）。
• 适用场景： 个人学习、团队测试环境、中小型生产环境。这是我最推荐的入门和生产部署方式。

方案二：Python pip 直接安装通过pip install faraday-server和pip install faraday-cli分别安装服务器和客户端。

• 优点： 最“原生”的方式，适合喜欢深度定制和开发的用户。
• 缺点： 需要手动安装和配置 PostgreSQL、Redis 等所有依赖，过程繁琐，容易因系统环境（如 Python 版本、系统库）导致安装失败。
• 适用场景： 开发者、希望贡献代码的社区成员，或者需要在无法运行 Docker 的特殊环境中部署。

方案三：从源码运行（适用于开发）直接克隆 GitHub 仓库，在本地运行开发服务器。

• 优点： 可以直接调试和修改代码，实时看到变化。
• 缺点： 配置最复杂，仅适用于开发目的。
• 适用场景： 为 Faraday 项目做代码贡献或进行二次开发。

我的选择与建议： 除非你有强烈的开发需求，否则无脑选择 Docker Compose 方案。它能让你在10分钟内看到一个可运行的 Faraday，把精力集中在学习使用上，而不是和系统依赖搏斗。本指南也将以 Docker Compose 方案为主线进行详解。

2.3 基础环境准备

无论选择哪种方案，你都需要准备一台 Linux 服务器（Ubuntu 20.04/22.04 LTS 或 CentOS/RHEL 8+ 是常见选择）或一台性能足够的个人电脑（Windows/macOS 可通过虚拟机或 WSL2 运行 Linux）。

对于 Docker 方案，请确保：

1. 安装 Docker Engine： 版本建议 20.10+。
2. 安装 Docker Compose： 版本建议 v2.0+。请注意，现在 Docker Compose 通常作为 Docker Desktop 的一部分或独立的docker-compose-plugin提供，命令可能是docker compose（没有横杠）。

你可以通过以下命令快速检查：

docker --version docker compose version

如果系统没有安装，请参考 Docker 官方文档进行安装。对于 Ubuntu，一个快速的安装脚本如下（生产环境请务必阅读官方文档）：

# 卸载旧版本 sudo apt-get remove docker docker-engine docker.io containerd runc # 安装依赖 sudo apt-get update sudo apt-get install ca-certificates curl gnupg lsb-release # 添加 Docker 官方 GPG 密钥 sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gosu tee /etc/apt/keyrings/docker.asc > /dev/null # 设置仓库 echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null # 安装 Docker sudo apt-get update sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

3. 使用 Docker Compose 部署 Faraday Server

这是最核心的步骤，我们将一步步搭建起 Faraday 的服务端。

3.1 获取与配置 Docker Compose 文件

首先，创建一个专门的工作目录，并获取官方提供的编排文件。

mkdir faraday-docker && cd faraday-docker curl -o docker-compose.yml https://raw.githubusercontent.com/infobyte/faraday/master/docker-compose.yml

下载完成后，不要急着启动。我们先来审视并修改这个docker-compose.yml文件，以满足基本的安全和持久化需求。用文本编辑器打开它。

你需要关注和修改以下几个关键部分：

1. 数据库密码： 在postgres服务的environment部分，找到POSTGRES_PASSWORD。务必修改为一个强密码，不要使用默认值。

   environment: POSTGRES_USER: faraday POSTGRES_PASSWORD: YourStrongPasswordHere! # 修改这里 POSTGRES_DB: faraday

2. Faraday Server 密钥： 在faraday-server服务的environment部分，找到SECRET_KEY。这是 Django 应用用于签名会话、CSRF 令牌等的重要密钥，必须修改，且应使用一个长而复杂的随机字符串。

   environment: SECRET_KEY: YourVeryLongAndRandomSecretKeyString # 修改这里 ...

3. 数据持久化（最重要）： 默认的 compose 文件可能没有将 PostgreSQL 的数据目录映射到宿主机。这意味着一旦容器重建，所有漏洞数据都会丢失！必须添加卷映射。

   services: postgres: image: postgres:13-alpine ... volumes: - postgres_data:/var/lib/postgresql/data # 确保这一行存在 ... faraday-server: image: faradaysec/faraday:latest ... volumes: - faraday_data:/home/faraday/.faraday # 确保这一行存在，存储服务器配置、上传的文件等 ... # 在文件最底部，定义这些卷 volumes: postgres_data: faraday_data:

   如果volumes部分不存在，请手动添加。这样，数据就会保存在 Docker 管理的命名卷中，即使容器删除，数据卷依然存在。

4. 网络与端口： 默认情况下，Faraday Server 的 Web 服务会映射到宿主机的5985端口。你可以根据情况修改。例如，如果你想用标准的 HTTP 端口，可以修改faraday-server服务的端口映射：

   ports: - "8080:5985" # 将宿主机8080端口映射到容器5985端口

3.2 启动 Faraday 服务栈

配置完成后，在docker-compose.yml所在目录执行启动命令：

docker compose up -d

-d参数表示在后台运行。首次运行会从 Docker Hub 拉取镜像，需要一些时间。

启动后，使用以下命令查看容器状态：

docker compose ps

你应该看到postgres，redis，faraday-server三个容器的状态都是Up。

3.3 初始化与首次访问

容器启动后，Faraday Server 需要一点时间进行数据库迁移和初始化。你可以通过查看日志来确认进度：

docker compose logs -f faraday-server

当看到类似Starting development server at http://0.0.0.0:5985/和Quit the server with CONTROL-C.的日志时，说明服务已就绪。

现在，打开你的浏览器，访问http://<你的服务器IP>:5985（如果你修改了端口映射，则使用对应的端口）。

首次访问，你会看到 Faraday 的登录界面。默认的管理员账号和密码是admin/admin。

重要安全提示： 使用默认凭证登录后，第一件必须做的事就是修改管理员密码！在 Web 界面右上角用户下拉菜单中，进入 “Profile” 或 “Change Password” 进行修改。

3.4 常见安装问题排查

即使按照步骤操作，你也可能会遇到一些问题。这里记录几个我踩过的坑：

问题1：启动失败，提示端口被占用。

• 原因： 宿主机上已有其他服务占用了5985或 PostgreSQL 的5432端口。
• 解决： 修改docker-compose.yml中的端口映射。例如，将"5985:5985"改为"55985:5985"。

问题2：Faraday Server 容器不断重启，日志显示数据库连接失败。

• 原因： PostgreSQL 容器尚未完全启动，Faraday Server 就尝试连接，导致失败。
• 解决： Docker Compose 的depends_on只保证容器启动顺序，不保证服务就绪。可以：
  1. 增加重启策略：在faraday-server服务下添加restart: unless-stopped。
  2. 手动等待：先docker compose up -d postgres redis，等待几十秒后，再docker compose up -d faraday-server。
  3. 使用healthcheck（高级）：在postgres服务定义中添加健康检查，让 Faraday Server 依赖其健康状态。

问题3：上传文件或操作时提示权限错误。

• 原因： Docker 容器内用户（通常是faraday）对映射的宿主机目录没有写权限。
• 解决： 确保宿主机上持久化目录（如果使用绑定挂载bind mount）的权限正确。更简单的方法是使用 Docker 命名卷（named volume，如我们之前配置的faraday_data），让 Docker 管理权限。

4. Faraday Client 的安装与配置

Server 端搭建好了，现在我们需要在用来做渗透测试或安全评估的工作机（可能是 Kali Linux， 也可能是你自己的笔记本）上安装 Client， 这样才能把数据发送到 Server。

4.1 安装 Faraday CLI

Faraday CLI 是一个 Python 包，通过 pip 安装是最简单的方式。强烈建议使用虚拟环境，以避免与系统或其他项目的 Python 包冲突。

# 1. 创建并进入虚拟环境（以 venv 为例） python3 -m venv faraday-env source faraday-env/bin/activate # Linux/macOS # 对于 Windows: faraday-env\Scripts\activate # 2. 安装 faraday-cli pip install faraday-cli

安装完成后，验证是否成功：

faraday-cli --version

4.2 连接 Faraday Server

安装好 CLI 后，需要让它知道你的 Server 在哪里。这里有两种主要的认证方式：API Key和用户名密码。推荐使用 API Key， 更安全且适合自动化。

方法一：使用用户名密码连接（初次配置）

faraday-cli auth -f <SERVER_URL> -u <USERNAME> -p <PASSWORD>

例如：

faraday-cli auth -f http://192.168.1.100:5985 -u admin -p your_new_password

执行成功后，凭证会保存在~/.faraday/config文件中。

方法二：使用 API Key（推荐）

1. 在 Faraday Web 界面中，点击右上角用户名 -> “My Profile”。
2. 找到 “API Key” 部分，点击 “Generate new API Key”。复制生成的长字符串。
3. 在终端使用 API Key 登录：

   faraday-cli auth -f <SERVER_URL> --api-key <YOUR_API_KEY>

连接成功后，你可以测试一下：

faraday-cli workspace list

这条命令会列出 Server 上所有的工作空间（Workspace）。初始状态下，列表应该是空的。

5. 核心概念与工作流实战

在开始导入漏洞之前，必须理解 Faraday 的几个核心概念，它们构成了你日常使用的框架。

5.1 工作空间（Workspace）：你的项目沙盒

Workspace 是 Faraday 中最核心的隔离单元。你可以为每一次安全评估、每一个客户、每一个应用系统创建一个独立的工作空间。所有相关的资产、漏洞、笔记都归属于某个工作空间，不同工作空间之间的数据完全隔离。

创建第一个工作空间：

faraday-cli workspace create --name "Pentest-Project-Alpha-2024"

• --name: 工作空间名称，最好有明确标识，如客户名-项目名-日期。
• 你还可以通过--description添加描述。

创建后，使用select命令进入该工作空间，后续所有操作默认都在此空间内进行。

faraday-cli workspace select Pentest-Project-Alpha-2024

5.2 资产（Host）与服务（Service）：构建你的攻击面地图

在 Faraday 中，资产不仅指一台主机（IP/Domain），还包括其上运行的服务（端口、协议、横幅信息）。这种层级关系更符合真实的网络环境。

手动添加一个资产：

faraday-cli host add --ip 192.168.1.10 --os "Linux"

为这个资产添加一个服务：

faraday-cli service add --host-ip 192.168.1.10 --name "http" --port 80 --protocol "tcp"

当然，更常见的做法是通过导入扫描报告来自动化添加资产和服务。

5.3 漏洞（Vulnerability）与证据（Evidence）

漏洞是管理的核心对象。每个漏洞都关联到特定的主机和服务，并包含名称、描述、严重等级（Critical, High, Medium, Low, Info）、状态（Open, Re-opened, Closed, Risk-Accepted）、解决方案等字段。

证据（Evidence）功能非常实用。你可以为漏洞附加截图、命令输出、PoC代码等文件，这在报告编写和内部复核时是无可辩驳的支撑材料。

6. 实战：导入扫描报告与数据聚合

这是 Faraday 的“高光时刻”。我们将把来自不同工具的扫描结果导入到同一个工作空间，体验数据聚合的魅力。

6.1 准备扫描报告

假设我们针对目标192.168.1.0/24进行了以下扫描：

1. Nmap： 全面的端口和服务发现。
2. Nessus： 漏洞扫描。
3. Burp Suite： Web 应用漏洞扫描。

请确保你拥有这些工具的输出报告文件。Faraday 支持多种格式，如 Nmap 的 XML (-oX)， Nessus 的.nessus， Burp 的 XML 等。

6.2 使用 CLI 导入报告

首先，确保你已经选中了目标工作空间。

导入 Nmap XML 报告：

faraday-cli tool report import --tool nmap --file /path/to/your/nmap_scan.xml

这个命令会解析 Nmap 报告，自动创建或更新工作空间中的主机（Host）和服务（Service）信息。

导入 Nessus 报告：

faraday-cli tool report import --tool nessus --file /path/to/your/scan.nessus

Nessus 报告包含详细的漏洞信息。导入后，Faraday 会创建对应的漏洞（Vulnerability）条目，并自动关联到之前由 Nmap 创建的主机和服务上。如果主机不存在，它也会被创建。

导入 Burp Suite XML 报告：

faraday-cli tool report import --tool burp --file /path/to/your/burp_scan.xml

6.3 在 Web 界面中查看聚合结果

现在，打开 Faraday 的 Web 界面，进入 “Pentest-Project-Alpha-2024” 工作空间。

1. 仪表盘： 你会看到一个概览，显示漏洞数量分布（按严重性）、主机统计、最近活动等。
2. 主机视图： 点击左侧菜单的 “Hosts”，你会看到一个清晰的列表，列出了所有从 Nmap 和 Nessus 报告中发现的主机。点击任意主机，可以看到它的详细信息：IP、操作系统、所有开放端口/服务，以及在这台主机上发现的所有漏洞（无论来自 Nessus 还是 Burp）。
3. 漏洞视图： 点击 “Vulnerabilities”，这里列出了所有漏洞，可以按严重性、状态、工具来源等进行筛选。最关键的是，来自 Nessus 的 “Apache Tomcat 信息泄露” 和来自 Burp 的 “Cross-Site Scripting (XSS)” 现在都在同一个列表里了，你可以进行统一排序和优先级划分。
4. 数据关联： 点击一个漏洞，进入详情页。你会看到这个漏洞属于哪台主机、哪个服务，它的完整描述、解决方案，以及它是由哪个工具（Nessus）发现的。你还可以在这里添加笔记、更改状态、上传证据截图。

实操心得： 导入顺序有时很重要。建议先导入网络发现类报告（如 Nmap），建立资产骨架，再导入漏洞详情报告（如 Nessus, Burp）。这样漏洞能更准确地关联到已有的服务上。如果顺序反了，Faraday 也能处理，但可能需要在 Web 界面上手动调整一些关联。

7. 漏洞生命周期管理与团队协作

数据聚合只是第一步，如何高效地管理这些漏洞的修复流程，才是 Faraday 作为“管理平台”的价值所在。

7.1 漏洞状态与工作流

Faraday 为每个漏洞定义了状态机：

• Open： 新发现的漏洞，待处理。
• Re-opened： 被重新打开的漏洞（例如修复后验证不通过）。
• Closed： 已修复并验证通过的漏洞。
• Risk-Accepted： 经评估决定接受该风险，不予修复。

在漏洞详情页，你可以直接更改状态。一个典型的流程是：测试人员将漏洞状态设为Open并分配给开发负责人；开发修复后，状态改为Closed；测试人员复测，如果通过则保持关闭，如果不通过则改为Re-opened。

7.2 分配与通知

在漏洞详情页或列表页，你可以将漏洞分配（Assign）给团队中的特定成员。被分配的用户会在 Web 界面上收到通知（通常在顶部的铃铛图标处）。

这是实现责任到人的关键，避免了漏洞在群里@一下就被淹没的情况。所有分配和状态变更历史都会被记录，便于追溯。

7.3 自定义字段与标签

对于大型或复杂项目，默认字段可能不够用。Faraday 允许你为漏洞添加自定义字段，例如 “业务影响等级”、“修复截止日期”、“CWE编号” 等。

标签（Tags）功能则更灵活，你可以快速为一批漏洞打上诸如need-poc、false-positive、third-party-component等标签，方便后续筛选和批量操作。

7.4 报告生成

漏洞修复完成后，你需要向管理层或客户提交报告。Faraday 内置了报告生成功能。

1. 在 Web 界面，进入你的工作空间。
2. 点击左侧菜单的 “Reporting”。
3. 你可以选择生成Executive Summary（给管理层看的概览）或Detailed Report（给技术团队看的详情）。
4. 在生成前，可以筛选特定严重性、状态或标签的漏洞。
5. 报告支持 PDF 和 HTML 格式导出。导出的报告会包含漏洞统计图表、漏洞列表详情（含描述、解决方案、证据截图）等所有关键信息。

避坑技巧： 内置报告模板可能不符合你公司的格式要求。Faraday 支持自定义报告模板（需要修改服务器端的模板文件）。对于 Docker 安装，你需要将自定义模板文件挂载到容器内的/home/faraday/.faraday/reports/templates/目录。这是一个进阶用法，但能极大提升报告输出的专业性。

8. 高级技巧与集成应用

掌握了基础操作后，下面这些技巧能让你的 Faraday 用起来更顺手、更强大。

8.1 使用 Faraday CLI 进行实时同步

除了导入静态报告，Faraday CLI 还能与一些工具进行实时集成。例如，你可以让 Nmap 扫描的结果实时流入 Faraday，而不是先存文件再导入。

nmap -sV -O 192.168.1.0/24 -oX - | faraday-cli tool run --tool nmap --workspace Pentest-Project-Alpha-2024 -

这条命令将 Nmap 的 XML 输出通过管道 (|) 直接传递给faraday-cli tool run，实现实时导入。这在进行交互式测试时非常有用。

8.2 利用 API 实现自动化

Faraday 提供了完整的 REST API。这意味着你可以将漏洞管理流程集成到你的 CI/CD 管道或自动化脚本中。

• 场景一：自动创建工单。 当 Faraday 中出现一个Critical漏洞时，通过 API 触发脚本，在 Jira 或 GitLab 中自动创建一个高优先级任务。
• 场景二：资产同步。 定期从 CMDB 系统通过 Faraday API 同步资产列表，确保评估范围准确。
• 场景三：自定义仪表盘。 拉取 Faraday 的数据，在公司内部的 Grafana 大屏上展示安全态势。

API 文档通常可以在你的 Faraday Server 地址后加/api/v2/docs访问（如http://your-server:5985/api/v2/docs）。

8.3 性能调优与维护

随着数据量增长，你可能会遇到性能问题。以下是一些优化点：

1. 数据库索引： 确保 PostgreSQL 数据库表有合适的索引。对于大型部署，可能需要 DBA 介入优化。
2. 定期清理： 删除不再需要的旧工作空间。可以使用 CLI 或 Web 界面操作。
3. 备份策略：务必定期备份！对于 Docker 部署，备份就是备份postgres_data和faraday_data这两个卷。你可以使用docker compose exec执行pg_dump，或者直接备份整个卷的物理文件。

   # 简单备份示例 docker compose exec postgres pg_dump -U faraday faraday > faraday_backup_$(date +%Y%m%d).sql

4. 升级版本： 关注 Faraday 的 GitHub 发布页。升级前，务必完整备份数据。对于 Docker 部署，升级通常只需修改docker-compose.yml中的镜像标签（如faradaysec/faraday:latest改为faradaysec/faraday:4.5.0），然后执行docker compose pull和docker compose up -d。

9. 常见问题与故障排除实录

这里汇总了我和社区里经常遇到的一些问题及其解决方法。

Q1： 导入报告时，CLI 提示 “Connection refused” 或 “Cannot reach Faraday”。

• 检查： 首先用faraday-cli workspace list测试连接。如果失败，检查：
  1. Faraday Server 的地址和端口是否正确。
  2. 服务器防火墙是否放行了该端口。
  3. 如果 Server 在 Docker 内，CLI 在宿主机外，确保端口映射正确且网络可达。
  4. 运行docker compose logs faraday-server查看服务器日志是否有错误。

Q2： 导入 Nessus 报告后，漏洞数量远少于 Nessus 客户端里看到的。

• 原因： Faraday 的 Nessus 解析器可能只解析了它认为的“漏洞”类型，而忽略了“信息类”发现。此外，Nessus 的.nessus文件可能包含多个扫描策略的结果，解析逻辑可能不同。
• 解决： 这是开源解析器的常见情况。可以尝试在 Nessus 中导出时，选择不同的格式（如 CSV）看是否能包含更多信息。或者，将 Faraday 的解析结果视为“已确认的高价值漏洞子集”，手动补充重要信息。

Q3： Web 界面操作缓慢，特别是打开包含大量漏洞的主机详情页时。

• 原因： 可能是前端渲染大量数据导致，也可能是数据库查询慢。
• 解决：
  1. 尝试在漏洞列表页使用筛选器，减少一次性加载的数据量。
  2. 检查服务器资源（CPU、内存）使用情况。
  3. 对于生产环境，考虑为 PostgreSQL 增加资源，并参考上一节的性能调优建议。

Q4： 忘记管理员密码怎么办？

• 解决： 通过 Docker 容器执行 Django 命令重置密码。

  docker compose exec faraday-server faraday-manage changepassword admin

  然后根据提示输入新密码即可。

Q5： 如何批量修改漏洞状态或分配负责人？

• 解决： Web 界面提供了批量操作功能。在漏洞列表页，勾选多个漏洞，顶部会出现一个操作栏（Action Bar），你可以在这里批量更改状态、分配、打标签或删除。这是管理大量漏洞的必备技能。

从最初的手忙脚乱到现在的得心应手，Faraday 已经成为我们团队安全运营中不可或缺的一环。它最大的价值不在于技术有多炫酷，而在于它用一套相对简单清晰的逻辑，把漏洞管理的“脏活累活”流程化了。数据聚合、状态跟踪、团队协作、报告生成，这些重复性工作被自动化，让我们能更专注于漏洞分析和技术研究本身。

对于刚接触的朋友，我的建议是：先搭起来，用起来。不要一开始就追求完美的部署架构或复杂的自定义流程。用一个 Docker Compose 快速搭建测试环境，导入一两个真实的扫描报告，玩玩它的界面和基础功能。当你切身感受到它如何把你从多个 Excel 表格中解放出来时，你自然会去探索更高级的用法。开源项目的另一个好处是，当你遇到问题或有好点子时，可以直接去 GitHub 上提 Issue 或参与讨论，社区的反馈往往比商业支持更热情、更贴近实际需求。