KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #codex #ai-agents #claude-code #dsh #dsh-plugin #cli #macos #ai-agent #deepseek-harness #open-source

XPoser_MiBackup

★ 89 Open GitHub ↗

云备份助手（虚拟一个小米智能存储设备实现云备份功能）

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# XPoser_MiBackup - 小米云备份助手

[![Android](https://img.shields.io/badge/Android-11+-blue)](https://www.android.com)
[![GitHub](https://img.shields.io/badge/GitHub-repo-blue)](https://github.com/zgcwkjOpenProject/XPoser_MiBackup)
[![LSPosed](https://img.shields.io/badge/LSPosed-supported-green)](https://modules.lsposed.org)
[![XposedModule](https://img.shields.io/badge/XposedModule-repo-green)](https://github.com/Xposed-Modules-Repo/com.zgcwkj.xpmibackup)

通过 Xposed 模块虚拟小米智能存储设备，将小米备份 App 的 DFS 存储流程重定向到自建 SMB、WebDAV 或自定义 HTTP 服务，实现备份与恢复数据的云端存储

## 原理

小米备份 App 会通过 DFS 服务连接小米智能存储设备，并通过 AIDL 接口执行目录查询、文件上传、文件下载和进度回调；本模块注入 `com.android.settings` 与 `com.miui.backup` 进程，在设置页展示配置入口，并在备份 App 的 DFS/AIDL 边界将文件操作改由 SMB/WebDAV/自定义 HTTP 完成

```text
小米备份 App
  -> 查询智能存储设备：返回虚拟设备
  -> 连接 DFS 服务：模拟在线和已连接
  -> DFS AIDL 上传：写入 SMB/WebDAV/自定义 HTTP
  -> DFS AIDL 下载：从 SMB/WebDAV/自定义 HTTP 读取
  -> 进度与完成回调：回传给小米备份原流程
```

主要 Hook 边界在 DFS AIDL、设置页入口和明确的备份 UI/服务事件，尽量避免直接依赖混淆业务函数

## 功能

- 在系统设置中注入「云备份助手」配置入口
- 拦截 DFS 连接，模拟小米智能存储设备在线状态
- 支持 SMB/CIFS、WebDAV 和自定义 HTTP 脚本三种传输协议
- 备份和恢复时将文件重定向到 SMB/WebDAV/自定义 HTTP 服务器
- 顶部“备份”按钮点击进入小米备份的智能存储备份页，长按进入小米应用商店的备份升级页
- 大文件在 Cloud 层统一切片上传，SMB、WebDAV 和自定义 HTTP 共用同一套切片逻辑
- 自动清理超出数量限制的旧备份

## 图片预览

![001](https://raw.githubusercontent.com/zgcwkjOpenProject/XPoser_MiBackup/main/imgs/001.jpg)

![002](https://raw.githubusercontent.com/zgcwkjOpenProject/XPoser_MiBackup/main/imgs/002.jpg)

更多图片：[imgs](imgs/README.md)

## 环境要求

- Android 11+（minSdk 30）
- 已安装 Xposed 框架（LSPosed / EdXposed 等）
- 支持的 Xposed 作用域：`com.android.settings`、`com.miui.backup`

## 项目结构

```text
app/src/main/java/com/zgcwkj/
  comm/
    ConfigHelp.java       配置文件读写
    CloudFileHelp.java    SMB/WebDAV/自定义 HTTP 统一入口
    SmbFileHelp.java      SMB 实现
    WebdavFileHelp.java   WebDAV 实现
    CustomHttpFileHelp.java 自定义 HTTP 脚本实现
    LocalBackupFileHelp.java 小米备份本地临时文件工具
    LogHelp.java          日志输出（logcat + 文件）
    ProgressCallbackHelp.java 进度回调参数清洗
  xpmibackup/
    XposedEntry.java      Xposed 入口
    MainActivity.java     配置界面 Activity
    hook/
      SettingsHook.java   设置页入口和虚拟设备展示
      AIDLHook.java       DFS AIDL 重定向
      BackupHook.java     备份 App 页面、通知、焦点和取消处理
      AutoBackupHook.java 自动备份设置和调度处理
    ui/
      DeviceConfigFragment.java   虚拟设备配置
      ServiceConfigFragment.java  SMB/WebDAV/自定义 HTTP 服务配置
```

## 实现说明

| 模块 | 作用 |
| --- | --- |
| `SettingsHook` | 在设置 App 中注入配置入口，并展示虚拟智能存储设备 |
| `AIDLHook` | 模拟 DFS 服务连接，拦截备份 App 的上传、下载和目录查询 |
| `CloudFileHelp` | 统一分发 SMB、WebDAV、自定义 HTTP，并处理跨协议切片 |
| `BackupHook` | 修正备份 App 页面、通知、进度焦点和取消清理 |
| `AutoBackupHook` | 接入备份 App 原生自动备份设置和调度链路 |

## 编译

需要 JDK 17 和 Android SDK（compileSdk 36）。

```bash
cd src
gradlew assembleDebug
```

调试 APK 输出位置：

```text
app/build/outputs/apk/debug/app-debug.apk
```

安装后在 Xposed/LSPosed 中启用模块，并重启目标 App 或设备

## 依赖

| 库 | 版本 | 用途 |
|---|---|---|
| [Xposed API](https://api.xposed.info/) | 82 | 框架 Hook 能力 |
| [smbj](https://github.com/hierynomus/smbj) | 0.13.0 | SMB/CIFS 协议 |
| [OkHttp](https://square.github.io/okhttp/) | 4.12.0 | HTTP 客户端（WebDAV） |
| [Rhino](https://github.com/mozilla/rhino) | 1.9.1 | 自定义 HTTP 脚本运行时 |

## 许可证

[Apache License 2.0](LICENSE)

XPoser_MiBackup

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README