Pwnagotchi蓝牙连接故障排查与解决方案

问题现象分析

在使用Pwnagotchi与Google Pixel 7 Pro手机进行蓝牙连接时，设备显示"已连接"状态，但实际上手机并未真正建立连接。这种状态异常表现为：

1. 设备界面显示"connected"但手机无实际连接
2. 状态偶尔会短暂显示为"be"后恢复为"connected"
3. 常规的取消配对/重新配对操作无效

技术背景

Pwnagotchi通过蓝牙与手机连接时，需要满足以下技术条件：

1. 蓝牙配对成功
2. 手机端蓝牙网络共享功能启用
3. Pwnagotchi配置文件中相关参数正确设置
4. 系统服务正常运行

详细排查步骤

1. 基础检查

• 确认手机蓝牙功能已开启
• 检查蓝牙设备列表中Pwnagotchi是否显示为已配对
• 验证手机热点和网络共享设置

2. 配置文件验证

关键配置项检查：

main.plugins.bt-tether.enabled = true
main.plugins.bt-tether.devices.android-phone.enabled = true
main.plugins.bt-tether.devices.android-phone.search_order = 1
main.plugins.bt-tether.devices.android-phone.mac = "设备MAC地址"
main.plugins.bt-tether.devices.android-phone.ip = "192.168.44.44"
main.plugins.bt-tether.devices.android-phone.netmask = 24
main.plugins.bt-tether.devices.android-phone.interval = 1
main.plugins.bt-tether.devices.android-phone.scan_timeout = 10
main.plugins.bt-tether.devices.android-phone.max_tries = 0

3. 服务状态检查

通过SSH连接到Pwnagotchi后，检查以下服务状态：

systemctl status bluetooth
systemctl status bt-tether

4. 日志分析

查看相关日志获取详细错误信息：

journalctl -u bluetooth -f
journalctl -u bt-tether -f

解决方案

1. 配置文件修正

修改/etc/pwnagotchi/config.toml文件，确保以下参数正确：

[main.plugins.bt-tether.devices.android-phone]
enabled = true

2. 服务重启

执行以下命令重启相关服务：

sudo systemctl restart bluetooth
sudo systemctl restart bt-tether

3. 完整重置流程

1. 手机端：取消配对并删除Pwnagotchi设备
2. Pwnagotchi端：删除/root/.config/bluetooth目录
3. 重启设备
4. 重新进行配对操作

预防措施

1. 定期备份配置文件
2. 更新系统时检查配置兼容性
3. 使用版本控制管理配置变更
4. 建立配置变更日志

技术原理深入

Pwnagotchi的蓝牙连接机制基于Linux的BlueZ蓝牙协议栈实现，通过PAN(个人区域网络)配置文件建立网络连接。当配置参数enabled = false时，虽然设备可能完成蓝牙配对，但不会建立实际的网络连接通道，导致出现"假连接"状态。

这种设计允许用户灵活控制连接方式，但也可能因配置错误导致连接异常。建议用户在修改配置后使用pwnagotchi --debug模式启动，观察详细的连接过程日志。

通过理解这些技术细节，用户可以更有效地排查和解决类似连接问题，确保Pwnagotchi设备正常工作。