Hostinger Git部署完整教程（2026深度版）

还在用FTP上传文件部署网站？太落伍了。Git部署是现代开发的标配——代码提交到GitHub后自动部署到服务器，省时省力还不容易出错。Hostinger支持Git部署吗？答案是：支持，而且功能相当完善。本文详解三种Git部署方式，从最简单的GitHub一键部署到高级的CI/CD流水线。

一、Hostinger Git部署方式概览

根据Hostinger Git官方文档，Hostinger提供三种Git部署方式，适合不同场景：

部署方式支持平台自动部署构建步骤适合项目
GitHub Auto-DeployGitHub支持（push触发）不支持PHP项目、静态网站、WordPress自定义代码
SSH Git部署GitHub/GitLab/Bitbucket等支持（webhook）不支持通用Git仓库部署
Node.js GitHub集成GitHub支持支持（npm install + build）Next.js/Nuxt/Vue/React等Node.js项目

1.1 核心限制

需要注意的是：通用Git部署功能（前两种）只复制文件，不运行构建步骤。也就是说，仓库里有什么文件，就部署什么文件。如果你的项目需要npm install、npm run build等构建步骤，有两个选择：

  1. 使用Node.js专属GitHub集成（支持自动构建，但只支持Node.js应用）
  2. 本地先构建好，把构建产物提交到Git仓库，再用通用Git部署

二、GitHub Auto-Deploy（最简单的方式）

如果你的代码在GitHub上，这是最简单的部署方式。通过Hostinger GitHub App授权，一键完成配置。

2.1 适用场景

  • 静态HTML/CSS网站
  • PHP项目（原生PHP、CodeIgniter、Laravel等）
  • WordPress自定义主题/插件开发
  • 代码不需要构建步骤的项目

2.2 配置步骤

  1. 登录hPanel，进入Websites → 目标网站 → Dashboard
  2. 左侧菜单找到Advanced → Git
  3. 点击Connect with GitHub按钮
  4. 跳转到GitHub，安装Hostinger GitHub App
    • 选择授权的GitHub账号（个人或组织）
    • 选择要授权的仓库（All repositories或指定仓库）
    • 点击Install & Authorize
  5. 授权完成后跳回hPanel，选择要部署的仓库
  6. 配置部署设置：
    • Branch：选择触发部署的分支（通常是main或master）
    • Deploy directory：部署目标目录，默认是public_html，也可以设为子目录如public_html/blog
  7. 点击Deploy进行首次部署
  8. 等待部署完成，可以看到实时部署日志

2.3 自动部署如何工作

配置完成后，每次你push代码到指定分支，GitHub会通过webhook通知Hostinger，Hostinger自动拉取最新代码并部署。整个过程通常只需要几秒到几十秒（取决于代码量）。

部署规则：

  • 只有指定分支的push才会触发部署
  • 部署会覆盖目标目录中的文件
  • .gitignore中的文件不会被部署
  • 已删除的文件也会从服务器删除（保持与仓库一致）

三、SSH Git部署（通用方式）

如果你的代码不在GitHub（比如GitLab、Bitbucket、Gitee等），或者你需要更多控制权，可以使用SSH方式部署。

3.1 适用场景

  • GitLab、Bitbucket、Gitee等非GitHub平台
  • 私有Git仓库（自建Git服务器）
  • 需要自定义部署流程
  • 同时管理多个Git仓库

3.2 配置步骤

第一步：生成SSH密钥

  1. hPanel → Websites → Dashboard → Advanced → Git
  2. 点击Generate SSH Key或添加SSH密钥
  3. 复制生成的公钥（public key）

第二步：在Git平台添加部署密钥

以GitLab为例：

  1. 进入GitLab仓库 → Settings → Repository → Deploy Keys
  2. 点击Add key
  3. 粘贴Hostinger的SSH公钥
  4. 填写标题（如"Hostinger Deployment Key"）
  5. 勾选写权限（如果需要push的话，部署只需读权限）
  6. 点击Add key

Bitbucket：Repository settings → Access keys → Add key
GitHub：Settings → Deploy keys → Add deploy key

