宝塔 添加git站点 克隆 Gitee 仓库创建网站并实现自动更新
宝塔官方新版本在添加站点时新增了一个 Git部署 的功能,官方以GitHub 为例 这个仓库我用的少,我都是用的gitee,我参考官方写一下我用gitee部署的方法步骤,介绍如何在宝塔面板中克隆 Gitee 仓库创建网站,并配置 Webhook 实现仓库更新时自动同步网站内容。
克隆仓库并创建网站
1. 复制宝塔面板的 SSH Key 并添加到 Gitee
进入 网站 → 添加站点 → Git 创建,复制面板生成的 SSH Key。

首次使用请按照提示安装 Webhook 插件。
2. 登录 Gitee 添加 SSH Key
在 Gitee 中,点击 头像 → 设置→ SSH公钥 → 添加公钥

输入一个 标题用于标识该密钥
将从宝塔面板复制的 SSH Key 粘贴到
公钥字段中
3. 创建新仓库或选择已有仓库
在 Gitee 上创建一个新仓库,或者使用已有的仓库。
4. 复制仓库 URL
可以选择 HTTPS 或 SSH 方式克隆仓库。
记下您需要的 分支名称(如 master,main),稍后创建网站时需要选择正确的分支。

5. 在宝塔面板中创建网站并克隆仓库
进入 网站 → 添加站点 → Git 创建
设置网站目录(如
/www/wwwroot/your_site),注意:该目录必须为空粘贴仓库 URL(如
https://gitee.com/username/repository.git或git@gitee.com:username/repository.git)选择分支名称(如 master,main)

确认后,网站将自动创建并克隆仓库内容。
如果克隆过程中出现错误,请根据屏幕提示排查问题(如 SSH Key 配置错误、仓库 URL 无效、分支名称错误、网络连接问题等)。
配置 Webhook 实现自动更新
当仓库更新时,可以通过配置 Webhook 触发指定脚本执行,自动将最新代码同步到网站目录,实现网站自动更新。
使用 Git 创建 功能会默认在软件商店安装 Webhook 插件。
1. 在宝塔面板中添加部署脚本
找到通过 Git 创建的网站,点击 设置 进入 Git 管理,然后在 仓库 中添加脚本。
Git 管理 → 仓库
输入脚本内容,例如:下面演示,注意:一般静态,php网站可以不填,空着就行,如果您的程序确实需要可以按实际添加,
pnpm i pnpm run docs:build \cp -r .vitepress/dist dist

添加完成后,点击 保存。
2. 复制 Webhook URL
Git 管理 → 仓库

4. 在 Gitee 仓库设置中添加 Webhook
进入 Gitee 仓库的 设置 → Webhooks → 添加webhook

填写 Webhook 配置:
URL:粘贴从宝塔面板复制的 Webhook URL
其它可不填也可以随便填

5. 测试 Webhook 自动更新功能
添加 Webhook 后,测试自动更新功能:
修改仓库中的文件并提交(commit)到 Gitee
提交操作会触发 Webhook 执行指定脚本
脚本执行结果:

如果网站内容未更新,请检查:
宝塔面板 Git 管理中的 Webhook 日志
Gitee 仓库 Webhooks 页面的 WebHooks 管理
根据日志信息排查问题(如 Webhook 请求失败、脚本执行错误等)。
6. 如果您的宝塔用的https://ip:端口 这种形式的话,而且ssl证书用的宝塔带的自签证书的话会报错
SSLHandshakeException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
那么是因为证书在gitee上不被承认,所以要解决这个问题有几个办法
关闭https直接使用http
宝塔设置中绑定域名 如果还想用https的话 绑定上域名相应的证书
宝塔设置中绑定ip 的正式证书,据说Let's Encrypt 也支持ip证书了不过我没试过
反向代理,我用的这个办法




