shizukurunner 中文文档 下载 App

无线调试配对完整流程 - 从开发者选项到配对码

为什么需要配对

Shizuku 的权限不是凭空来的——它通过 Android 无线调试功能让系统信任自己的服务进程。配对过程就是让手机确认"这个 Shizuku 服务进程有权以 shell/root 身份运行"。

一次配对，长期有效——除非你恢复出厂设置或清空无线调试配对记录。

前置条件

步骤一：打开开发者选项

  1. 进入「设置」→「关于手机」（不同品牌路径可能略有差异）
  2. 连续点击「版本号」或「MIUI 版本」（小米）「Build 号」（原生）7 次
  3. 出现"您已进入开发者模式"提示后，返回设置主界面
  4. 搜索「开发者选项」或进入「系统设置」→「开发者选项」
打开开发者选项
连续点击 MIUI 版本号打开开发者模式

步骤二：打开无线调试

在开发者选项里：

  1. 找到「无线调试」开关，打开
  2. 点击「无线调试」进入详细设置页
  3. 在详细设置页，点击「使用配对码配对设备」（Android 12+ 可能显示为「配对设备」）
  4. 此时屏幕上会显示配对码、IP 地址和端口
无线调试配对码
无线调试配对页面显示配对码和地址

步骤三：Shizuku 应用内配对

  1. 打开 Shizuku 主应用
  2. 点击「无线调试配对」按钮（或通知栏里的 Shizuku 通知）
  3. 在弹窗里输入上一步屏幕上显示的配对码
  4. 同时在无线调试页面确认配对请求（部分系统需要手动点确认）

成功后，Shizuku 主应用会显示"已配对"状态。

步骤四：启动服务

配对完成后：

  1. 回到 Shizuku 主应用主界面
  2. 点击「启动」按钮
  3. Shizuku 会自动执行 shell 命令拉起服务进程
  4. 看到"已启动"绿色提示就表示成功了
Shizuku 启动成功
Shizuku 主应用显示已启动状态

步骤五：授权 Runner

  1. 手机上安装 ShizukuRunner
  2. 打开 Shizuku 主应用，进入「授权应用」列表
  3. 找到 ShizukuRunner，打开授权开关
  4. 确认弹窗里的权限请求

回到 Runner 主界面，顶部应该显示"SHIZUKU 已运行 已授权"。

配对失败怎么办

如果配对码输入后没有反应，常见原因：