Skip to content

magisk317/xinyi-relay

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,240 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

信驿 Relay

Commits Last Commit Contributors CI Latest Release Release Date Downloads License

Kotlin Jetpack Compose Gradle AGP Min SDK Target SDK Xposed API Telegram

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

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

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

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

English Version

应用截图

交流与反馈

手机端

手机端是面向 Xposed/LSPosed 的 Android 模块,负责本地事件采集、验证码解析与自动填写。

安装与使用

  1. Root 设备并安装 LSPosed/Xposed 框架;
  2. 安装信驿 Relay:
    • GitHub Release:提供 APK 下载
    • Google Play:提供商店分发
  3. 激活模块并重启;
  4. 在应用内配置转发通道、路由规则、拦截策略与验证码自动填写。

兼容性

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

主要能力

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

Backend

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

组成

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

默认部署方式

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

入口文档

日志位置

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

  • Backend Dockerbackend/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 的前提下导入。

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

文档

感谢

协议

所有源码遵循 GPLv3 协议。

赞助与捐赠

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

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

支付宝收款码 微信赞赏码 微信收款码
Alipay WeChat Appreciation WeChat Collect

Star History

Star History Chart