Automic VaultAutomic Vault

brew

使用 Homebrew, apk, apt, dnf, MacPorts, Nix, zypper 安装 uhubctl

查看 uhubctl 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

安装命令安全说明

安装

其他安装命令

macOS

Homebrew已验证 · 100%
brew install uhubctl

local Homebrew formula metadata

MacPorts已验证 · 94%
sudo port install uhubctl

MacPorts ports tree · sysutils/uhubctl/Portfile · 来源: api.github.com

Linux

Alpine Linux apk已验证 · 92%
sudo apk add uhubctl

Alpine Linux edge package indexes · uhubctl · 来源: dl-cdn.alpinelinux.org

Debian apt已验证 · 92%
sudo apt install uhubctl

Debian stable package indexes · uhubctl · 来源: deb.debian.org

Fedora dnf已验证 · 92%
sudo dnf install uhubctl

Fedora Rawhide package metadata · uhubctl · 来源: dl.fedoraproject.org

Nix已验证 · 92%
nix profile install nixpkgs#uhubctl

nixpkgs package indexes · pkgs/by-name/uh/uhubctl/package.nix · 来源: api.github.com

openSUSE zypper已验证 · 92%
sudo zypper install uhubctl

openSUSE Tumbleweed package metadata · uhubctl · 来源: download.opensuse.org

概览

软件包摘要

USB hub per-port power control

命令和别名

  • uhubctl

历史

项目历史与用法

uhubctl is a command-line utility for controlling per-port power on USB hubs that implement USB per-port power switching.

项目历史

The public uhubctl repository was created in 2015. Its README credits hub-ctrl.c by Niibe Yutaka as the original inspiration and defines the target hardware as smart USB hubs that can switch power per port.

The project grew around a practical compatibility table rather than only a codebase. The README tracks known working hubs, monitors, docks, keyboards, Raspberry Pi boards, and embedded devices, and asks users to report working hardware with uhubctl output and VBUS-off test results.

Release metadata shows v1.8 in 2017, v2.0.0 in 2018, a series of 2.x releases through 2022, and v2.6.0 in 2024.

采用历史

uhubctl's adoption is closely tied to lab automation, embedded development, Raspberry Pi work, USB device testing, and remote recovery workflows where physically unplugging a device is inconvenient. The README documents Raspberry Pi models and many external hubs and docks as compatible or partially compatible devices.

The supplied package data records uhubctl in Homebrew, MacPorts, Nix, Alpine, Debian, Ubuntu, Fedora/dnf, and openSUSE. The official README likewise lists package-manager install commands for macOS, Debian-family systems, Red Hat-family systems, openSUSE, and FreeBSD.

使用方式

The common command form is to list supported hubs, then turn a selected port off, on, toggle it, or cycle it with a configurable delay. The README documents location selection for multi-hub systems and cautions that switching built-in USB ports can disconnect keyboards or mice.

On Linux, the README documents udev rules for non-root access and notes that Linux kernel 6.0 and later provide a standard interface for disabling hub ports, which uhubctl tries to use instead of libusb where possible.

The README also explains USB 3.0 duality: a USB 3 hub can appear as separate USB2 and USB3 virtual hubs, and power changes may need to be applied to both for the physical port state to match the user's expectation.

为什么软件包爱好者会关心

uhubctl is significant because it turns a hardware capability that is inconsistently implemented by consumer devices into a scriptable package-manager tool. That makes it useful for test rigs, CI benches with attached hardware, home labs, and headless systems.

For packagers, the interesting part is not just compiling a small C program; it is carrying libusb behavior, OS-specific permissions, kernel interface changes, and documentation for hardware quirks that determine whether the command actually cuts power.

时间线

  • 2015: Public GitHub repository created.
  • 2017: v1.8 release published.
  • 2018: v2.0.0 release published.
  • 2020: v2.2.0 and v2.3.0 releases published.
  • 2022: v2.5.0 release published.
  • 2024: v2.6.0 release published.

Related projects

  • The README names hub-ctrl.c by Niibe Yutaka as the original inspiration.
  • uhubctl depends on libusb for portable USB access and, on newer Linux kernels, can use the kernel port-disable interface.

安全态势

风险级别：绿色

narrow executable package without higher-risk signals.

风险分类器

绿色 风险 · 低 置信度 · appliance

原因

  • narrow executable package without higher-risk signals

信号

  • metadata:no-higher-risk-signals

安装行为

  • formula 元数据中未记录 Homebrew post-install 钩子。
  • Homebrew bottle 元数据适用于 8 个平台目标。
  • 安装时包含 1 个运行时依赖。
  • 构建元数据列出 1 个构建依赖。

建议审查

在无人值守的代理使用前，请检查该工具是否读取明文凭据、写入远程状态、发布制品或调用插件。

可执行文件

已安装的可执行文件

命令类型暴露范围备注
uhubctlcli全局可执行文件

新鲜度

版本和新鲜度

这些信号区分页生成时间、软件包管理器活动和上游发布比较。只有存在证据 URL 和可比较版本时，才会提示版本落后。

