Signal-CLI-REST-API 移动设备注册问题解决方案

在使用 Signal-CLI-REST-API 项目时，用户可能会遇到通过二维码扫描方式注册现有手机号码时出现的问题。具体表现为：虽然手机端显示注册成功，但实际上新设备并未出现在手机应用的设备列表中。

问题现象分析

当用户尝试通过 Home Assistant 的 Signal Messenger 插件进行设备注册时，系统会生成一个二维码供扫描。用户按照流程操作后，手机端会显示"已注册"的提示，但注册过程并未真正完成，新设备不会出现在 Signal 手机应用的关联设备列表中。

技术背景

Signal-CLI-REST-API 是一个基于 Signal 协议的 REST API 服务，允许开发者通过 HTTP 接口与 Signal 消息系统交互。设备注册是 Signal 协议中多设备支持的关键功能，允许一个账号在多个设备上使用。

解决方案

针对此问题，项目维护者提供了以下解决方案：

1. 升级到开发版本：使用特定开发版本 bbernhard/signal-cli-rest-api:0.145-dev 可以解决此问题。

2. 清理配置：在尝试重新注册前，必须删除原有的 signal-cli 配置文件。这是因为旧的配置可能会干扰新的注册过程。

实施步骤

1. 停止当前运行的 Signal-CLI-REST-API 服务
2. 删除或重命名现有的 signal-cli 配置目录
3. 使用指定的开发版本重新部署服务
4. 再次尝试设备注册流程

注意事项

• 此问题主要出现在 ARMv7 架构的设备上，如 Raspberry Pi
• 确保使用最新版本的 Home Assistant Signal 插件
• 注册过程中需要保持网络连接稳定
• 如果问题仍然存在，可以尝试重启手机端的 Signal 应用

总结

Signal-CLI-REST-API 的设备注册功能在特定环境下可能会出现异常，通过升级到开发版本并清理旧配置可以有效解决这一问题。对于使用 Home Assistant 集成的用户，建议关注项目更新以获取更稳定的版本。