当前位置:首页 > 技术分享

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

admin3周前 (12-29)技术分享68

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


克隆仓库并创建网站

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

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

复制 SSH Key

注意

首次使用请按照提示安装 Webhook 插件。

2. 登录 Gitee 添加 SSH Key

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

ScreenShot_2025-12-29_103456_801.png


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

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

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

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

4. 复制仓库 URL

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

注意

记下您需要的 分支名称(如 master,main),稍后创建网站时需要选择正确的分支。


ScreenShot_2025-12-29_103624_478.png

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

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

  • 设置网站目录(如 /www/wwwroot/your_site),注意:该目录必须为空

  • 粘贴仓库 URL(如 https://gitee.com/username/repository.git 或 git@gitee.com:username/repository.git

  • 选择分支名称(如 master,main

Git 创建网站

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

故障排查

如果克隆过程中出现错误,请根据屏幕提示排查问题(如 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 管理 → 仓库

复制 Webhook URL

4. 在 Gitee 仓库设置中添加 Webhook

进入 Gitee 仓库的 设置 → Webhooks → 添加webhook

ScreenShot_2025-12-29_103956_843.png

填写 Webhook 配置:

  • URL:粘贴从宝塔面板复制的 Webhook URL

  • 其它可不填也可以随便填

ScreenShot_2025-12-29_104015_578.png

5. 测试 Webhook 自动更新功能

添加 Webhook 后,测试自动更新功能:

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

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

脚本执行结果:

脚本执行结果

故障排查

如果网站内容未更新,请检查:

  • 宝塔面板 Git 管理中的 Webhook 日志

  • Gitee 仓库 Webhooks 页面的 WebHooks 管理

根据日志信息排查问题(如 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. 反向代理,我用的这个办法

    ScreenShot_2025-12-29_104858_095.png


扫描二维码推送至手机访问。

版权声明:本文由小刚刚技术博客发布,如需转载请注明出处。

本文链接:https://blog.bitefu.net/post/711.html

分享给朋友:

“宝塔 添加git站点 克隆 Gitee 仓库创建网站并实现自动更新” 的相关文章

关于微信第三方平台(全网发布检测)检测流程以及踩到的坑

关于微信第三方平台(全网发布检测)检测流程以及踩到的坑

能点到全网发布这一步,说明你已经弄好了获取component_verify_ticket,component_access_token等这些参数,通常这个时候点击全网发布只会有这两个失败。如果其他失败的那就要好好检查一下你的代码了,或者查看…

centos 配置Let's Encrypt 泛域名https证书

centos 配置Let's Encrypt 泛域名https证书

前言2018年1月份Letsencrypt可以申请泛域名证书,这让我们部署多域名、多站点https省了很多功夫,终于可以不用维护多个域名的https证书。笔者以acme.sh为例,手把手教你配置https证书~本教程适用于centos 6.…

系统小技巧:微软版“Ghost” Windows FFU 系统安装还原

系统小技巧:微软版“Ghost” Windows FFU 系统安装还原

在日常的维护中,系统的备份和还原是大家经常需要操作的事情。虽然Windows 10已经提供很多的工具,如系统还原、WIM备份/还原,VHD备份等。不过这些工具大多是基于文件的备份/还原。我们以前经常的使用的Ghost则是基于扇区的备份/还原…

PHP和Redis实现在高并发下的抢购及秒杀功能

抢购、秒杀是平常很常见的场景,面试的时候面试官也经常会问到,比如问你淘宝中的抢购秒杀是怎么实现的等等。抢购、秒杀实现很简单,但是有些问题需要解决,主要针对两个问题:一、高并发对数据库产生的压力二、竞争状态下如何解决库存的正确减少("…

在CentOS 5.x 6.x里使用yum源 换阿里云国内源换vault.centos.org源

阿里云CentOS 5 的系统,无法用yum来安装应用软件。  原因:CentOS 5 在2017-03-31日已经结束支持,不再提供维护更新,所以包括阿里云镜像站的文件可能都是过时或已经有部分文件缺失。 &n…

python调用WinRAR暴力获取压缩密码 用网址做解压密码

原理很简单:python通过调用WinRAR.exe暴力获取压缩密码,要求必须安装WinRAR或者有WinRAR.exe这个文件(单个文件就行)。个人实测zip和rar格式都能用。缺点:费时间,费cpu一、不生成密码本:4位全数字密码:im…

发表评论

访客

看不清,换一张

◎欢迎参与讨论,请在这里发表您的看法和观点。