<!-- Generated by vite-plugin-geo; source: 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](/keyboards/air75-v3/)[Kick75](/keyboards/kick75/)[Halo75 V2](/keyboards/halo75-v2/)[Halo96 V2](/keyboards/halo96-v2/)[Air75 V2](/keyboards/air75-v2/)[Node75 Low-Profile](/keyboards/node75-lp/)

## 5 个高频任务教程与排查指南

[蓝牙与 2.4G 配对](/guides/bluetooth-pairing/)[背光与关灯方法](/guides/backlight-rgb/)[电量灯与指示灯诊断](/guides/battery-indicator/)[恢复出厂与休眠排查](/guides/reset-sleep-troubleshooting/) [使用教程](/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 本地客户端包以备兼容需求。
