duchamp-root

中文 | English

⚡ Usuário orgulhoso do JetBrains Mono ⚡
Este README usa exclusivamente JetBrains Mono. Comic Sans é proibido.

[!IMPORTANT] 🚨 Aviso Legal

Este exploit é apenas para fins educacionais.

• Desbloquear o bootloader pode anular sua garantia.
• Rootear o dispositivo pode causar bootloop, perda de dados ou combustão espontânea (provavelmente não, mas nunca se sabe).
• Não me responsabilizo se seu K70e virar um tijolo K70.
• Se sua namorada te largar porque você passou muito tempo rootando, problema seu.
• 7̷̋̚1̸̽̈́0̵̛̅ ̸͛̿ù̶̈́n̸̓̋l̸̔̒o̸̔̒c̸̾̑k̵̇̚ ̷̊̒ḟ̷͝e̶̋̕s̵̋̚t̸̽̈́ ̵̔̋l̶̔̒e̸̓̋t̸̔̒s̵̋̚ ̸̾̑ġ̷̝o̷̊̒ ̵̛̅ḟ̷͝u̸̓̋c̷̋̚k̸̛̅i̶̽̈́n̵̔̋g̷̊̒ ̴͛̿g̶̾̑ơ̵̅

📖 中文版

🤔 这是什么

Xiaomi K70e (duchamp) 一键 Root 工具，基于 CVE-2026-43499 (IonStack) 内核漏洞提权，集成 KernelSU 守护进程。

通俗版：你点一下，手机就 root 了。就这么简单。

710 解锁节版：不是 711，不是 709，是 710。这一天我们不解锁手机，我们解放手机。

哲学版：当你在 /proc/ 里凝视深渊，深渊也在用 pipe_physrw 凝视你。

🎯 当前适配

其它机型见 src/targets/ 目录（原项目包含的参考配置，未实际验证）。

🧠 漏洞链

🎭 用户故事

710 解锁节

用户: "我的 K70e 能解锁吗？"
我:   "不用解锁，直接 root。"
用户: "？？？"
我:   "w 710"
用户: "什么？"
我:   "710解锁节最新力作，不是解锁BL，是解放手机。"

第一次开机

用户: "为什么我的手机重启了？"
preload.so: "别慌，我在提权。"
用户: "KernelSU 是什么？"
preload.so: "就是你手机上现在跑的 root 管理器。"

KernelSU 集成

用户: "root 之后怎么管理？"
ksud: "你好，我是 KernelSU 守护进程。"
用户: "你能干什么？"
ksud: "我可以给应用授权 root。"
用户: "你不是系统自带的吧？"
ksud: "我是嵌入在 preload.so 里的。"
用户: "牛逼。"

翻车现场

用户: "我刷了你这个，变砖了！！！"
我:   "你什么机型？"
用户: "iPhone 14。"
我:   "......你认真的？"
用户: "我看你说 710 解锁节就来试试。"
我:   "710 是 Xiaomi 14 的代号之一，不是 iPhone 14。你走吧。"

⚙️ 工作原理

1. 加载 preload.so — 注入任意应用（LD_PRELOAD），触发 __attribute__((constructor))
2. 泄漏 KASLR 基址 — 通过 pselect 侧信道 + nfulnl_log_packet 数据别名读取 _stext
3. 劫持 FOPS 表 — 利用 futex PI 竞争条件 + pipe 操作改写文件操作的 ops 指针
4. 获得 phys rw — 伪造 pipe_buf_ops，实现任意内核物理地址读写
5. 修补 cred — 找到 root child 进程的 cred，改 uid=0、cap 全满、sid=kernel
6. 关安全机制 — 关 seccomp、清 TIF_SECCOMP、写 selinux enforce=0
7. 启动 KernelSU — 提取嵌入的 ksud 到 /data/local/tmp/ksud，启动 KernelSU 守护进程

📦 使用方式

前置条件

• Xiaomi K70e (duchamp) 或其它支持的设备
• 已解锁 Bootloader（或不解锁的临时 root 也支持）
• ADB 调试已开启
• 一个不怕变砖的勇气

快速开始

# 从 Release 下载 preload.so
wget https://github.com/Colorful-glassblock/duchamp-root/releases/download/v1.0/preload.so

# 推送到设备
adb push preload.so /data/local/tmp/

