# Web ADB Toolkit

> 用 USB 接上 Android，在 Chrome 直接執行 ADB：裝置資訊、檔案傳輸、APK 側載、即時 logcat、shell 終端機，還有實驗性的 scrcpy 畫面鏡射。免裝 SDK，不上傳。

- URL: https://bytescope.dev/zh-Hant/web-adb/
- Locale: zh-Hant · Also: [en](https://bytescope.dev/en/web-adb.md) · [ja](https://bytescope.dev/ja/web-adb.md)
- Runs: 透過 USB 在本機和你的 Android 溝通 — 不會上傳到任何伺服器。
- Requires: Chrome, Edge or Opera on desktop, and Chrome on Android (WebUSB). Not Firefox, Safari or iOS.
- Updated: 2026-09-08

## What it does

Web ADB 工具箱透過 WebUSB 把你的 Android 手機接進瀏覽器，直接說 ADB 協定 —— 不用 Android SDK、不用 platform-tools，也不用安裝 `adb` 執行檔。它站在 ya-webadb（yume-chan，MIT）之上，也就是網頁版 scrcpy 背後的同一套引擎，再把它包成儀器風格的面板：拉出完整的裝置資訊（型號、Android 版本、序號、螢幕解析度、電量與已安裝套件數）、用 sync 協定瀏覽與傳輸檔案、把 APK 拖進來側載、用標籤／等級／正規表示式過濾即時觀察 logcat，並在真正的終端機裡執行 `adb shell`。

### USB 可以，無線不行 —— 這是誠實的答案

USB 版的 ADB 在 Chrome 與 Edge 上運作良好。無線 ADB 不行，而且沒有任何網頁能解決這件事：瀏覽器沒有原始 TCP socket，所以從網頁應用執行 `adb connect 192.168.x.x:5555` 根本不可能（Direct Sockets API 只保留給已安裝的 Isolated Web App）。這個工具能做的是替你把手機切到無線模式：先用 USB 接一次，按下「啟用無線除錯」，它就會在裝置上執行 `adb tcpip 5555`。之後你就從自己電腦上的 `adb` 走 Wi-Fi 連線。這個網頁扮演的是開關，不是無線用戶端。

### Windows 可能要換驅動程式

在 Windows 上，WebUSB 常常抓不到手機的 ADB 介面，除非你先用 Zadig 把它的驅動程式換成 WinUSB —— 這是網頁版 ADB 在 Windows 上失敗的最大單一原因，所以工具會偵測 Windows，並在連線失敗時一步一步帶你做完。macOS、Linux 與 ChromeOS 完全不需要這一段；手邊有的話，插上就能用。這一切都在本機進行：你的手機和你的瀏覽器對話，沒有任何東西上傳到任何伺服器。

先在 APK 分析器裡分析一份 APK，再跳到這裡把它裝到真實裝置上 —— 這兩個工具構成一個循環：先檢視，再側載。

## Limits

Does not root, unlock or bypass FRP, and does not work over Wi-Fi ADB from the browser; it needs USB debugging enabled.

警告：上傳會寫入裝置，並覆蓋同一路徑的檔案。下載則是唯讀的。

## FAQ

### 可以從瀏覽器用 Wi-Fi 或無線方式連上 ADB 嗎？

不行 —— 而且任何聲稱做得到的網頁工具都值得懷疑。瀏覽器沒有原始 TCP socket，所以網頁無法開啟 `adb connect 192.168.x.x:5555`。這個工具只走 USB 連線。它能做的是替你啟用無線除錯：先用 USB 連一次、按下按鈕，它就會在手機上執行 `adb tcpip 5555`，接著你就能從自己電腦的 `adb` 走 Wi-Fi 連上。

### 要怎麼用它啟用無線 ADB？

用 USB 把手機插上，連線並在手機畫面上按同意，然後點「啟用無線除錯」。工具會執行 `adb tcpip 5555`，讓手機的 ADB 服務改成監聽 TCP 連接埠 5555。到「設定」裡找出手機的 IP，然後在你的電腦上執行 `adb connect <phone-ip>:5555`。最後這一步瀏覽器自己做不到。

### 哪些瀏覽器可以用？

桌面版的 Chrome 與 Edge（以及 Android 版 Chrome 148 以上），因為 WebUSB 是 Chromium 專屬的 API。Firefox 與 Safari 並未實作 WebUSB，也沒有公布任何計畫，所以它們根本無法建立 ADB 連線。頁面在那裡仍然會載入並說明原因，只是 ADB 功能無法使用。

### 為什麼 Windows 偵測不到我的手機？

在 Windows 上，手機的 ADB 介面通常需要 WinUSB 驅動程式，用一個叫 Zadig 的免費工具就能安裝。如果連線失敗，工具箱會顯示逐步教學：執行 Zadig、開啟 List All Devices、選到 ADB 介面，把它的驅動程式換成 WinUSB。macOS、Linux 與 ChromeOS 不需要任何驅動程式，體驗順暢得多。

### 我的資料或 APK 會被上傳到哪裡嗎？

不會。所有處理都在你的瀏覽器裡，並透過 USB 直接和手機對話。你側載的 APK、傳輸的檔案、logcat 與 shell 的輸出都不會離開你的電腦 —— 這條路徑上沒有伺服器。

### 可以鏡射並操控手機畫面（scrcpy）嗎？

有一個實驗性的畫面鏡射區塊，使用 scrcpy 協定搭配 WebCodecs 的 H.264 解碼。它是整個工具裡最吃資源的功能，也取決於你的瀏覽器是否支援硬體 H.264 解碼；不支援時面板會直接說明，而不是壞掉。核心面板 —— 裝置資訊、檔案、APK 安裝、logcat 與 shell —— 沒有它也照樣能用。

## Related tools

- [APK Analyzer](https://bytescope.dev/zh-Hant/apk-analyzer.md) — 先看 APK 的權限和簽章，再回來這裡側載 →