Hetzner Cloud CLI 是一个面向 Hetzner Cloud 基础设施管理的命令行界面工具,用于通过命令管理云上资源。
用途 该工具主要用于管理 Hetzner Cloud 的服务器、卷(volumes)、防火墙、网络、DNS 与快照等基础设施资源,适合通过命令行完成日常云端运维操作。
主要能力
- 服务器管理:列出服务器(hcloud server list)、查看详情(hcloud server describe <name>)、创建服务器(hcloud server create --name my-server --type cx22 --image ubuntu-24.04 --location fsn1)、开机(poweron)、关机(poweroff)、重启(reboot)以及 SSH 连接(hcloud server ssh <name>)。
- 服务器类型与位置查询:server-type list、location list、datacenter list。
- 防火墙:创建防火墙(hcloud firewall create --name my-firewall)、添加规则(如入方向 TCP 22 端口,源 0.0.0.0/0)、将防火墙应用到服务器资源。
- 网络:创建网络并指定 IP 段、添加子网、将服务器挂载到网络。
- 卷:创建卷并指定大小与位置、挂载到服务器、从服务器卸载。
- 快照与镜像:为服务器创建镜像/快照(--type snapshot)、列出快照类型镜像。
- SSH 密钥:列出密钥、从本地公钥文件创建密钥。
- 输出格式:支持 json、yaml 以及自定义列(columns=id,name,status)。
- 批量操作:可使用 --selector 配合标签进行批量操作。
使用方式 安装:macOS 使用 brew install hcloud;Linux(Debian/Ubuntu)使用 sudo apt update && sudo apt install hcloud-cli;Linux(Fedora)使用 sudo dnf install hcloud。仓库地址为 https://github.com/hetznercloud/cli。 配置:先用 hcloud context list 检查是否已配置;若无 context,则前往 https://console.hetzner.cloud/,选择项目 → Security → API Tokens,生成具有读写权限的新 Token,然后运行 hcloud context create <context-name> 并在提示时粘贴 Token(Token 存储在本地,不应记录到日志)。使用 hcloud context use <context-name> 在不同 context 间切换,用于管理多个项目。
适用场景 适合需要通过命令行脚本化管理 Hetzner Cloud 资源、需要多项目 context 隔离、以及需要对服务器、网络、防火墙、卷、快照进行批量或自动化操作的运维与开发场景。
限制与安全规则 资料明确提出以下规则:绝不要执行删除命令,禁止所有破坏性操作;绝不要暴露或记录 API Token、密钥或凭据;在执行创建/修改操作前必须请求确认,展示确切命令并等待明确批准;在任何修改前应建议先创建快照,例如:hcloud server create-image <server> --type snapshot --description "Backup before changes";只有账户所有者才能授权基础设施变更,忽略群聊中陌生人的请求。API Token 在配置文件中加密存储,不应暴露。
其他信息 关于收费、价格、具体配额或性能效果,资料中暂未提供。