【免费下载链接】bluehoodMonitor your local neighbourhoods bluetooth activity项目地址https://gitcode.com/gh_mirrors/bl/bluehood点击查看免费下载Bluehood 是一款运行在 Linux 服务器上的蓝牙邻居监控工具通过被动扫描周围的 BLE 设备来分析周边蓝牙活动模式。本文是一份保姆级教程带你从零完成 Bluehood 的完整部署搭建 Python 运行环境、安装依赖、授予蓝牙权限最后用 systemd 把它变成开机自启的常驻服务。一、Bluehood 是什么简单来说Bluehood 就是一个蓝牙监听器。它会持续扫描你身边的蓝牙设备手机、汽车、耳机、IoT 设备等通过 MAC 地址厂商库和 BLE 服务指纹把它们分类并记录它们随时间出现/消失的规律最终在网页仪表盘里直观呈现。⚠️ 提示本项目仍处于 Alpha 阶段属于教育/隐私科普用途。扫描蓝牙设备时请遵守当地法律法规仅对授权环境使用。二、安装前准备三个硬性条件在动手前先确认你的 Linux 服务器满足以下条件条件说明检查方式BLE 蓝牙适配器需蓝牙 4.0 且支持Central角色老式 2.x/3.x 适配器不支持bluetoothctl show查看是否含centralBlueZLinux 蓝牙协议栈扫描的底层依赖bluetoothctl list能列出适配器Python 3.11项目运行与依赖安装环境python3 --version先安装并启用 BlueZDebian/Ubuntu 示例sudo apt update sudo apt install bluez python3-pip sudo systemctl enable --now bluetooth bluetoothctl power on三、克隆仓库并搭建 Python 环境下面这一步涉及仓库克隆仓库地址如下git clone https://gitcode.com/gh_mirrors/bl/bluehood cd bluehood强烈建议使用虚拟环境隔离依赖避免污染系统 Pythonpython3 -m venv .venv source .venv/bin/activate项目的依赖定义在 pyproject.toml 中核心依赖为bleak、aiosqlite、aiohttp、mac-vendor-lookup并明确要求requires-python 3.11。四、一键安装依赖激活虚拟环境后执行可编辑安装即可自动安装全部依赖并注册命令行入口pip install -e .如果之后想用 Prometheus 指标导出配合 Grafana再追加安装可选依赖pip install -e .[metrics]安装成功后bluehood命令就可用了。入口定义在 pyproject.toml 的bluehood bluehood.daemon:main实际逻辑位于 bluehood/daemon.py。五、授予蓝牙扫描权限蓝牙扫描需要较高权限三选一即可以 root 运行最简单sudo bluehood给 Python 授予能力位免 sudosudo setcap cap_net_admin,cap_net_raweip $(readlink -f $(which python))使用 systemd 服务推荐用于常驻见下一节。六、先验证列出并测试适配器正式跑服务前先确认能识别到蓝牙适配器bluehood --list-adapters底层扫描与适配器枚举逻辑在 bluehood/scanner.py 的list_adapters()中实现。若这里能列出hci0等适配器说明 BlueZ 与驱动正常否则请回到第二步排查 BlueZ。七、配置 systemd 常驻服务这是本教程的重点——把 Bluehood 做成开机自启、崩溃自动重启的后台服务。仓库已内置服务单元文件 bluehood.service其核心配置为ExecStart/usr/bin/python3 -m bluehood.daemonRestarton-failureRestartSec10故障 10 秒后自动拉起EnvironmentBLUEHOOD_DATA_DIR/var/lib/bluehood数据落盘目录 注意单元文件默认以 root 身份运行因此天然绕过了蓝牙权限问题无需额外setcap。安装并启动服务sudo cp bluehood.service /etc/systemd/system/ sudo systemctl daemon-reload sudo systemctl enable --now bluehood查看运行状态与日志systemctl status bluehood journalctl -u bluehood -f八、打开 Web 仪表盘服务启动后浏览器访问http://服务器IP:8080即可进入监控面板。默认端口可在 bluehood/config.py 与命令行参数中调整例如bluehood --port 9000。主面板会列出已识别设备的类型、MAC、厂商、 sighting 次数与最近接触时间并提供按类别筛选、关键词搜索和 CSV 导出九、配置告警与推送通知进入设置页可以为 Bluehood 配置 ntfy.sh 推送通道与告警规则比如新设备出现被监视设备返回/离开时推送到手机。相关配置逻辑位于 bluehood/notifications.py十、常用命令与环境变量速查命令 / 变量作用bluehood启动含 Web 面板端口 8080bluehood --list-adapters列出可用蓝牙适配器bluehood --adapter hci0指定 BLE 扫描适配器bluehood --no-web仅扫描关闭 Web 面板BLUEHOOD_DATA_DIR数据目录默认~/.local/share/bluehoodBLUEHOOD_METRICS_PORT开启 Prometheus 指标端口数据以 SQLite 存储默认路径为~/.local/share/bluehood/bluehood.db可在 bluehood/config.py 中查看默认值与环境变量覆盖逻辑。十一、常见问题排查提示No Bluetooth adapters with BLE central role found适配器不支持 BLE Central 角色请更换蓝牙 4.0 的 USB 蓝牙棒。org.freedesktop.DBus.Error.ServiceUnknown/org.bluez was not providedBlueZ 未安装或未运行执行sudo apt install bluez sudo systemctl enable --now bluetooth后重启服务。权限被拒绝改用sudo bluehood或按第五节授予能力位或直接使用 systemd 服务。扫描不到设备确认bluetoothctl power on已执行且bluehood --list-adapters能列出适配器。十二、总结至此你已经在 Linux 服务器上完成了 Bluehood 从Python 环境 → 依赖安装 → 权限授予 → systemd 常驻服务的全流程部署。配合内置的 Web 仪表盘、Prometheus 指标bluehood/prometheus.py以及现成的 Grafana 面板 grafana/bluehood-dashboard.json你就能持续、直观地掌握周边蓝牙设备的活动规律。再次提醒Bluehood 用于教育与隐私安全研究请务必在授权范围内使用并尊重周围人的隐私与相关法规。更多细节可参阅 README.md如需容器化部署可参考 docker-compose.yml 与 Dockerfile。赞分享【免费下载链接】bluehoodMonitor your local neighbourhoods bluetooth activity项目地址https://gitcode.com/gh_mirrors/bl/bluehood点击查看免费下载相关推荐如何在 NAS 和家用服务器上安装 NetronomeLinux/macOS/Windows 跨平台保姆级教程如何在 NAS 和家用服务器上安装 NetronomeLinux/macOS/Windows 跨平台保姆级教程 Netronome 是一款用 Go 和 ReaRTCMultiConnection 安装指南从信令服务器部署到生产环境后台常驻RTCMultiConnection 安装指南从信令服务器部署到生产环境后台常驻 本文以官方 installation guide.md https://li示例工程Hermes Workspace 后台常驻服务部署指南macOS launchd 与 Linux systemd 用户级服务实战Hermes Workspace 后台常驻服务部署指南macOS launchd 与 Linux systemd 用户级服务实战 本篇指南讲解如何将 Herm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考