企业官网建设流程全解析

RaspyJack 是一款跑在 Raspberry Pi Zero 2 W 上的便携式网络攻击工具箱（Offensive Network Toolkit），通过一块 Waveshare 1.44″ LCD HAT 提供掌机式操作界面，内置 231 个 Payload、WebUI 远程控制和 Payload IDE。本教程将带你从零开始，完成硬件组装、系统写入、软件安装到 WebUI 验证的完整流程，并重点讲解WiFi 攻击网卡选型，帮助新手轻松构建一台可上手的渗透测试设备。

⚠️法律提醒：RaspyJack 仅用于授权的安全测试、研究与教育。请勿将其用于你未拥有或未获得明确许可的网络与系统，使用后果由使用者自行承担。

🧩 认识 RaspyJack：口袋里的渗透工具箱

RaspyJack 把一台迷你树莓派变成了"单兵渗透终端"，核心能力包括：

• 🖥️LCD 掌机界面：Waveshare 1.44″（128x128）或 1.3″（240x240）双屏支持
• 📦231 个 Payload / 13 大类：WiFi 攻击、ARP MITM、Responder、DNS 欺骗、凭据抓取、数据外传、蓝牙攻击等
• 🌐WebUI + Payload IDE：浏览器远程操控与在线脚本编辑
• 🎮25 款游戏 + 媒体播放：Pac-Man、Tetris、YouTube 播放器等

项目入口逻辑集中在 raspyjack.py，显示驱动由 LCD_1in44.py 与 LCD_Config.py 实现。想深入理解结构，可阅读 README.md 中的 "Project layout" 章节。

🛒 硬件清单：需要采购哪些零件

核心必选硬件

💡备选方案：如果只有 Pi Zero 1/2（无板载 WiFi），可通过 Waveshare Ethernet/USB HUB HAT 增加网口实现无头运行；更强大的 Pi 3B / Pi 4B 也可作为主控。

📡 WiFi 攻击网卡选型（重点）

这是新手最容易踩的坑：树莓派板载 WiFi（Broadcom 43430）无法用于 WiFi 攻击（不支持完整的 monitor / 注入模式）。要运行 deauth、evil twin、beacon flood 等 Payload，必须外挂一块兼容的 USB WiFi 适配器。

选型建议：

• 🔎认准芯片，而不是品牌：购买时一定确认芯片是RTL8812AU或AR9271，市面上同名不同版本的假货很多。
• 📶双频需求选 RTL8812AU：需要 5GHz 攻击时，只有 RTL8812AU 系列能胜任。
• 🔌Pi Zero 的 USB 口：Zero 2 W 只有一个 USB 口，若还需接其他设备，建议搭配 Ethernet/USB HUB HAT。

安装脚本 install_raspyjack.sh 会自动检测 USB 网卡，并将其接口固定为wlan1，与板载wlan0区分开。

💾 系统镜像写入：用 Raspberry Pi Imager 快速刷系统

第一步是在电脑上用官方Raspberry Pi Imager把系统写入 SD 卡。下图是 Imager 的主界面，选择设备、系统与存储即可：

Step 1 — 选择设备：在设备列表中选择Raspberry Pi Zero 2 W：

Step 2 — 选择系统：进入Raspberry Pi OS (other)→ 选择Raspberry Pi OS Lite (64-bit)（无桌面环境，体积更小、更适合掌机运行）：

Step 3 — 选择存储卡：选中你的 SD 卡（勾选"排除系统盘"更安全）：

Step 4 — 开启系统自定义：点击"下一步"后会询问是否应用自定义设置，选择是：

Step 5 — 填写自定义参数（关键！）：

• 主机名（hostname）：raspyjack
• 用户名 / 密码：设置你自己的登录凭据
• 勾选Configured the Wi-Fi：填入你家里的 SSID 和密码，方便首次连接
• 勾选Enable SSH：这是远程安装 RaspyJack 的前提

📌 完成配置后点击"写入（Write）"，等待进度条走完。写完后把 SD 卡插入 Pi Zero 2 W。

🔧 组装硬件：LCD HAT 上板

LCD HAT 采用排针直插方式，无需焊接跳线（部分批次需剪脚）：

