# 使用 Homebrew, apk, dnf, MacPorts, Nix, pacman, scoop, winget, zypper 安装 hcloud 查看 hcloud 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。 ## 安装 ```sh sudo av install brew:hcloud ``` ## 代理安全回答 hcloud controls Hetzner Cloud resources from local credentials. - **凭据访问:** Reads Hetzner Cloud tokens, config files, and environment credentials. - **远程变更:** Can create, delete, and resize cloud servers, volumes, and networks. - **发布/制品风险:** Can deploy infrastructure used by application artifacts. - **推荐控制:** Gate mutating hcloud commands and token access. - **代理使用指南:** Allow list/describe operations; require approval for writes, deletes, and token changes. 其他安装命令: ### macOS - Homebrew (100%): ```sh brew install hcloud ``` 证据: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install hcloud ``` 证据: MacPorts ports tree: devel/hcloud/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - apk (92%): ```sh sudo apk add hcloud ``` 证据: Alpine Linux edge package indexes: hcloud from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz - dnf (92%): ```sh sudo dnf install hcloud ``` 证据: Fedora Rawhide package metadata: hcloud from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst - Nix (92%): ```sh nix profile install nixpkgs#hcloud ``` 证据: nixpkgs package indexes: pkgs/by-name/hc/hcloud/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman (92%): ```sh sudo pacman -S hcloud ``` 证据: Arch Linux sync databases: hcloud from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz - zypper (92%): ```sh sudo zypper install hcloud-cli ``` 证据: openSUSE Tumbleweed package metadata: hcloud-cli from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ### Windows - Scoop (92%): ```sh scoop install main/hcloud ``` 证据: Scoop official bucket manifest trees: bucket/hcloud.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 - winget (92%): ```sh winget install --id HetznerCloud.CLI -e ``` 证据: Windows Package Manager source index: HetznerCloud.CLI from https://cdn.winget.microsoft.com/cache/source.msix ## 软件包事实 - **软件包键:** brew:hcloud - **软件包管理器:** Homebrew - **软件包管理器页面:** - **版本:** 1.66.0 - **来源摘要:** Command-line interface for Hetzner Cloud - **主页:** - **仓库:** - **上游文档:** - **许可证:** MIT - **源码归档:** - **最后更新:** 2026-06-24T19:02:31Z - **已生成:** 2026-07-08T18:08:21+00:00 ## 可执行文件 - hcloud (cli) - hcloud (别名) ## 构建依赖 - go ## 安装行为 - post-install 钩子: 未定义 - Bottle: 可用 于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## 版本和新鲜度 - 页面生成时间: 2026-07-08 - 管理器版本: 1.66.0 - 管理器更新时间: 2026-06-24 - 本地数据: OK - 上游仓库: https://github.com/hetznercloud/cli - 检测到的最新版本: v1.66.0 (当前) ## 项目历史与用法 hcloud is Hetzner Cloud's official command-line client. It wraps the Hetzner Cloud API in a scriptable CLI for servers, images, SSH keys, networks, firewalls, load balancers, volumes, primary IPs, locations, storage boxes, DNS zones, and related cloud resources. ### 项目历史 Hetzner created the Go API client and CLI repositories in November 2017, then published the hcloud v1.0.0 release in January 2018. The CLI sits directly on the public Hetzner Cloud API, whose documentation describes HTTPS/JSON operations for cloud services and resources. The project evolved from a compact server-management CLI into the main terminal surface for Hetzner Cloud. Its manual documents global options, context selection, endpoint overrides, debug output, and resource subcommands, while the setup guide documents binary, Go, Debian, RPM, Homebrew, Windows package, and Docker installation paths. The configuration model grew around contexts: a named context stores an API token and preferences, while flags and environment variables can override config-file values. The documented default Unix config file is ~/.config/hcloud/cli.toml, and the token can also be supplied through HCLOUD_TOKEN for automation. ### 采用历史 hcloud adoption follows Hetzner Cloud's appeal to developers and small infrastructure teams that want direct control from shell scripts, CI jobs, and local terminals. The package-manager footprint in the batch input spans Alpine, Homebrew, Fedora, MacPorts, Nix, Arch, Scoop, WinGet, and openSUSE naming, which reflects broad demand for a native client outside the web console. The companion setup-hcloud GitHub Action shows a second adoption path: CI workflows install the CLI and pass HCLOUD_TOKEN to run resource commands during deployment. That made hcloud part of the same toolchain family as Terraform providers and cloud CLIs for other vendors, but with Hetzner-specific API coverage and output conventions. ### 使用方式 A first-time user installs the binary, creates a context with hcloud context create, enters a project API token, and verifies access with a read-only command such as hcloud datacenter list. After that, commands such as hcloud server, hcloud firewall, hcloud network, hcloud ssh-key, and hcloud volume become shell-friendly API operations. The config command documents the precedence order as flags, environment variables, context configuration, global configuration, and default values. That order is important for packaging and automation because the same installed CLI can be used interactively through cli.toml or non-interactively through HCLOUD_TOKEN and HCLOUD_CONTEXT. ### 为什么软件包爱好者会关心 hcloud is the kind of cloud CLI package maintainers like: a single Go binary with completions, man-page-style generated docs, release artifacts for multiple operating systems and architectures, and no daemon. The package is also operationally sensitive because it may read long-lived API tokens from its config file, so package quality and upgrade predictability matter. For Homebrew users, the significance is practical: hcloud gives macOS and Linux shells first-class access to Hetzner Cloud resources without waiting for a language SDK or a Terraform run. Its existence as an official CLI also gives other tools a stable executable to call. ### 时间线 - 2017: Hetzner Cloud CLI and Go API repositories created. - 2018: hcloud v1.0.0 release published. - 2018: Early 1.x releases established the public CLI distribution channel. - 2020: v1.21.0 tag appeared in the continuing 1.x series. - 2024: CLI configuration-system design work documented the ~/.config/hcloud/cli.toml model later reflected in generated manuals. - 2025: Storage Boxes support moved from experimental status to general availability in the CLI release stream. ### Related projects - hetznercloud/hcloud-go is the official Go library for the same API family. - hetznercloud/setup-hcloud installs the CLI in GitHub Actions workflows. - The Hetzner Cloud API documentation is the service contract behind the CLI. - Terraform and OpenTofu hcloud providers occupy the declarative infrastructure-administration role adjacent to hcloud's imperative shell workflow. ### 来源 - - - - - - - - - ## 安全说明 infrastructure mutation or orchestration signal. - **Geiger 风险:** orange / 中 - infrastructure mutation or orchestration signal ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ~/.config/hcloud/cli.toml ## Credential files - Unix: ~/.config/hcloud/cli.toml ## 源数据库详情 - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** hcloud - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## 其他软件包管理器记录 - Nix - hcloud: normalized package name match | nixpkgs package indexes: pkgs/by-name/hc/hcloud/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - apk - hcloud - 1.62.2-r1: normalized package name match | Alpine Linux edge package indexes: hcloud from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Command-line interface for Hetzner Cloud | https://github.com/hetznercloud/cli - apk - hcloud-bash-completion - 1.62.2-r1: normalized package name match | Alpine Linux edge package indexes: hcloud-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Bash completions for hcloud | https://github.com/hetznercloud/cli - apk - hcloud-fish-completion - 1.62.2-r1: normalized package name match | Alpine Linux edge package indexes: hcloud-fish-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Fish completions for hcloud | https://github.com/hetznercloud/cli - apk - hcloud-zsh-completion - 1.62.2-r1: normalized package name match | Alpine Linux edge package indexes: hcloud-zsh-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Zsh completions for hcloud | https://github.com/hetznercloud/cli - dnf - hcloud - 1.65.0-1.fc45: normalized package name match | Fedora Rawhide package metadata: hcloud from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | A command-line interface for Hetzner Cloud | https://github.com/hetznercloud/cli - pacman - hcloud - 1.65.0-1: normalized package name match | Arch Linux sync databases: hcloud from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | CLI for Hetzner Cloud | https://github.com/hetznercloud/cli - zypper - hcloud-cli - 1.65.0-1.1: normalized package name match | openSUSE Tumbleweed package metadata: hcloud-cli from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | A command-line interface for Hetzner Cloud | https://github.com/hetznercloud/cli - MacPorts - hcloud: normalized package name match | MacPorts ports tree: devel/hcloud/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 - Scoop - main/hcloud: normalized package name match | Scoop official bucket manifest trees: bucket/hcloud.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 - winget - HetznerCloud.CLI: normalized package name match | Windows Package Manager source index: HetznerCloud.CLI from https://cdn.winget.microsoft.com/cache/source.msix ## 相关链接 - [Cloud CLI packages](https://www.automicvault.com/zh-hans/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family. - [Source-control packages](https://www.automicvault.com/zh-hans/pkg/source-control-tools/) - Belongs to a source-control command family. - [Secret-risk packages](https://www.automicvault.com/zh-hans/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [Terminal utility packages](https://www.automicvault.com/zh-hans/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [go](https://www.automicvault.com/zh-hans/pkg/brew/go/) - Build dependency declared by Homebrew. - [osc-cli](https://www.automicvault.com/zh-hans/pkg/brew/osc-cli/) - Shares av.db curated category or tags: api-client, cli, cloud, cloud-cli, cloud-infrastructure. - [ucloud](https://www.automicvault.com/zh-hans/pkg/brew/ucloud/) - Shares av.db curated category or tags: api-client, cli, cloud, cloud-cli, cloud-infrastructure. - [oci-cli](https://www.automicvault.com/zh-hans/pkg/brew/oci-cli/) - Shares av.db curated category or tags: cli, cloud-cli, cloud-infrastructure, infrastructure. - [doctl](https://www.automicvault.com/zh-hans/pkg/brew/doctl/) - Shares av.db curated category or tags: api-client, cli, cloud, cloud-infrastructure. - [openstackclient](https://www.automicvault.com/zh-hans/pkg/brew/openstackclient/) - Shares av.db curated category or tags: cli, cloud, cloud-infrastructure, infrastructure. - [scw](https://www.automicvault.com/zh-hans/pkg/brew/scw/) - Shares av.db curated category or tags: cli, cloud, cloud-infrastructure, infrastructure. - [aiven-client](https://www.automicvault.com/zh-hans/pkg/brew/aiven-client/) - Shares av.db curated category or tags: cli, cloud, cloud-infrastructure. - [aliyun-cli](https://www.automicvault.com/zh-hans/pkg/brew/aliyun-cli/) - Shares av.db curated category or tags: cli, cloud, cloud-infrastructure. - [trigger.dev](https://www.automicvault.com/zh-hans/pkg/npm/trigger-dev/) - Local package facts share a topical domain. Shared terms: api, cli, cloud, cloud-infrastructure, command-line. ## Combined YAML source View the package source record on GitHub. [combined/hcloud.yml](https://github.com/automic-vault/db/blob/main/combined/hcloud.yml) ## 来源 - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph - curated agent safety answer