# Firmware Installer

> 在瀏覽器把 WLED、Tasmota、ESPHome 或 ESPEasy 裝到 ESP32／ESP8266 上 —— 接上 USB 一鍵燒錄，接著直接在瀏覽器完成 Wi-Fi 設定，不上傳任何東西。

- URL: https://bytescope.dev/zh-Hant/install/
- Locale: zh-Hant · Also: [en](https://bytescope.dev/en/install.md) · [ja](https://bytescope.dev/ja/install.md)
- Runs: 透過 USB（Web Serial）在本機燒錄你的裝置 — 不會上傳任何東西。
- Requires: Chrome, Edge or Opera on desktop (Web Serial API). Not Firefox, Safari or any mobile browser; the page still renders the documentation and a support matrix there.
- Updated: 2026-09-08

## What it does

這是一個 App Store 風格的開源 ESP 韌體安裝器。挑一個專案 —— WLED、Tasmota、ESPHome 或 ESPEasy —— 把開發板插進 USB 連接埠，安裝器就會辨識晶片、下載對應的映像檔並燒進去。一般燒錄工具會攤在你面前的那些 flash 位址細節全都收起來了；你只要按「安裝」。

### 接著幫你連上網路

如果韌體支援 Improv-Serial 協定，安裝器最後會問你 Wi-Fi 名稱和密碼，直接在瀏覽器裡替開發板完成配網 —— 不用序列終端機，也不用連進裝置自己開的設定網頁。從插上線到裝置真的連上網，總共只要幾分鐘。

### 不上傳任何東西

燒錄完全在你的瀏覽器與開發板之間，透過 Web Serial API 進行，那是 Chromium 專屬的功能（Chrome、Edge、Opera）。唯一的對外請求是去下載韌體官方自己的釋出檔；當那個主機沒有給 CORS 標頭時，才由一個很薄的同源代理替瀏覽器抓同一個檔案。

## Limits

Does not host arbitrary user firmware; it installs the listed open-source projects onto supported boards.

燒錄會覆蓋目前的韌體，也會抹除板子上已存的所有設定，而且無法復原。

## FAQ

### 哪些瀏覽器可以安裝韌體？

桌面版的 Chrome、Edge 與 Opera，因為它們實作了 Web Serial API。Firefox 與 Safari 沒有，所以在那裡任何網頁都無法燒錄開發板 —— 頁面會誠實顯示支援狀況表，而不是給你一顆壞掉的按鈕。

### 這會把我的板子燒成磚嗎？

燒錄會取代目前的韌體，而且無法還原，所以需要留的東西請先自己備份。但 ESP 晶片不會永久變磚：萬一燒錄失敗，重新接上時按住 BOOT 按鈕強制進入下載模式，再燒一次就好。

### 每一種韌體都在實機上測過了嗎？

整個流程是照各專案真實的釋出網址與 flash 慣例接起來的，但內建的專案都標記為未測試 —— 這裡沒有任何一份映像檔經作者在實體板子上驗證過。請把這個狀態當成誠實的說明：請在你自己的裝置上驗證。

### 這是官方的安裝器嗎？

不是。這個頁面不是由 WLED、Tasmota、ESPHome 或 ESPEasy 營運。它會從各專案自己的 GitHub 釋出頁下載官方釋出檔，並原封不動燒進去 —— 這裡沒有任何東西被重新編譯、修補或轉貼代管。當釋出主機沒有送出 CORS 標頭時，會由一個很薄的同源代理替瀏覽器抓同一個檔案。

### 它會清掉我現在的韌體和設定嗎？

會。第一次安裝會在寫入之前執行整顆抹除，所以舊韌體、它存的 Wi-Fi 憑證和所有裝置設定都會消失。這正是全新安裝之所以乾淨的原因，但也無法還原 —— 開始之前，請先從現有韌體匯出你在意的東西。

### 偵測不到我的開發板，該試什麼？

先從線材開始：很多 USB 線只供電、不傳資料。接著關掉其他佔住連接埠的程式（Arduino IDE、PlatformIO、另一個序列埠監控）。在 Windows 上，相容板常常需要 CH340 或 CP210x 的 USB 轉序列驅動程式。如果連接埠出現了但晶片始終沒回應，插上板子時按住 BOOT/IO0 按鈕，強制進入 ROM 下載模式。