joniator/hcloud

hcloud CLI Docker镜像

镜像概述和主要用途

本镜像包含Hetzner Cloud的官方https://github.com/hetznercloud/cli%EF%BC%8C%E5%9F%BA%E4%BA%8E%E8%BD%BB%E9%87%8F%E7%BA%A7Alpine Linux构建。镜像会自动从hcloud官方GitHub发布页面拉取最新版本进行构建和打标签，提供便捷的Hetzner Cloud资源管理方式，无需在本地系统安装hcloud CLI。

注意：本镜像非hetznercloud官方维护，如有问题请通过https://gitlab.com/Joniator/docker-hcloud/issues%E5%8F%8D%E9%A6%88%E3%80%82

核心功能和特性

• 轻量级：基于Alpine Linux，镜像体积小，资源占用低
• 自动更新：自动从hcloud官方GitHub发布页面构建并更新版本
• 版本标签：提供多种标签选择，满足不同版本需求
• 即开即用：容器启动后可直接执行hcloud命令，无需额外配置

标签说明

• latest：始终指向最新版本
• vX.X.X：对应hcloud官方GitHub发布页面的具体版本（如v1.30.0）

使用场景和适用范围

• 需要通过命令行管理Hetzner Cloud资源的用户
• 自动化脚本或CI/CD流程中集成hcloud CLI
• 希望避免在本地系统安装hcloud CLI的环境
• 需要快速切换不同hcloud CLI版本的场景

使用方法和配置说明

基本使用

镜像内置hcloud可执行文件，直接在docker run命令后附加hcloud命令即可。

例如，查看hcloud版本：

bash
docker run docker.xuanyuan.run/joniator/hcloud version

执行其他hcloud命令

执行任意hcloud命令，格式为：

bash
docker run docker.xuanyuan.run/joniator/hcloud <hcloud-command> [options]

示例：列出所有服务器：

bash
docker run docker.xuanyuan.run/joniator/hcloud server list

配置认证

hcloud CLI需要通过API令牌进行认证。可以通过环境变量HCLOUD_TOKEN传递令牌：

bash
docker run -e HCLOUD_TOKEN="your-api-token" docker.xuanyuan.run/joniator/hcloud server list

或者挂载包含配置文件的目录（hcloud配置文件通常位于~/.config/hcloud/cli.toml）：

bash
docker run -v ~/.config/hcloud:/root/.config/hcloud docker.xuanyuan.run/joniator/hcloud server list