| name | f8x-usage |
| description | 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. |
f8x 工具部署指南
f8x 是红蓝队环境自动化部署工具，支持在 Linux VPS 上一键安装 160+ 安全、开发和运维工具。支持 x86_64 和 aarch64 架构，自动检测系统环境。
项目地址: https://github.com/ffffffff0x/f8x
安装 f8x
wget -O f8x https://f8x.io/f8x && sudo bash f8x
curl -sSL https://raw.githubusercontent.com/ffffffff0x/f8x/main/f8x -o /tmp/f8x && sudo bash /tmp/f8x
CLI 参考
单工具管理 (AI Agent 友好接口)
这组命令是 AI Agent 与 f8x 交互的主要方式，其中 --list-tools、--search、--list-installed 无需 root 权限。
f8x -install <tool_name>
f8x --list-tools
f8x --list-tools table
f8x --search <keyword>
f8x --list-installed
-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) 消费。结构:
{
"version": "1.9.1",
"catalog_version": 4,
"modules": [...],
"tools": [...],
"categories": [...],
"presets": [...]
}
--list-tools 的 JSON 输出即来源于此数据。
与 redc 配合使用
典型流程
- 通过 redc 模板开启 VPS 场景 (userdata 自动安装核心依赖)
- SSH 连接到 VPS
- 按需通过软件商店 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 注意磁盘余量
