> ## Documentation Index
> Fetch the complete documentation index at: https://oom-wg.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 使用指南

> ShiroSU NewTech 的安装步骤和使用说明

## 检查设备支持

ShiroSU NT 仅支持 Android 版本大于等于 `10` 的设备

通常可以在 `设置` → `关于本机` 获取到 Android 版本号，例如:

```properties theme={null}
# Android 版本
ro.build.version.release=16
# Android 安全更新
ro.build.version.security_patch=2026-02-01
```

## 修补启动镜像

ShiroSU 提供了一种网页修补方案，仅需要将设备的 `init_boot.img` 或 `boot.img` (**优先前者**) 上传，即可在镜像中安装 ShiroSU NT

<Card icon="link" horizontal href="https://su.shiror.ren/patch" title="修补镜像">
  ShiroSU NT 仅支持系统版本为 **Android 10+** 的设备
</Card>

<Warning>ShiroSU NT 不可与 Magisk 及其分支或类似实现共存！</Warning>

## 刷入镜像

ShiroSU 网页支持修补后通过 fastboot 刷入，也可以通过如下命令手动刷入

<CodeGroup>
  ```sh init_boot 分区机型 theme={null}
  fastboot flash init_boot <修补后的镜像路径>
  ```

  ```sh boot 分区机型 theme={null}
  fastboot flash boot <修补后的镜像路径>
  ```
</CodeGroup>

<Danger>在刷入之前请备份原厂镜像！如果设备无法开机，刷写回原厂镜像即可</Danger>

<Note>网页 fastboot 刷机仅在 **Chromium 内核**的浏览器上可用</Note>

## 使用

ShiroSU NT 可以通过 WebUI 进行管理

在这之前需要获取设备的 **序列号** 作为唯一的密钥，执行以下任意命令即可获取到设备的序列号，或者在 `关于本机` 中找到序列号，
大部分机型的序列号为 **16**位*大写字母*&*数字* 或 **8**位*小写字母*&*数字*

<Tip>欧加真的高通机型在系统设置中显示的序列号通常是不准确的，请优先通过命令行获取</Tip>

<CodeGroup>
  ```sh ADB (电脑) theme={null}
  adb get-serialno
  ```

  ```sh ADB (本机) theme={null}
  getprop ro.serialno
  ```

  ```sh bootloader/fastboot (电脑) theme={null}
  fastboot getvar serialno
  ```
</CodeGroup>

### 连接后端

<Card icon="link" horizontal href="https://su.shiror.ren/settings" title="后端设置">
  建立与后端的连接
</Card>

* 目标IP: 默认 `127.0.0.1`
* 目标端口: 默认 `5355`
* 鉴权密码: 默认 设备序列号 (在无序列号的设备上将回退为 `SSU-PASSWD`)

<Tip>如果在局域网中可以在其他设备上填写对应 IP，也可以使用 adb 进行端口转发: `adb forward tcp:5355 tcp:5355`</Tip>

<Warning>推荐在 **Chromium 内核**的浏览器上使用 ShiroSU 网页</Warning>

***

<Card title="常见问题" icon="message-circle-question-mark" arrow href="/ssu/nt/usage/faq">
  若有问题，可在此处查看
</Card>