第三步：添加Git仓库

  1. 回到Hostinger Git页面
  2. 点击Add Repository或手动添加仓库
  3. 填写仓库信息：
    • Repository URL：SSH格式的仓库地址，如git@gitlab.com:username/repo.git
    • Branch：要部署的分支
    • Deploy directory：部署目标目录（默认public_html）
  4. 点击添加

第四步：手动部署测试

  1. 在仓库列表中找到刚添加的仓库
  2. 点击Actions → Deploy
  3. 查看部署日志，确认部署成功
  4. 访问网站确认文件已更新

3.3 配置自动部署（Webhook）

SSH方式默认是手动部署的。要实现push后自动部署，需要配置webhook：

  1. 在Hostinger Git页面，找到你的仓库
  2. 点击Actions → Auto Deployment
  3. 复制Webhook URL
  4. 到你的Git平台添加webhook：
    • GitLab：Settings → Webhooks → Add new webhook → 粘贴URL → Trigger选Push events
    • Bitbucket：Repository settings → Webhooks → Add webhook
    • GitHub：Settings → Webhooks → Add webhook
  5. Content type选择application/json
  6. 保存webhook

配置完成后，每次push到指定分支，Git平台会调用webhook URL，触发Hostinger自动拉取最新代码。

四、Node.js GitHub集成（支持自动构建）

如果你开发的是Node.js应用（Next.js、Nuxt、React、Vue等），通用Git部署不够用，因为需要npm install和构建步骤。Hostinger提供了Node.js专属的GitHub集成。

4.1 功能特点

  • 每次push自动执行npm install安装依赖
  • 自动运行构建命令（如npm run build）
  • 自动启动或重启Node.js应用
  • 支持框架自动检测（Next.js、Nuxt、Vite等）
  • 支持环境变量配置

4.2 配置步骤

  1. hPanel → Websites → Add Website
  2. 选择Node.js web app
  3. 选择Import Git repository
  4. 点击Connect with GitHub，安装Hostinger GitHub App
  5. 选择你的Node.js项目仓库
  6. 配置部署设置：
    • Framework preset：从package.json自动检测，也可手动选择
    • Branch：触发部署的分支
    • Node.js version：选择Node.js版本（18/20/22/24）
    • Root directory：应用根目录（支持monorepo子目录）
    • Build command：构建命令，如npm run build
    • Output directory：构建输出目录，如.next、dist
    • Entry file：应用入口文件
  7. 点击Deploy开始首次构建和部署
  8. 查看构建日志，确认成功

4.3 支持的Node.js版本

版本状态推荐场景
Node.js 18LTS（旧版）老项目兼容
Node.js 20LTS（当前）推荐，稳定
Node.js 22Current/新版需要新特性的项目
Node.js 24最新版尝鲜，不建议生产环境

五、VPS上的Git部署

如果你用的是Hostinger VPS，Git部署的自由度更高，但需要自己配置。

5.1 VPS Git部署方式

  • SSH直接部署：SSH登录VPS，git clone/pull代码
  • Git Hooks：配置post-receive hook，push后自动部署
  • CI/CD工具：GitHub Actions、GitLab CI、Jenkins等
  • Docker部署：如果用Docker，可以配置镜像自动拉取

5.2 VPS vs 共享主机的Git部署对比

对比项共享主机VPS
配置难度简单，hPanel图形界面需要SSH和命令行
构建步骤仅Node.js集成支持完全自定义，任何语言都可以
自定义程度有限完全自由
Docker支持不支持支持
CI/CD集成基础webhook完整CI/CD流水线
适合人群初学者、PHP/静态站开发者、复杂项目

六、CI/CD集成方案

6.1 官方GitHub集成 vs GitHub Actions

很多人问Hostinger支不支持GitHub Actions。答案是：

  • Hostinger官方没有内置GitHub Actions集成
  • 但你可以用GitHub Actions + FTP/SSH部署的第三方方案
  • 对于Node.js项目，官方的GitHub集成已经够用了

6.2 GitHub Actions + FTP部署方案

