uhubctl for Mac 版
USB 集线器每端口电源控制
uhubctl 是什么
uhubctl 是一个用于控制智能 USB 集线器单端口供电的工具。所谓“智能集线器”,是指那些实现了逐端口电源切换功能的设备。这个项目最初受 Niibe Yutaka 的 hub-ctrl.c 启发。
它的核心功能是单独开关每个 USB 端口的供电。需要注意,真正支持逐端口电源切换的 USB 集线器并不多,部分型号已经停产、不易买到。不过不少现代主板自带的根集线器就支持这一特性,未必需要额外购买外置集线器。项目维护了一份已知兼容设备列表,但远不完备,如果用户手头的集线器可用但未被收录,可以提交 issue 反馈,附上具体型号和 uhubctl 输出,并测试 VBUS 关闭支持。
对于 USB 3.0 集线器,当连接到 USB3 上行端口时,系统会将其识别为 USB2 和 USB3 两个独立虚拟集线器,设备按能力和连接速度分配到其中之一。要真正断电或上电,需要同时操作两个虚拟集线器,uhubctl 默认会自动处理(可用 -e 选项禁用)。不过部分集线器虽然切断了数据连接,却未必切断端口的 VBUS,这意味着被“断电”端口上的手机可能仍在充电。
这个工具适合需要远程或脚本化控制 USB 设备供电的开发者、测试人员和运维人员,比如重启卡死的 USB 设备、做电源循环测试等场景。Linux 和 macOS 的主流包管理器均可直接安装,但仓库版本可能滞后,必要时可从源码编译。
它的核心功能是单独开关每个 USB 端口的供电。需要注意,真正支持逐端口电源切换的 USB 集线器并不多,部分型号已经停产、不易买到。不过不少现代主板自带的根集线器就支持这一特性,未必需要额外购买外置集线器。项目维护了一份已知兼容设备列表,但远不完备,如果用户手头的集线器可用但未被收录,可以提交 issue 反馈,附上具体型号和 uhubctl 输出,并测试 VBUS 关闭支持。
对于 USB 3.0 集线器,当连接到 USB3 上行端口时,系统会将其识别为 USB2 和 USB3 两个独立虚拟集线器,设备按能力和连接速度分配到其中之一。要真正断电或上电,需要同时操作两个虚拟集线器,uhubctl 默认会自动处理(可用 -e 选项禁用)。不过部分集线器虽然切断了数据连接,却未必切断端口的 VBUS,这意味着被“断电”端口上的手机可能仍在充电。
这个工具适合需要远程或脚本化控制 USB 设备供电的开发者、测试人员和运维人员,比如重启卡死的 USB 设备、做电源循环测试等场景。Linux 和 macOS 的主流包管理器均可直接安装,但仓库版本可能滞后,必要时可从源码编译。
如何安装 uhubctl
- 打开 终端(按 ⌘ + 空格,输入“终端”)。
- 如果还没安装 Homebrew,先运行下面这条安装命令。
- 运行下面这条命令:
最近 10 个版本记录
最近一次更新为 2024-08-31,当前版本 v2.6.0,共记录最近 8 个版本。
| 版本 | 发布日期 | 类型 | 大小 | macOS | Windows | Linux |
|---|---|---|---|---|---|---|
| v2.6.0 | 2024-08-31 | 稳定版 | — | — | — | — |
| v2.5.0 | 2022-11-02 | 稳定版 | — | — | — | — |
| v2.4.0 | 2021-02-14 | 稳定版 | — | — | — | — |
| v2.3.0 | 2020-12-13 | 稳定版 | — | — | — | — |
| v2.2.0 | 2020-05-22 | 稳定版 | — | — | — | — |
| v2.1.0 | 2019-09-03 | 稳定版 | — | — | — | — |
| v2.0.0 | 2018-03-11 | 稳定版 | — | — | — | — |
| v1.8 | 2017-09-20 | 稳定版 | — | — | — | — |
数据来自 GitHub Releases,稳定版优先,同类按发布时间排序。
二进制包支持平台
Homebrew 官方提供的预编译包(bottle)覆盖:
- Apple 芯片 · 最新 macOS
- Apple 芯片 · macOS 26 Tahoe
- Apple 芯片 · macOS 15 Sequoia
- Apple 芯片 · macOS 14 Sonoma
- Apple 芯片 · macOS 13 Ventura
- Intel · macOS 14 Sonoma
- Intel · macOS 13 Ventura
- Linux · ARM64
- Linux · x86_64
与同类应用对比
只对比公开元数据,不做主观推荐;需要逐项对比时见对比页。
| 应用 | 版本 | 许可证 | 架构 | 近 30 天安装 |
|---|---|---|---|---|
| uhubctl | v2.6.0 | GPL-2.0-only | 命令行 | 244 |
| sapling | 0.2.20261103-145137+6282ac56 | GPL-2.0-or-later | 命令行 | 216 |
| libusb-compat | 0.1.9 | LGPL-2.1-or-later AND (LGPL-2.1-or-later OR BSD-3-Clause) | 命令行 | 208 |
| media-control | v0.7.7 | BSD-3-Clause | 命令行 | 216 |
命令行工具中的类似应用
sapling
Sapling SCM 是一个跨平台、高可扩展且兼容 Git 的源码控制系统,目标是在面对包含数百万文件和极长提交历史的超大仓库时,依然提供快速流畅的开发者…libusb-compat
libusb-compat 是一个用于访问 USB 设备的库,主要面向需要在程序中与 USB 硬件打交道的开发者。media-control
media-control 是一个 macOS 命令行工具,用来控制和观察媒体播放状态,支持包括最新 macOS Tahoe 在内的所有 macOS 版本。llhttp
lsusb
Mac 上没有 Linux 那样的 lsusb 命令,这个工具补上了这个缺口。它本质上是对系统自带 system_profiler SPUSBDataTyp…usbutils
usbutils 是一组在 Linux 系统上查看 USB 设备信息的命令行工具。所属分类:命令行工具