跳转到内容
无痕工具库 无痕工具库

Hostinger Mail API 官方 CLI 安装与使用教程

你可以使用**官方命令行界面（CLI）**工具，直接在系统终端中管理你的 Hostinger 电子邮件账户、邮件、文件夹、Webhook 和配额。这款官方工具让你无需编写自定义脚本或手动处理 HTTP 请求。

本教程将介绍如何在 macOS、Linux 和 Windows 上安装 hostinger-mail CLI 工具、如何进行账户身份验证，以及如何运行基本命令。

开始之前

要使用 Hostinger Mail API CLI 工具，请确保你具备以下条件：

第 1 步 – 安装 Hostinger Mail CLI

安装方法取决于你所使用的操作系统。请按照与你平台对应的说明操作。

方案 A – macOS（Homebrew）

如果你使用的是 macOS，可以通过 Homebrew 安装该工具。

  1. 打开终端。
  2. 运行以下命令，添加官方 tap 仓库并安装二进制文件：

Bash

brew install hostinger/tap/hostinger-mail

方案 B – Linux 和 Windows

对于 Linux 和 Windows，请直接从官方仓库的发布页面下载最新的跨平台二进制文件。

  1. 下载与你的操作系统架构对应的二进制文件。
  2. 将该二进制文件放入系统执行路径（PATH 变量）所包含的目录中，以便在任何位置运行它。

第 2 步 – 使用 API 密钥进行身份验证

该工具需要通过 API 密钥身份验证来安全地连接你的邮箱服务。你可以通过配置文件或环境变量来配置凭据。

方案 A – 使用配置文件（持久化）

  1. 在你的主目录中创建一个名为如下文件的配置文件：

    .hostinger-mail.yaml.

  2. 使用文本编辑器打开该文件，并按以下格式粘贴你的令牌：
    YAML

    api_key: YOUR_API_KEY_HERE

  3. 保存文件。工具在执行操作时会自动查找此文件。

方案 B – 使用环境变量（临时）

  1. 直接在终端会话中设置该变量。 
    1. 在 Linux 和 macOS 上，运行：
      Bash
      export HOSTINGER_MAIL_API_KEY="YOUR_API_KEY_HERE"
    2. 在 Windows PowerShell 上，运行：
      PowerShell
      $env:HOSTINGER_MAIL_API_KEY="YOUR_API_KEY_HERE"

环境变量是临时的，关闭当前终端窗口后会自动清除。如需永久配置，请使用配置文件方法。

第 3 步 – 通过命令管理邮件

配置完成后，每个 Mail API 操作都对应终端中的一个专用子命令。该工具提供多种输出结构，包括整洁的表格、原始 JSON 和可视化树状结构。

  1. 要查看完整的命令列表和全局选项，请为工具附加 help 标志：
    Bash

    hostinger-mail --help

  2. 运行特定的子命令来管理你的邮箱资源。例如，查看当前的配额使用情况：
    Bash

    hostinger-mail quota get

  3. 要查看文件夹或发送邮件，请执行相应的操作：
    Bash

    hostinger-mail folders list
    

    hostinger-mail messages send --to="recipient@example.com" --subject="Terminal Test" --body="Sent via CLI."

第 4 步 – 启用 Shell 自动补全（可选）

你可以启用 Shell 自动补全功能，这样当你按下 TAB 键时，命令结构会自动补全。

  1. 通过运行 completion 命令，为你的特定 Shell 环境（如 Bash、Zsh、fish 或 PowerShell）生成自动补全脚本：
    Bash

    hostinger-mail completion bash

  2. 按照终端中的说明，将生成的脚本追加到你的配置文件（profile）中，然后重新打开终端窗口。

现在，你可以在系统命令行中更快速地管理 Hostinger 电子邮件设置、监控 Webhook、查看数据配额以及处理邮件了。