reconYa

概览

GitHubGitHub

reconYa 是一款使用 Go 编写的网络侦察与资产发现工具，面向网络管理员、安全专业人员以及家庭用户。它通过扫描和监控本地网络中的设备，提供实时更新的网络状态信息。 ### 核心能力 - **IPv4 网络扫描**：原生 Go 实现，支持 ICMP 扫描、TCP 探测和 ARP 查询来发现设备。 - **IPv6 被动监控**：通过邻居发现和接口监控检测 IPv6 设备，不产生额外流量。 - **设备识别**：获取 MAC 地址、厂商信息、主机名、操作系统指纹及设备类型分类。 - **端口扫描**：由后台工作进程并发执行常见端口扫描，包含服务检测和 Banner 抓取。 - **告警机制**：针对新设备、新增或高风险开放端口、不可达主机、重复 MAC 及未识别主机生成可确认的告警。 - **Web 控制台**：服务端渲染的仪表盘，包含拓扑图、主机列表和实时事件日志，默认运行在 3008 端口。 - **多网络支持**：管理多个网络，每个网络可跨越一个或多个 CIDR 范围，独立扫描且切换时不丢失历史记录。 ### 架构与隐私 reconYa 后端使用 SQLite 存储设备数据、事件日志和告警。前端采用 Go 模板与原生 JavaScript，所有静态资源嵌入二进制文件中。默认情况下，reconYa 不会发起任何外部网络连接，扫描、设备跟踪和控制台完全依赖本地网络收集的数据。公网 IP 查询、地理位置解析、在线厂商查询等四项功能均为可选开启。 ### 安装方式 支持通过预编译二进制文件快速安装（适用于 Linux x86_64/ARM64 和 macOS Intel/Apple Silicon），也支持从源码构建（需要 Go 1.25+ 和 make）。Docker 部署目前处于实验阶段，由于容器网络架构限制，无法可靠获取跨网段的二层 MAC 地址信息，因此官方不推荐 Docker 部署。

Q&A

reconYa 支持哪些操作系统？由 AI 生成

预编译二进制文件支持 Linux（x86_64、ARM64）和 macOS（Intel、Apple Silicon）。从源码构建也可在 Windows 上运行，但 Windows 下 SQLite 驱动需要启用 CGO 并安装 C 编译器（如 TDM-GCC 或 Visual Studio Build Tools）。

reconYa 会向外部发送网络请求吗？由 AI 生成

默认情况下不会。扫描、设备跟踪和控制台完全依赖本地网络数据。公网 IP 查询、地理位置解析、在线厂商查询和 OUI 表下载这四项功能均默认关闭，需要在 .env 文件中手动设置为 true 才会发起外部请求。唯一的例外是 Web UI 会从 Google Fonts 加载字体。

可以使用 Docker 部署 reconYa 吗？由 AI 生成

Docker 相关文件位于 experimental 目录中，但官方不推荐使用容器化部署。因为 Docker 的网络架构使得容器即使在特权模式下也无法可靠地跨网段访问二层（MAC 地址）信息。建议使用本地安装以获得完整功能。

如何启动和访问 reconYa？由 AI 生成

使用预编译二进制安装后，进入 reconya 目录执行 sudo ./reconya-* 启动。或者从源码构建时使用 make start 以后台守护进程方式启动。启动后在浏览器打开 http://localhost:3008，默认账号密码为 admin / password，建议在 .env 文件中修改。

为什么扫描不到设备的 MAC 地址？由 AI 生成

MAC 地址仅在同一网络分段内可见。此外，部分设备可能不会响应 ARP 请求，也会导致无法获取 MAC 地址。