F8x Usage

f8x 工具部署指南

f8x 是红蓝队环境自动化部署工具，支持在 Linux VPS 上一键安装 160+ 安全、开发和运维工具。支持 x86_64 和 aarch64 架构，自动检测系统环境。

项目地址: https://github.com/ffffffff0x/f8x

安装 f8x

# 方式 1: CDN (推荐)
wget -O f8x https://f8x.io/f8x && sudo bash f8x

# 方式 2: GitHub
curl -sSL https://raw.githubusercontent.com/ffffffff0x/f8x/main/f8x -o /tmp/f8x && sudo bash /tmp/f8x

# 在 redc 管理的 VPS 上，软件商店会自动部署 f8x

CLI 参考

单工具管理 (AI Agent 友好接口)

这组命令是 AI Agent 与 f8x 交互的主要方式，其中 --list-tools、--search、--list-installed 无需 root 权限。

f8x -install <tool_name>    # 按名称安装单个工具 (如: f8x -install nuclei)
f8x --list-tools             # 输出所有可用工具 (JSON 格式, 约 160 个)
f8x --list-tools table       # 表格格式输出
f8x --search <keyword>       # 模糊搜索工具 (如: f8x --search scanner)
f8x --list-installed         # 查看已安装的工具 (读取 /opt/.f8x/installed.json)

-install 安装成功后会自动记录到 /opt/.f8x/installed.json，包含工具名、安装时间、安装方式和 f8x 版本。

批量安装 (按场景)

单独安装开发组件

单独安装安全工具

蓝队工具

靶场环境 (需要 Docker)

系统管理

伴生脚本

除主脚本外，f8x 还提供两个专用脚本:

• f8x-ctf — CTF 比赛环境部署 (Web/Misc/Crypto/Pwn/Iot 方向)
• f8x-dev — 中间件/数据库部署 (Apache, Nginx, Tomcat, MySQL, PostgreSQL, Redis, PHP 等)

工具分类体系 (10 类)

预设组合 (Presets)

f8x 的 catalog 中定义了 6 个预设组合，方便快速部署常见场景:

工具依赖级别

每个工具有一个 deps 级别，决定安装前需要什么环境:

catalog.json — 结构化工具目录

f8x 维护一个机器可读的工具目录 catalog.json (部署在 f8x.wgpsec.org)，供外部系统 (如 RedC、AI Agent) 消费。结构:

{
  "version": "1.9.1",
  "catalog_version": 4,
  "modules": [...],     // ~90 个 flag 对应的模块
  "tools": [...],       // ~160 个单独工具 (含 name, description, category, deps, url)
  "categories": [...],  // 10 个分类及工具计数
  "presets": [...]       // 6 个预设组合
}

--list-tools 的 JSON 输出即来源于此数据。

与 redc 配合使用

典型流程

1. 通过 redc 模板开启 VPS 场景 (userdata 自动安装核心依赖)
2. SSH 连接到 VPS
3. 按需通过软件商店 UI 或 f8x -install 加装额外工具

MCP 工具 (AI Agent 可用)

在 RedC 平台中，AI Agent 可通过以下 MCP 工具操作 f8x:

示例: Agent 为 VPS 安装侦查工具

用户: 帮我在这台 VPS 上装 nuclei 和 httpx
Agent:
  1. get_installed_tools(case_id) → 检查是否已装
  2. 若未安装:
     install_tool(case_id, "nuclei") → 安装 nuclei
     install_tool(case_id, "httpx") → 安装 httpx
  3. get_installed_tools(case_id) → 确认安装成功

示例: Agent 部署完整渗透环境

用户: 给这台新 VPS 配一套完整渗透环境
Agent:
  1. 通过 SSH 执行 f8x -b → 基础环境
  2. 通过 SSH 执行 f8x -d → 开发环境 (Go/Python/Docker)
  3. 通过 SSH 执行 f8x -k → 完整渗透套件
  (等同于 preset: pentest-full)

注意事项

• 仅限 Linux: f8x 主脚本仅支持 Linux (Debian/Ubuntu/CentOS/Fedora/Kali)，不要在 macOS 上执行
• 架构检测: 自动识别 x86_64/aarch64，下载对应二进制
• 需要 root: 大部分安装操作需要 root 权限，非 root 用户需 sudo (--list-tools 等查询命令除外)
• 代理设置: 自动读取 http_proxy/https_proxy 环境变量，也可用 -p 安装 Proxychains
• CI 模式: 设置 touch /tmp/IS_CI 跳过交互式确认 (redc 自动设置)
• 安装路径: 二进制工具装到 /usr/local/bin/，Python/Git 工具装到 /pentest/<tool>/
• 安装记录: 每次成功安装记录到 /opt/.f8x/installed.json
• 依赖级别: 安装前注意工具的 deps 级别，确保前置环境已就绪
• 大型工具: 部分工具占用较大磁盘空间 (如 Viper ~2.1GB, VulFocus ~1.04GB, MobSF ~1.54GB)，小规格 VPS 注意磁盘余量