<!-- Generated by vite-plugin-geo; source: zh-tw/guides/nuphyio-via-setup/index.html -->

# NuPhyIO 2.0 與 VIA 設定教學｜WebHID 瀏覽器辨識排除

> 詳解 NuPhyIO 2.0（含 1.0 切換與桌面端）與 VIA（NuPhy Console / usevia.app）適用型號對照、Kick75 與 Halo V2 雙版本警告，以及 Chrome/Edge 有線 WebHID 辨識排除。

## 一句話結論

NuPhyIO（nuphy.io，目前為 NuPhyIO 2.0 並可切換 1.0）與 VIA（NuPhy Console / usevia.app）皆依賴 WebHID，必須使用桌面端 Chrome 或 Microsoft Edge，並把鍵盤撥至有線模式後透過 USB-C 資料傳輸線直連電腦——藍牙與 2.4G 無線模式下無法辨識。

## 1\. 依型號確認應該開啟 NuPhyIO 還是 VIA

選錯網頁驅動不僅認不出裝置，在雙版本型號上還可能下載錯誤韌體。請先對照下表：

設定生態

適用型號

官方入口

NuPhyIO 2.0（網頁 / 用戶端）

Air60 HE、Air75 HE、Air75 V3、Air100 V3、Node75（LP/HP）、Node100（LP/HP）

www.nuphy.io/zh-CN

QMK / VIA（網頁改鍵）

Air60 V2、Air75 V2、Air96 V2

nuphy.com/pages/console 或 usevia.app

雙版本獨立（務必核對！）

Kick75、Halo75 V2、Halo96 V2 各分 NuPhyIO（IO）版與 QMK/VIA 版

依所購版本對應入口，不可交叉混用

雙版本硬性警告：Kick75、Halo75 V2 與 Halo96 V2 的 IO 版與 QMK/VIA 版韌體、VIA JSON 與復原檔案完全不相容，切勿交叉刷寫。

## 2\. WebHID 瀏覽器無法辨識鍵盤的 5 步排除

- 使用支援 WebHID 的瀏覽器：必須使用桌面端 Chrome 或 Microsoft Edge；Safari 與 Firefox 不支援 WebHID。
- 切換至有線模式並以資料線直連：將鍵盤實體開關撥至 Wired（有線），使用支援資料傳輸的 USB-C 線直接連接電腦主機板連接埠，避開僅充電線與無源集線器。
- 排除連接埠衝突：同一時間只開啟一個設定分頁，並暫時退出可能佔用 HID 裝置權限的其他周邊軟體或本地 NuPhyIO 桌面用戶端。
- NuPhyIO 1.0 與 2.0 切換：若較早批次的 NuPhyIO 鍵盤在 2.0 介面異常，可使用頁面頂部或入口提供的 NuPhyIO 1.0 切換，或於官方韌體更新頁面下載 Windows/macOS 用戶端。
- 第三方品牌辨別：Weikav Nut75 使用 Weikav 自家網頁驅動，不能透過 NuPhyIO 或 NuPhy Node75 流程辨識。

## 常用設定教學關聯型號

[Air75 V3](/zh-tw/keyboards/air75-v3/)[Kick75](/zh-tw/keyboards/kick75/)[Halo75 V2](/zh-tw/keyboards/halo75-v2/)[Halo96 V2](/zh-tw/keyboards/halo96-v2/)[Air75 V2](/zh-tw/keyboards/air75-v2/)[Node75 Low-Profile](/zh-tw/keyboards/node75-lp/)

## 5 個高頻任務教學與排除指南

[藍牙與 2.4G 配對](/zh-tw/guides/bluetooth-pairing/)[背光與關燈方法](/zh-tw/guides/backlight-rgb/)[電量燈與指示燈診斷](/zh-tw/guides/battery-indicator/)[回復原廠與休眠排除](/zh-tw/guides/reset-sleep-troubleshooting/) [使用教學](/zh-tw/guides/)

## NuPhyIO 與 VIA 常見問題

為什麼在藍牙或 2.4G 模式下打不開 NuPhyIO 或 VIA？

瀏覽器 WebHID 協定只能存取透過 USB 資料傳輸線直連電腦的周邊裝置。設定按鍵、燈光或韌體前，必須將鍵盤切到有線模式並以 USB-C 資料傳輸線直連電腦。

Mac 上的 Safari 瀏覽器可以使用 NuPhyIO 嗎？

不可以。Safari 與 Firefox 預設不支援 WebHID API，請在 macOS 或 Windows 上使用 Google Chrome 或 Microsoft Edge。

Halo75 V2 或 Kick75 不確定自己是 IO 版還是 VIA 版怎麼辦？

可先檢查外包裝標籤是否帶有 IO 字樣；也可以在有線直連下分別以 Chrome 開啟 nuphy.io 與 VIA 測試辨識狀況，認出後再前往對應的官方說明書與韌體頁。

NuPhyIO 2.0 與 1.0 有什麼區別？

nuphy.io 目前預設運行 NuPhyIO 2.0，同時保留了 NuPhyIO 1.0 切換入口，並在韌體更新頁提供 Windows 與 macOS 本地用戶端套件以備相容需求。
