Hostinger API CLI 安装与使用教程

一份快速的分步教程，教你安装 Hostinger CLI、连接到你的账户，并运行最常用的 VPS 命令。

第 1 步 – 下载并安装 CLI

macOS 和 Linux（推荐）使用 Homebrew 安装：

brew install hostinger/tap/hostinger

这还会自动安装 bash、zsh 和 fish 的 shell 补全。之后可以使用以下命令升级：

brew upgrade hostinger

Windows，或没有 Homebrew 的情况： 从发布页面下载适合你的平台（系统架构）的压缩包，并将 hostinger 二进制文件放到你的 PATH 中。每个压缩包中还附带了 shell 补全文件。

验证安装：

hostinger version

如果返回版本号，说明 CLI 已正确安装。

第 2 步 – 使用 API 令牌进行身份验证

根据你计划使用 CLI 的方式，有两种身份验证方法。

选项 A – 浏览器登录（默认，无需令牌）

只需运行任意命令。如果你尚未完成身份验证，CLI 会打开浏览器窗口让你登录，然后缓存并自动刷新你的凭据。对于交互式使用来说，这是最快的上手方式。

选项 B – API 令牌（推荐用于 CI/CD 和脚本）

1. 在 Hostinger 控制面板 → API 中生成令牌。
2. 通过环境变量或配置文件将令牌提供给 CLI：

环境变量（仅当前会话有效）：

export HOSTINGER_API_TOKEN=<paste_your_token_here>

配置文件（永久生效）： 创建 ~/.hostinger.yaml，内容如下：

api_token: <your API token>

任意命令都会自动从上述任一来源读取令牌。

注意： 已配置的令牌始终优先于浏览器登录。如果之前正常运行的命令突然授权失败，请首先检查配置文件或环境变量中是否存在过期的 api_token。

第 3 步 – 命令结构

命令遵循三级结构：

hostinger <group> <subgroup> <verb> [args] [flags]

示例：

hostinger vps virtual-machines list
hostinger vps virtual-machines get <vm_id>
hostinger vps vm start <vm_id>        # "vm" 是 "virtual-machines" 的简短别名
hostinger vps vm stop <vm_id>
hostinger dns records list example.com
hostinger billing catalog list

在任意层级添加 --help 即可查看某个组或子组包含的内容，例如：

hostinger vps --help
hostinger vps firewall --help

第 4 步 – 输出格式

默认情况下，结果以表格形式打印。使用 --format 可以更改：

hostinger vps virtual-machines list --format json | jq
hostinger vps virtual-machines list --format tree

• table – 人类可读（默认）
• json – 适合通过管道传递给脚本、控制面板或 jq
• tree – 以树形结构展示嵌套数据，便于探索响应的结构

提示： CLI 与 Hostinger API 端点一一对应，因此你在 developers.hostinger.com 上能做的一切都可以通过 hostinger 完成。

Shell 补全

bash、zsh、fish 和 PowerShell 均支持 Tab 补全。Homebrew 会自动安装 bash/zsh/fish 补全。如需手动安装，请参阅 CLI 仓库中的 AUTOCOMPLETE.md。

官方文档

• CLI 指南 – https://docs.hostinger.com/api-reference/cli
• 完整命令参考（所有命令，根据 API 规范生成）– https://github.com/hostinger/api-cli/blob/main/docs/hostinger.md
• 使用 CLI 编写脚本（退出代码、向命令行标志传入 JSON）– https://docs.hostinger.com/api-reference/cli-scripting
• API 参考 – https://developers.hostinger.com

一切就绪！

你现在可以自动化日常的 VPS 任务，将 Hostinger 操作集成到 CI/CD 流水线中，或者只是从终端更快地管理服务器。祝你写脚本愉快！