1. 断电状态下操作，避免静电与短路。
2. 将 Pi Zero 2 W 的GPIO 40pin 排针朝下，对准 LCD HAT 上的排母。
3. 垂直、平稳地向下按压，使两者完全贴合，确保 SPI / I²C 引脚接触良好。
4. 检查摇杆 + 3 个按键是否朝向方便操作的一侧。
5. 插入 SD 卡，连接 microUSB 电源。

LCD 通过SPI通信，驱动引脚在 LCD_Config.py 中定义（复位 27、DC 25、CS 8、背光 24）。首次启动前无需手动接线，安装脚本会自动开启 SPI / I²C。

🚀 一键安装 RaspyJack

通过 SSH 登录设备（ssh 用户名@raspyjack.local或设备 IP），执行以下步骤：

sudo apt update sudo apt install -y git sudo -i git clone https://gitcode.com/gh_mirrors/ra/Raspyjack.git Raspyjack cd Raspyjack chmod +x install_raspyjack.sh ./install_raspyjack.sh reboot

install_raspyjack.sh 是幂等脚本，一次完成以下工作：

• 写入config.txt开启I²C / SPI与dtoverlay=spi0-2cs
• 安装全部依赖：python3-pil、scapy、aircrack-ng、nmap、tshark、hostapd、bluez等
• 固定 WiFi 接口命名（板载wlan0/ 外挂网卡wlan1）
• 创建raspyjack.service、raspyjack-device.service、raspyjack-webui.service三个 systemd 服务
• 配置 Caddy 反向代理实现HTTPS WebUI
• 末尾运行健康检查（SPI 设备节点 + Python 依赖导入）

安装过程中脚本会询问你使用的是哪种屏幕（1ST7735_128 /2ST7789_240 /3Cardputer_320），按实际硬件选择即可。

🖥️ 首次启动与 WebUI 验证

重启后，RaspyJack 会自动运行。你有两种使用方式：

方式一：本地 LCD 操作直接用 HAT 上的摇杆与按键操作：上下导航、左返回、右/确认进入、KEY1/KEY2 上下文操作、KEY3 退出。

方式二：浏览器 WebUI（推荐）在局域网内任意设备浏览器打开：

https://<设备IP>/ # Caddy HTTPS 入口 http://<设备IP>:8080 # 备用直连端口

WebUI 会实时把 LCD 画面串流到浏览器，并把你的点击回传给设备，等于"远程掌机"。相关细节见 web/README.md。

验证成功的标志：

• ✅ LCD 显示 RaspyJack 菜单
• ✅ WebUI 能打开并登录（首次会要求设置管理员账号）
• ✅lsusb能看到你的 USB WiFi 网卡（若已插入）

🧭 装好之后可以做什么

RaspyJack 的 Payload 按类别组织在 payloads/ 目录下，上手就能体验：

抓取到的数据统一落在 loot/ 目录，可通过 WebUI 或 IDE 在线查看与下载。

❓ 常见问题排查

• 🖥️LCD 黑屏 / 花屏：确认选对了屏幕类型（ST7735 vs ST7789），修改 gui_conf.json 中DISPLAY.type后重启；检查排针接触。
• 📡网卡无法 monitor 模式：确认芯片是 RTL8812AU / AR9271，用airmon-ng切换；Pi Zero 只有一个 USB 口，避免供电不足。
• 🌐WebUI 打不开：确认设备与客户端在同一网段，检查raspyjack-webui.service是否active；HTTPS 自签证书首次访问需手动信任。
• 🔋运行不稳 / 频繁掉线：换用 5V 2.5A 优质电源，Pi Zero 对供电敏感。

🎉 小结

至此，你的RaspyJack已从零搭建完成：Pi Zero 2 W + Waveshare LCD HAT 组成掌机硬件，外挂 RTL8812AU 网卡解锁 WiFi 攻击能力，配合 231 个 Payload 与 WebUI，成为一台真正"能上手"的便携式渗透测试终端。

记住两条底线：

1. ✅只在授权环境中测试，坚守法律与安全红线。
2. 🔄定期备份loot/与config/，升级前保留重要数据。

Build responsibly. Test ethically. 🧌