如果你需要完整的CI/CD流水线（运行测试、lint检查、构建、部署），可以用GitHub Actions：

  1. 在GitHub仓库中创建.github/workflows/deploy.yml文件
  2. 配置工作流：代码push后运行测试 → 构建项目 → 通过FTP部署到Hostinger
  3. 使用SamKirkland/FTP-Deploy-Action等社区Action
  4. 在GitHub Secrets中配置FTP账号密码

适用场景：

  • 需要运行自动化测试
  • 需要代码质量检查（ESLint、Prettier等）
  • 多环境部署（测试环境、预发布环境、生产环境）
  • 复杂的构建流程

注意：这是第三方方案，不是Hostinger官方支持的功能。部署速度和稳定性取决于FTP连接质量。

6.3 什么时候需要CI/CD

项目类型推荐方案原因
简单静态站/博客GitHub Auto-Deploy简单够用
PHP项目GitHub Auto-Deploy + 手动测试PHP不需要构建步骤
React/Vue单页应用本地构建后提交dist + Git部署构建产物小，部署快
Next.js/Nuxt SSR应用Node.js GitHub集成官方支持自动构建运行
团队协作项目GitHub Actions + 多环境部署需要测试和代码审查流程
大型企业项目VPS + 自建CI/CD完全可控，支持复杂流程

七、Git部署最佳实践

7.1 部署目录建议

  • 不要部署到public_html根目录如果你的仓库包含源码、配置文件等敏感内容
  • PHP框架（如Laravel）：部署到上级目录，public目录作为public_html
  • 静态网站：直接部署到public_html没问题
  • WordPress主题：部署到wp-content/themes/your-theme

7.2 安全注意事项

  • 包含敏感信息的文件（.env、配置文件）不要提交到Git，用.gitignore排除
  • SSH密钥妥善保管，不要泄露私钥
  • 生产环境使用部署密钥（deploy key），给只读权限
  • 定期轮换SSH密钥
  • 开启分支保护，防止误操作部署到生产环境

7.3 部署故障排查

问题可能原因解决方法
部署失败SSH密钥错误、仓库地址错误检查密钥和URL是否正确
自动部署不触发webhook配置错误、分支不对检查webhook设置和触发分支
文件没有更新部署目录不对、缓存未清确认部署路径，清除CDN和服务器缓存
权限错误部署的文件权限不对检查文件权限设置
Node.js构建失败依赖问题、构建命令错误查看构建日志，检查package.json

八、常见问题

Q1：所有Hostinger套餐都支持Git部署吗？

是的，共享主机（Web系列）和Cloud主机都支持Git部署功能。具体以hPanel中是否有Git选项为准。

Q2：Git部署支持私有仓库吗？

支持。GitHub Auto-Deploy通过GitHub App授权访问私有仓库。SSH方式通过部署密钥访问私有仓库。

Q3：可以部署到子目录吗？

可以。在部署设置中指定Deploy directory为子目录路径，如public_html/blog或public_html/dev。

Q4：支持Git LFS吗？

官方文档未明确说明Git LFS支持情况。对于大文件，建议不要放在Git仓库中，使用专门的存储服务（如云存储、CDN）。

Q5：可以回滚到之前的版本吗？

通用Git部署不直接支持一键回滚。但你可以在Git中revert到之前的commit然后push，就会自动部署旧版本。或者使用备份恢复。

Q6：一个网站可以连接多个Git仓库吗？

可以。你可以添加多个Git仓库，每个部署到不同的目录。比如一个仓库部署主站，另一个部署博客子目录。

延伸阅读

总结

Hostinger Git部署核心要点：

  1. 三种部署方式：GitHub Auto-Deploy（最简单）、SSH Git部署（最通用）、Node.js集成（支持构建）
  2. 通用Git部署不运行构建步骤，Node.js项目用专属集成
  3. 自动部署：GitHub方式开箱即用，SSH方式需配置webhook
  4. 安全第一：敏感文件不要提交Git，使用部署密钥，开启分支保护
  5. 复杂项目用CI/CD：GitHub Actions + FTP部署方案可实现完整流水线
  6. VPS自由度更高：完全自定义部署流程，但技术要求也更高

用Git部署告别FTP上传，让开发更高效。立即体验Hostinger：前往Hostinger官网。