页面生成时间2026-07-08
管理器版本2.6.0
管理器更新时间
本地数据OK
上游当前
检测到的最新版本v2.6.0

https://github.com/mvp/uhubctl

  • 信息No package-manager update timestamp was available.低 置信度

安装元数据

软件包元数据

软件包键brew:uhubctl
版本2.6.0
软件包管理器Homebrew
软件包管理器页面https://formulae.brew.sh/formula/uhubctl
主页https://github.com/mvp/uhubctl
仓库https://github.com/mvp/uhubctl
上游文档https://github.com/mvp/uhubctl
许可证GPL-2.0-only
源码归档https://github.com/mvp/uhubctl/archive/refs/tags/v2.6.0.tar.gz
依赖libusb
构建依赖pkgconf
Bottle可用 (于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, sonoma, ventura, x86_64_linux)
Homebrew post-install未定义
服务未声明

注册表事实

源数据库详情

Source DatabaseHomebrew formula API
Taphomebrew/core
Full Nameuhubctl
Version Scheme0
Revision0
Head VersionHEAD
Bottle Stable Root URLhttps://ghcr.io/v2/homebrew/core
Deprecatedno
Disabledno
Keg Onlyno
URL Keys
  • head
  • stable

源数据库匹配

其他软件包管理器记录

匹配项来自外部软件包管理器索引，并与本地 Automic Vault 软件包链接分开显示。

Debian apt95%

uhubctl 2.6.0-1

USB hub per-port power control

https://github.com/mvp/uhubctl

sudo apt install uhubctl
  • Section: electronics
  • Architecture: amd64
  • 2 依赖
  • normalized package name match
  • 匹配方式：Uhubctl
Debian stable package indexes · deb.debian.org · Debian stable package indexes: uhubctl from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz
Nix95%

uhubctl

nix profile install nixpkgs#uhubctl
  • normalized package name match
  • 匹配方式：Uhubctl
nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/uh/uhubctl/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
Ubuntu apt95%

uhubctl 2.5.0-1

USB hub per-port power control

https://github.com/mvp/uhubctl

sudo apt install uhubctl
  • Section: universe/electronics
  • Architecture: amd64
  • 2 依赖
  • normalized package name match
  • 匹配方式：Uhubctl
Ubuntu 24.04 LTS package indexes · archive.ubuntu.com · Ubuntu 24.04 LTS package indexes: uhubctl from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz
apk95%

uhubctl 2.5.0-r0

USB hub per-port power control

https://github.com/mvp/uhubctl

sudo apk add uhubctl
  • License: GPL-2.0-only
  • Architecture: x86_64
  • Source Package: uhubctl
  • 1 依赖
  • 1 提供
  • normalized package name match
  • 匹配方式：Uhubctl
Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: uhubctl from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz
dnf95%

uhubctl 2.6.0-5.fc44

USB hub per-port power control

https://github.com/mvp/uhubctl

sudo dnf install uhubctl
  • License: GPL-2.0-only
  • Category: Unspecified
  • Architecture: x86_64
  • Source Package: uhubctl
  • 4 依赖
  • 1 提供
  • normalized package name match
  • 匹配方式：Uhubctl
Fedora Rawhide package metadata · dl.fedoraproject.org · Fedora Rawhide package metadata: uhubctl from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst
zypper95%

uhubctl 2.6.0-1.5

USB hub per-port power control

https://github.com/mvp/uhubctl

sudo zypper install uhubctl
  • License: GPL-2.0-only
  • Category: Development/Tools/Other
  • Architecture: x86_64
  • Source Package: uhubctl
  • 2 依赖
  • 1 提供
  • normalized package name match
  • 匹配方式：Uhubctl
openSUSE Tumbleweed package metadata · download.opensuse.org · openSUSE Tumbleweed package metadata: uhubctl from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst
MacPorts95%

uhubctl

sudo port install uhubctl
  • normalized package name match
  • 匹配方式：Uhubctl
MacPorts ports tree · api.github.com · MacPorts ports tree: sysutils/uhubctl/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

软件包图谱

链接来自本地软件包关系图、补充数据、依赖边、生态匹配和软件包 hub 归属。

相关工具

  • pkgconfBuild dependency declared by Homebrew.

相同工作流

  • sispmctlShares av.db curated category or tags: cli, hardware, hardware-control, power-control, system.
  • blink1Shares av.db curated category or tags: cli, hardware, system, usb.
  • cymeShares av.db curated category or tags: cli, hardware, system, usb.
  • lsusbShares av.db curated category or tags: cli, hardware, system, usb.
  • quadcastrgbShares av.db curated category or tags: cli, hardware-control, system.
  • rkflashtoolShares av.db curated category or tags: cli, hardware, system, usb.

来源线索

由仓库数据生成

此页面由 av-web 从 scripts/generate-pkg-sqlite.py 生成的私有软件包 SQLite 工件提供。

使用的来源

  • Geiger risk classifier
  • Nucleus package database
  • av.db category and tag curation
  • cross-ecosystem install command graph
  • curated package history
  • external package-manager database matches
  • package relationship graph
  • package version freshness
  • package-page enrichment