宝塔面板怎么从 Git 仓库建站？克隆仓库 + Webhook 自动更新完整流程

宝塔面板支持直接用 Git 仓库建站：把 GitHub（也支持 GitLab、Gitee）仓库克隆到服务器，再配一个 Webhook，之后只要 push 代码，网站就会自动更新，不用每次手动拉取。

整个过程分两段：先用「Git 创建」把仓库克隆成网站，再配 Webhook 实现自动更新。

怎么用 Git 仓库创建网站

以 GitHub 为例，核心是三步：复制面板的 SSH Key 加到 GitHub → 复制仓库 URL → 在面板「Git 创建」里克隆。

第一步：复制宝塔面板的 SSH Key

进入面板左侧菜单【网站】→【添加站点】→【Git 创建】，复制面板生成的 SSH Key。

首次使用「Git 创建」功能时，请按提示安装 Webhook 插件。

第二步：把 SSH Key 加到 GitHub

在 GitHub 里点击【头像】→【Settings】→【SSH and GPG keys】→【New SSH key】：

• 在 Title（标题）字段填一个用于标识该密钥的名字；
• 把从宝塔面板复制的 SSH Key 粘贴到 Key 字段，保存。

第三步：准备仓库 URL 和分支名

在 GitHub 上创建一个新仓库，或直接使用已有仓库，然后复制仓库 URL（可选 HTTPS 或 SSH 方式克隆）。

同时记下分支名称（如 main），稍后创建网站时要选对分支。

第四步：在面板里创建网站并克隆仓库

回到面板【网站】→【添加站点】→【Git 创建】：

• 设置网站目录（如 /www/wwwroot/your_site），注意该目录必须为空；
• 粘贴仓库 URL（如 https://github.com/username/repository.git 或 git@github.com:username/repository.git）；
• 选择分支名称（如 main）。

确认后，网站会自动创建并克隆仓库内容。如果克隆过程报错，按屏幕提示排查——常见原因是 SSH Key 配置错误、仓库 URL 无效、分支名称错误或网络连接问题。

怎么配 Webhook 实现自动更新

配好 Webhook 后，仓库一有更新，就会触发面板执行指定脚本，把最新代码同步到网站目录。使用「Git 创建」功能时，软件商店会默认装好 Webhook 插件。

第一步：在面板里添加部署脚本

找到通过 Git 创建的网站，点击【设置】进入【Git 管理】→【仓库】，在这里添加脚本。脚本内容按你的项目来，例如：

pnpm i
pnpm run docs:build
\cp -r .vitepress/dist dist

添加完成后点击【保存】。

第二步：复制 Webhook URL

在【Git 管理】→【仓库】里，复制面板生成的 Webhook URL。

第三步：在 GitHub 仓库设置里添加 Webhook

进入 GitHub 仓库的【Settings】→【Webhooks】→【Add webhook】，填写配置：

• Payload URL：粘贴从宝塔面板复制的 Webhook URL；
• Content type：选择 application/json；
• SSL verification：如果面板没有配置 SSL，选择 Disable。

第四步：测试自动更新

添加 Webhook 后，修改仓库里的文件并 commit 到 GitHub，这次提交就会触发 Webhook 执行脚本，脚本执行结果如下：

如果网站内容没有更新，检查两处日志：宝塔面板【Git 管理】里的 Webhook 日志，以及 GitHub 仓库 Webhooks 页面的 Recent deliveries，按日志排查 Webhook 请求失败或脚本执行错误等问题。

常见问题

克隆方式和普通建站有什么区别？ 普通建站是手动上传或解压源码，Git 创建则是把仓库直接克隆到网站目录，配合 Webhook 能做到代码推送即自动部署，适合博客、文档站这类常改动的站点。

Webhook 会自动装插件吗？ 会。使用「Git 创建」功能时，软件商店会默认安装 Webhook 插件；首次使用时面板也会提示确认安装。

以上功能说明与操作步骤均以宝塔官方文档为准，入口和菜单名称可能随面板升级调整，以你面板实际显示为准。