信驿 Relay

信驿 Relay 是一个面向 Xposed/LSPosed 的消息转发与验证码自动填写工具，支持短信、应用通知、来电等来源的统一处理。

项目当前由三大部分组成：

• 手机端 (Android)：负责本地事件采集、验证码解析、自动输入与 Xposed Hook
• 服务端 (Backend)：负责多设备绑定、配置快照、记录上报与云端 Web 控制台
• 桌面端 (Desktop)：跨平台桌面管理工具，内建本地 SQLite 数据库，支持独立离线运行与云端同步

旧内嵌 WebUI 已退出 Android 主运行链，当前正式架构为 Android Agent + Backend / Desktop 协同工作。

English Version

应用截图

交流与反馈

• Telegram Group

手机端

手机端是一个运行时自适应的 Android Agent：检测到有效 Xposed/LSPosed runtime 时进入 Enhanced 模式；没有 Xposed 时使用系统 API 进入 Standard 模式。两种模式使用同一个 APK、 应用身份、数据库和配置。

安装与使用

1. 安装信驿 Relay：
   • GitLab Release：提供 APK 下载
   • Google Play：提供商店分发
2. Standard 模式按需授予当前发行包实际声明的短信、彩信、通话或通知监听权限；拒绝某一 权限只会停用对应能力。
3. 如需 Hook 拦截、系统级短信阻断和 Hook 保活等 Enhanced 能力，再选择 Root 设备并在 LSPosed/Xposed 中激活模块；不需要改装另一个 lite APK。
4. 在应用内配置转发通道、路由规则、拦截策略与验证码功能。

兼容性

• 最低 Android 8.0（API 26）。
• 适用于偏原生系统，第三方深度定制 Rom 可能存在兼容性差异。

主要能力

• 短信转发：按规则转发验证码短信与普通短信
• 应用通知转发：按应用维度绑定转发通道
• 来电信息转发：提取并转发来电相关信息
• 全局/应用级转发过滤：关键词、来源、优先级等策略控制
• 验证码自动解析、复制与自动填写
• 验证码规则：内置官方只读规则、远程刷新缓存与用户自定义规则分层合并
• 记录与备份：支持导出/导入配置与历史记录

工作模式边界

• Enhanced/Standard 是运行时状态，不是 Play/GitHub/E2EE 等发行 flavor。
• Xposed service bind/died 后会立即重新解析模式并协调 Standard 前台服务与通话监听。
• 安装/更新后的电话进程重启只在 Xposed service 成功绑定后请求；普通 Standard 启动不会 探测 Root 或重启电话/MMS 进程。
• Standard 常驻服务使用 remoteMessaging 前台服务类型，可从开机广播恢复且不受 Android 15 dataSync 的累计时限约束。
• Standard MMS 由 APK 内置的有界 Notification.ind metadata parser 解析，不依赖隐藏系统类； 通话结束补全只在号码缺失且有通话记录权限时做有限、可取消的延迟查询。
• Google Play 按 manifest 合规保留通知监听等 Standard 子集；GitHub 发行可按用户授权启用 更完整的短信、彩信和通话能力。

Backend

Backend 是信驿 Relay 的自建远程控制面，默认部署模式为“本地优先、保留公网能力”。

组成

• Go API
• PostgreSQL
• Caddy
• Web 控制台

默认部署方式

• Docker Compose 默认直接拉取 Docker Hub 镜像 docker.io/alpha317/xinyi-relay-backend:beta
• Android Agent、Web 与 Desktop 共享同一套 Backend API
• 本地 HTTPS 使用 Caddy tls internal，可通过用户证书接入 Android Agent

入口文档

• Backend 使用说明
• Backend API 概览
• 远程架构
• Desktop 使用说明

日志位置

Backend 和 Desktop 都支持日志文件输出，便于问题排查：

• Backend Docker：backend/logs/backend.log（需在 .env 中配置 RELAY_LOG_FILE）
• Desktop：
  • macOS：~/Library/Logs/io.github.magisk317.relay.desktop/
  • Windows：%APPDATA%\io.github.magisk317.relay.desktop\logs\
  • Linux：~/.local/share/io.github.magisk317.relay.desktop/logs/

详见各组件的 README 文档。

桌面端 (Desktop)

桌面端是基于 Tauri + Rust 构建的跨平台管理应用（支持 macOS / Windows / Linux）。它不再仅是 Backend 的外壳，而是升级为全功能客户端，支持以下三种运行模式：

• Local（本地模式）：完全离线运行，使用自带的内置 SQLite 数据库管理设备、配置与历史记录，最大程度保护隐私。
• Remote（远程模式）：作为传统的控制台端，直接连接并管理你的独立 Backend 云端实例。
• Hybrid（混合模式）：以本地极速响应为主，需要时通过 Sync 协议与 Backend 实例进行双向数据同步。

Desktop Release 说明

• Desktop Release 默认提供 Linux、macOS 与 Windows 包。
• macOS 当前为 unsigned 发布，首次运行时可能需要用户在系统设置里手动允许。
• Windows 当前使用仓库自管的自签名证书签名；若系统拦截，可先导入公开证书 frontend/desktop/certs/windows-codesign.cer 再运行安装包。
• 该 Windows 证书仅用于当前项目的小众分发，不是公有 CA 商业签名证书；请仅在你信任本项目 Release 的前提下导入。

欢迎反馈，欢迎提出意见或建议。

文档

• 更新日志 (Changelog)
• 自定义消息广播接口 (Custom Broadcast)
• 系统与代码库架构
• Backend 使用说明
• Backend API 概览
• 隐私政策 (Privacy Policy)
• 赞助与捐赠 (Donations)

CI 公共逻辑来自 magisk-ci-toolkit：GitLab include、作业变量与本地/GitHub resolver 固定到 同一不可变提交并使用 exact fetch；父仓默认不得回退到浮动 main。

感谢

• XposedSmsCode
• LSPosed API
• SmsForwarder
• NekoSMS
• Material Dialogs
• EventBus
• Room
• Kotlin Serialization
• Kotlin Coroutines
• Material Design 3
• Jetpack Compose

协议

所有源码遵循 GPLv3 协议。

赞助与捐赠

如果本项目对你有帮助，欢迎支持开发者。你的支持会直接用于项目维护与持续迭代。

赞助名单与说明请见：赞助与捐赠文档。

支付宝收款码	微信赞赏码	微信收款码

Star History