使用 GitHub Actions 部署到 Hostinger VPS 教程

借助 Deploy to Hostinger VPS GitHub Action，你可以直接从仓库部署你的 Docker 应用到 Hostinger VPS。每次向分支推送代码都可以触发部署，让 CI/CD 变得高效而简单。

前提条件

• 一台已安装 Docker 模板的 Hostinger VPS。
• 仓库中有一个 docker-compose.yml 文件。
• 一个 Hostinger API 密钥（在 Hostinger 控制面板中生成）。
• 你的 VPS Virtual Machine ID（VM ID，虚拟机 ID）（可在 VPS 概览页面的 URL 或默认主机名中找到）。
• （可选）用于私有仓库的 GitHub 个人访问令牌（Personal Access Token）。

设置 GitHub Secrets（密钥）和变量

1. 在 Hostinger 控制面板 → API 中生成 Hostinger API 密钥。

2. 查找 VM ID：例如 srv123456.hstgr.cloud → VM ID 为 123456。

3. 在你的 GitHub 仓库中，打开 Settings → Secrets and variables → Actions。

   • 添加密钥：HOSTINGER_API_KEY
   • （可选）添加密钥：PERSONAL_ACCESS_TOKEN
   • 添加变量：HOSTINGER_VM_ID

示例工作流（公开仓库）

name: Deploy to Hostinger

on:
push:
branches: [ main ]

jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v5

- name: Deploy to Hostinger
uses: hostinger/deploy-action@v1
with:
api-key: ${{ secrets.HOSTINGER_API_KEY }}
virtual-machine: ${{ vars.HOSTINGER_VM_ID }}

示例工作流（私有仓库，带环境变量）

name: Deploy to Hostinger

on:
push:
branches: [ main, production ]

jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v5

- name: Deploy to Hostinger
uses: hostinger/deploy-action@v1
with:
api-key: ${{ secrets.HOSTINGER_API_KEY }}
virtual-machine: ${{ vars.HOSTINGER_VM_ID }}
project-name: my-awesome-app
personal-token: ${{ secrets.PERSONAL_ACCESS_TOKEN }}
docker-compose-path: docker/docker-compose.yml
environment-variables: |
NODE_ENV=production
API_URL=https://api.example.com
DATABASE_URL=${{ secrets.DATABASE_URL }}

配置完成后，每次推送代码或创建标签都会自动将你的应用重新部署到 Hostinger VPS 上。