Rayhunter项目在macOS系统上的安装指南

前言

Rayhunter是一款开源的网络探测工具，专为Orbic RC400L等设备设计。本文将详细介绍在macOS系统上安装Rayhunter的完整流程，特别针对M1/M2芯片的Mac用户，同时也会涵盖Intel芯片Mac的注意事项。

设备要求

• Mac设备：建议使用M1/M2芯片的MacBook Pro
• 操作系统：macOS Sequoia 15.3.2或更高版本
• 目标设备：Orbic RC400L（固件版本1.2.0）

安装前准备

1. 安装Homebrew

Homebrew是macOS上最受欢迎的包管理器，我们将使用它来安装必要的工具。在终端中执行以下命令安装：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 安装Android调试工具(ADB)

ADB是Android Debug Bridge的缩写，是与Orbic设备通信的关键工具：

brew install android-platform-tools

安装Rayhunter

1. 下载最新版本

从Rayhunter的发布页面获取最新的release.tar压缩包。

2. 解压并进入目录

cd ~/Downloads/rayhunter-[VERSION]  # 替换为实际下载的版本号

3. 准备Orbic设备

• 插入Orbic设备
• 长按电源键3秒开机
• 注意：此时运行adb devices可能不会立即显示设备，但不会影响后续安装

4. 执行安装脚本

./install-mac.sh

访问Web界面

安装完成后，可以通过两种方式访问Rayhunter的Web界面：

WiFi连接方式

1. 连接到Orbic的2.4GHz网络
2. 访问http://192.168.1.1:8080/
3. WiFi密码可在Orbic菜单中找到：2.4 GHz WIFI Info > Enter > 查看锁图标旁的8位密码

USB连接方式

1. 执行端口转发命令：

adb forward tcp:8080 tcp:8080

2. 访问http://localhost:8080/

针对不同Mac芯片的注意事项

M1/M2芯片Mac

上述步骤完全适用于Apple Silicon芯片的Mac，无需额外配置。

Intel芯片Mac

Intel芯片的Mac用户可能会遇到"Bad CPU type in executable"错误，解决方法如下：

1. 确保使用最新版本的ADB工具
2. 可能需要重新编译Rayhunter以兼容Intel架构

常见问题解决

1. ADB无法识别设备：

   • 尝试升级Orbic设备固件
   • 确保USB调试模式已启用

2. 安装脚本无法运行：

   • 检查脚本执行权限：chmod +x install-mac.sh
   • 确保终端位于正确的目录

3. Web界面无法访问：

   • 验证网络连接状态
   • 检查端口转发是否正确设置

结语

通过以上步骤，大多数macOS用户应该能够顺利完成Rayhunter的安装。如果在过程中遇到任何问题，建议查阅项目文档或向开发者社区寻求帮助。Rayhunter作为一款开源工具，其功能会不断更新完善，建议定期检查项目更新以获取最新功能和改进。