# 通过 LD_PRELOAD 注入任意应用触发
adb shell
su -c "LD_PRELOAD=/data/local/tmp/preload.so your_app"

或者使用我们提供的注入脚本（TODO）。

自行编译

# 需要 NDK 或 Termux 的 aarch64-linux-android-clang
make PROJECT=duchamp

# 输出在 build/duchamp/bin/preload.so

📂 文件结构

├── Makefile                      # 构建系统
├── assets/
│   └── (待补充)
├── build/
│   └── embed/
│       └── ksud                  # 嵌入的 KernelSU 守护进程二进制
└── src/
    ├── main.c                    # 入口 + 线程管理
    ├── preload.c                 # LD_PRELOAD 加载器 + 嵌入式文件写入
    ├── root.c                    # 内核提权 + cred 修补 + su/ksud 安装
    ├── slide.c                   # KASLR 侧信道泄漏
    ├── fops.c                    # FOPS 劫持
    ├── pipe.c                    # pipe_buffer 物理读写原语
    ├── ksud_blob.S               # 嵌入 ksud 二进制
    ├── offset.h                  # 内核偏移通用头
    ├── common.h                  # 全局常量 + 函数声明
    ├── kernelsnitch/             # Kernelsnitch 绕过
    └── targets/
        ├── duchamp/
        │   └── target.h          # duchamp 专属偏移
        ├── blazer-CP2A.260605.012/
        ├── caiman-CP2A.260605.012.C1/
        ├── comet-CP2A.260605.012.C1/
        ├── komodo-CP2A.260605.012.C1/
        ├── tegu-CP2A.260605.012/
        ├── tokay-CP2A.260605.012/
        └── ...                   # 其它机型 target.h

🧩 依赖

• aarch64-linux-android-clang（NDK r29 或 Termux 版本）
• lld（LLVM 链接器）
• make + git
• 一颗强大的心脏（变砖预警）

🛡️ 免责声明

本工具仅供学习研究使用。
解锁 Bootloader 可能导致保修失效。
Root 设备可能导致变砖、数据丢失、银行 App 无法使用。
如果你因此被女朋友甩了，那是你自己的问题。
如果你刷了变砖来找我，我会笑你。
710解锁节快乐！🚀

💡 彩蛋 / FAQ

Q: 为什么叫 710 解锁节？
A: 7 月 10 日。不是 711（便利店），不是 709（不知道什么东西）。是 710。这一天我们不解锁 BL，我们解放手机。

Q: 710 和 Xiaomi 14 有什么关系？
A: Xiaomi 14 的代号之一是 frankel 开头的设备，不是 shennong。等等，710 是节日不是代号...

Q: QwQ?
A: 情绪稳定（假的）。

Q: 有 su 吗？
A: 没有，只有 KernelSU。需要 su 的话装个 KernelSU 管理器自己开。

Q: 支持其它机型吗？
A: 看 src/targets/ 目录。你的机型在里面就支持，不在就自己加。

Q: 我能在没有解锁 BL 的情况下用吗？
A: 可以，LD_PRELOAD 注入不需要解锁 BL。但是重启后需要重新注入。

Q: 会触发 Kernelsnitch 吗？
A: 已经内置了 Kernelsnitch 绕过，但如果你被检测到了，那是 skill issue。

Q: 114514?
A: はいはいわかりました草

📖 English

🤔 O que é isso

Ferramenta de root com um clique para Xiaomi K70e (duchamp) baseada no exploit de kernel CVE-2026-43499 (IonStack), integrada com o daemon KernelSU.

Versão casual: Clique, root, pronto.

Versão Festival 710: 10 de julho. Não 11 de julho (loja de conveniência), não 9 de julho (quem liga). 10 de julho. Neste dia não desbloqueamos bootloaders, libertamos telefones.

Versão filosófica: Quando você olha para /proc/, /proc/ olha de volta para você com pipe_physrw.

🎯 Dispositivos Suportados

Outros dispositivos em src/targets/ são configurações de referência do projeto original, não verificadas.

🧠 Cadeia de Exploração

🎭 Galeria de Memes

Festival 710

Usuário: "Posso desbloquear meu K70e?"
Dev:  "Não precisa desbloquear, é só rootear."
Usuário: "???"
Dev:  "w 710"
Usuário: "O quê?"
Dev:  "710 Festival do Desbloqueio. Não é desbloquear BL, é libertar telefones."

Primeira Inicialização

