Pwnagotchi插件消失问题的排查与解决

问题现象

在使用Pwnagotchi项目时，用户遇到了一个奇怪的现象：所有自定义插件突然从主屏幕和插件页面消失，但在网页配置界面中这些插件仍然显示为已启用状态。系统自带的默认插件则工作正常。

问题分析

通过分析用户提供的配置信息和截图，可以确定问题根源在于配置文件中的路径设置错误。用户错误地将Git仓库链接填写在了custom-plugin文件夹路径的位置，而非实际的插件存放路径。

技术原理

Pwnagotchi的插件系统通过配置文件(config.toml)中的main.custom_plugins参数来指定自定义插件的存放位置。这个参数必须指向设备文件系统中实际存在的目录路径。当系统启动时，Pwnagotchi会扫描该目录下的Python文件(.py)并加载其中的插件。

解决方案

1. 检查配置文件：打开/etc/pwnagotchi/config.toml文件
2. 修正路径：确保main.custom_plugins参数指向正确的本地目录路径，例如：

   main.custom_plugins = "/usr/local/share/pwnagotchi/plugins/"
   

3. 验证路径：确认该路径下确实存在插件文件(.py)
4. 重启服务：修改后重启Pwnagotchi服务使更改生效

预防措施

1. 在修改配置文件前备份原文件
2. 使用绝对路径而非相对路径
3. 路径末尾不要包含斜杠(/)
4. 确保插件文件具有可执行权限

总结

这个案例展示了配置文件参数设置不当导致的插件加载问题。在Pwnagotchi项目中，路径配置必须准确指向设备上的实际位置，任何格式错误都会导致插件无法正常加载。通过仔细检查配置文件和实际路径的对应关系，可以有效解决这类问题。