宝塔 添加git站点 克隆 Gitee 仓库创建网站并实现自动更新

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

克隆仓库并创建网站

1. 复制宝塔面板的 SSH Key 并添加到 Gitee

进入 网站 → 添加站点 → Git 创建，复制面板生成的 SSH Key。

2. 登录 Gitee 添加 SSH Key

在 Gitee 中，点击 头像 → 设置→ SSH公钥 → 添加公钥

• 输入一个 标题用于标识该密钥

• 将从宝塔面板复制的 SSH Key 粘贴到 公钥 字段中

3. 创建新仓库或选择已有仓库

在 Gitee 上创建一个新仓库，或者使用已有的仓库。

4. 复制仓库 URL

可以选择 HTTPS 或 SSH 方式克隆仓库。

5. 在宝塔面板中创建网站并克隆仓库

进入 网站 → 添加站点 → Git 创建

• 设置网站目录（如 /www/wwwroot/your_site），注意：该目录必须为空

• 粘贴仓库 URL（如  git@gitee.com:username/repository.git）注仓库不能为空，可以初始化readme

• 选择分支名称（如 master,main）

确认后，网站将自动创建并克隆仓库内容。

配置 Webhook 实现自动更新

当仓库更新时，可以通过配置 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 后，测试自动更新功能：

1. 修改仓库中的文件并提交（commit）到 Gitee

2. 提交操作会触发 Webhook 执行指定脚本

脚本执行结果：

有时候错误

fatal: detected dubious ownership in repository at '/www/wwwroot/www.domain.com' To add an exception for this directory, call

解决办法登录ssh执行一下下面的命令就行，将目录改成你自己的目录

git config --global --add safe.directory /www/wwwroot/www.domain.com

6. 如果您的宝塔用的https://ip:端口 这种形式的话，而且ssl证书用的宝塔带的自签证书的话会报错

SSLHandshakeException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

那么是因为证书在gitee上不被承认，所以要解决这个问题有几个办法

1. 关闭https直接使用http

2. 宝塔设置中绑定域名 如果还想用https的话 绑定上域名相应的证书

3. 宝塔设置中绑定ip 的正式证书，据说Let's Encrypt 也支持ip证书了不过我没试过

4. 反向代理，我用的这个办法