Usuário: "Por que meu telefone reiniciou?"
preload.so: "Não entre em pânico, estou escalando privilégios."
Usuário: "Por que o KernelSU está no meu telefone?"
preload.so: "Eu coloquei lá. De nada."

Integração KernelSU

Usuário: "Como gerencio o root depois disso?"
ksud: "Oi, sou o daemon do KernelSU."
Usuário: "O que você pode fazer?"
ksud: "Conceder root a aplicativos."
Usuário: "Você não é nativo?"
ksud: "Estou embutido no preload.so."
Usuário: "Legal."

Relatório de Tijolo

Usuário: "Usei sua coisa e agora está tijolada!!!"
Dev:  "Qual dispositivo?"
Usuário: "iPhone 14."
Dev:  "...Você está falando sério?"
Usuário: "Você disse Festival 710, então tentei."
Dev:  "710 é um codinome do Xiaomi 14, não iPhone 14. Cai fora."

⚙️ Como Funciona

1. Carregar preload.so — injetar via LD_PRELOAD em qualquer app, dispara __attribute__((constructor))
2. Vazar base KASLR — canal lateral pselect via alias de dados nfulnl_log_packet lê _stext
3. Sequestrar tabela FOPS — corrida futex PI + reescrita de ops de pipe
4. Obter rw física — forjar pipe_buf_ops para acesso arbitrário à memória física do kernel
5. Patchar cred — encontrar tarefa filha root, patchar uid=0, caps totais, sid do kernel
6. Desabilitar segurança — patchar seccomp, limpar TIF_SECCOMP, selinux enforce=0
7. Iniciar KernelSU — extrair ksud embutido para /data/local/tmp/ksud, iniciar daemon KernelSU

📦 Uso

Pré-requisitos

• Xiaomi K70e (duchamp) ou outro dispositivo suportado
• Bootloader desbloqueado (ou não — LD_PRELOAD funciona de qualquer forma)
• Depuração ADB ativada
• Uma alma corajosa

Início Rápido

# Baixar preload.so dos Releases
wget https://github.com/Colorful-glassblock/duchamp-root/releases/download/v1.0/preload.so

# Enviar para o dispositivo
adb push preload.so /data/local/tmp/

# Injetar em qualquer app via LD_PRELOAD
adb shell
LD_PRELOAD=/data/local/tmp/preload.so seu_app

Compilar a Partir do Código

# Requer NDK ou Termux aarch64-linux-android-clang
make PROJECT=duchamp

# Saída em build/duchamp/bin/preload.so

📂 Estrutura de Arquivos

├── Makefile
├── assets/
│   └── (TBD)
├── build/embed/ksud             # Daemon KernelSU embutido
└── src/
    ├── main.c, preload.c, root.c, slide.c, fops.c, pipe.c
    ├── ksud_blob.S               # Binário ksud embutido
    ├── su_daemon.c, offset.h, common.h
    ├── kernelsnitch/            # Bypass do Kernelsnitch
    └── targets/                 # Arquivos target.h específicos do dispositivo

🧩 Dependências

• aarch64-linux-android-clang (NDK r29 ou Termux)
• lld (linker LLVM)
• make + git
• Um coração forte (aviso de tijolo)

🛡️ Aviso Legal

Esta ferramenta é apenas para fins educacionais.
Desbloquear o BL pode anular a garantia.
Rootear pode causar bootloop, perda de dados ou incompatibilidade de apps.
Se você tijolar seu dispositivo, isso é skill issue.
Se me culpar, problema seu.
Se você rir, é um de nós.
710 Festival do Desbloqueio! 🚀

💡 Curiosidades / FAQ

P: Por que "710 Festival do Desbloqueio"?
R: 10 de julho. Não é dia de loja de conveniência (7/11), nem o que quer que seja 9 de julho. 10 de julho. Neste dia não desbloqueamos bootloaders, libertamos telefones.

P: QwQ?
R: Emocionalmente estável (grande mentira).

P: Posso usar isso sem desbloquear o BL?
R: Sim. A injeção LD_PRELOAD não precisa de BL desbloqueado. Mas você precisará reinjetar após reiniciar.

P: Isso vai disparar o Kernelsnitch?
R: O bypass do Kernelsnitch está incluído. Se ainda for pego, skill issue.

P: 114514?
R: はいはいわかりました草

_{Feito com 💀, ☕, 710% de esforço e absolutamente zero Comic Sans}