# F8x Usage

> Guide for using f8x, the red/blue team environment automation deployment tool. Use this skill whenever the user asks about installing security tools on a VPS, deploying pentest/red-team/blue-team environments, using f8x commands or flags, querying available tools via catalog, or automating tool installation through MCP/AI Agent integration with RedC. Also trigger when user mentions tool names like nuclei, httpx, nmap, subfinder, sqlmap, metasploit, CobaltStrike, Sliver, or any security tooling deployment on Linux servers.

- Skill: `wgpsec/f8x-usage` (Agent Skill)
- Install (CLI): `npx skillmds@latest add wgpsec/f8x-usage`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wgpsec/f8x-usage/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: wgpsec (https://skillmd.com/u/wgpsec)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wgpsec/f8x-usage

---


# f8x 工具部署指南

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

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

## 安装 f8x

```bash
# 方式 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 权限。

```bash
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 版本。

### 批量安装 (按场景)

| Flag | 说明 | 典型工具 |
|------|------|----------|
| `-b` | 基础环境 | gcc, make, git, curl, vim, jq, unzip, telnet, SSH 优化, BBR |
| `-p` | 代理环境 | DNS 配置 + Proxychains-ng |
| `-d` | 开发环境 | Python3, pip3, Go, Docker, Docker-Compose, SDKMAN |
| `-ka` | 侦查套件 (Type A) | nmap, masscan, httpx, subfinder, ffuf, dirsearch, katana, fscan 等 30+ 工具 |
| `-kb` | 漏洞利用套件 (Type B) | Nuclei, sqlmap, Metasploit, xray, WPScan 等 |
| `-kc` | 后渗透套件 (Type C) | impacket, Responder, CrackMapExec, mitmproxy 等 |
| `-kd` | 密码/杂项 (Type D) | hashcat, jadx, ncat, mapcidr, dnsx 等 |
| `-ke` | 补充/字典 (Type E) | SecLists, hakrawler, subjs, assetfinder |
| `-k` | 完整渗透套件 | -ka + -kb + -kc + -kd + -ke 合并 |
| `-s` | 蓝队工具 | Fail2Ban, chkrootkit, rkhunter, shellpub |
| `-f` | 趣味/实用工具 | AdGuard, fzf, lux, ttyd, duf, yq |
| `-cloud` | 云工具 | Terraform, redc, Serverless, k8spider, kubectl, tccli |
| `-ad` | AD 域攻击 | impacket, Certipy, ligolo-ng 等 |
| `-arsenal` | 多平台二进制集 | 下载 fscan/gogo/spray/cdk/chisel/mimikatz 等的 linux_amd64/arm64/windows 版本到 /pentest/arsenal/ |
| `-all` | 全量部署 | 安装上述所有内容 |

### 单独安装开发组件

| Flag | 说明 |
|------|------|
| `-docker` / `-docker-cn` | Docker (国内镜像版) |
| `-go` | Go 语言 |
| `-nn` | Node.js + npm |
| `-py3` / `-py37` ~ `-py310` | Python 3 (可指定版本) |
| `-ruby` / `-rust` / `-lua` / `-perl` | 其他语言 |
| `-openjdk` / `-oraclejdk` | JDK |
| `-code` | code-server (浏览器版 VS Code) |
| `-chromium` | Chromium 无头浏览器 |
| `-pyenv` / `-jenv` | 版本管理器 |

### 单独安装安全工具

| Flag | 说明 |
|------|------|
| `-cs` / `-cs45` | CobaltStrike 4.3/4.5 |
| `-sliver` / `-sliver-client` | Sliver C2 服务端/客户端 |
| `-msf` | Metasploit |
| `-mythic` | Mythic C2 |
| `-frp` / `-nps` / `-chisel` / `-iox` | 隧道/代理工具 |
| `-rg` | RedGuard C2 前置流量控制 |
| `-awvs` / `-awvs14` / `-awvs15` | AWVS 漏扫 |
| `-arl` | ARL 资产侦查灯塔 (Docker, ~872MB) |
| `-yakit` | Yakit 安全平台 |
| `-wpscan` | WordPress 扫描 |

### 蓝队工具

| Flag | 说明 |
|------|------|
| `-binwalk` | Binwalk 固件分析 |
| `-clamav` | ClamAV 病毒扫描 |
| `-vol` / `-vol3` | Volatility 内存取证 |
| `-suricata` | Suricata IDS/IPS |
| `-lt` | LogonTracer Windows 登录事件分析 |

### 靶场环境 (需要 Docker)

| Flag | 说明 | 磁盘占用 |
|------|------|----------|
| `-vulhub` | VulHub 漏洞复现环境 | ~210MB |
| `-vulfocus` | VulFocus 漏洞靶场平台 | ~1.04GB |
| `-metarget` | Metarget 云原生靶场 | - |
| `-TerraformGoat` | TerraformGoat 云漏洞环境 | - |

### 系统管理

| Flag | 说明 |
|------|------|
| `-info` | 查看系统信息 |
| `-optimize` | 优化系统性能 |
| `-swap` | 配置 swap 分区 |
| `-clear` | 清理系统使用痕迹 |
| `-remove` | 卸载云主机监控 |
| `-rmlock` | 解除包管理器锁 |
| `-update` | 更新 f8x 自身 |
| `-upgrade` | 升级已安装的渗透工具 |

## 伴生脚本

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

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

## 工具分类体系 (10 类)

| 分类 ID | 名称 | 说明 | 代表工具 |
|---------|------|------|----------|
| `basic` | 基础环境 | 编译器、系统工具、网络优化 | gcc, make, git, BBR |
| `development` | 开发环境 | 编程语言和容器 | Docker, Go, Python, Node.js, Rust |
| `pentest-recon` | 渗透侦查 | 资产发现与信息收集 | nmap, masscan, httpx, subfinder, ffuf, katana |
| `pentest-exploit` | 漏洞利用 | 扫描与漏洞利用 | Nuclei, sqlmap, Metasploit, xray |
| `pentest-post` | 后渗透 | 横向移动与权限维持 | impacket, hashcat, CrackMapExec, Responder |
| `blue-team` | 蓝队防御 | 主机安全与取证 | Binwalk, ClamAV, Volatility, Suricata |
| `red-infra` | 红队基础设施 | C2 框架与隧道 | CobaltStrike, Sliver, frp, nps, RedGuard |
| `vuln-env` | 靶场环境 | 漏洞复现与训练 | VulHub, VulFocus, TerraformGoat |
| `misc` | 杂项工具 | 面板、终端增强等 | zsh, fzf, 1Panel, AdGuard |
| `system` | 系统操作 | 更新、清理、优化 | swap 管理, 监控卸载, 日志清理 |

## 预设组合 (Presets)

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

| 预设 ID | 名称 | 包含的 flags |
|---------|------|-------------|
| `pentest-full` | 完整渗透环境 | `-b -d -k` |
| `dev-env` | 开发环境 | `-b -d` |
| `blue-team` | 蓝队防御环境 | `-b -s` |
| `c2-setup` | C2 基础设施 | `-b -d` + 单独安装 C2 |
| `basic-all` | 基础环境 | `-b` |
| `recon-light` | 轻量侦查 | `-b -ka` |

## 工具依赖级别

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

| deps | 含义 | 前置条件 |
|------|------|----------|
| 0 | 仅需基础环境 | wget 即可 (下载二进制) |
| 1 | 需要 Python | 先执行 `-d` 或 `-py3` |
| 2 | 需要 Go | 先执行 `-d` 或 `-go` |
| 3 | 需要 Python + Go | 先安装两者 |

## catalog.json — 结构化工具目录

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

```json
{
  "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:

| MCP 工具 | 参数 | 说明 |
|----------|------|------|
| `get_f8x_catalog` | `category?`, `keyword?` | 查询可用工具列表，支持按分类和关键词筛选 |
| `install_tool` | `case_id`, `tool_name` | 在目标 VPS 上安装指定工具 |
| `get_installed_tools` | `case_id` | 查看目标 VPS 上已安装的工具 (读取 /opt/.f8x/installed.json) |

### 示例: 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 注意磁盘余量