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

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

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

宝塔官方新版本在添加站点时新增了一个 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(如  git@gitee.com:username/repository.git注仓库不能为空,可以初始化readme

  • 选择分支名称(如 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 仓库创建网站并实现自动更新” 的相关文章

[教程] WTG备份新方法——FFU镜像格式

[教程] WTG备份新方法——FFU镜像格式

FFU(Full Flash Update) 格式是一种基于扇区的磁盘镜像文件格式,默认使用快速哈夫曼压缩(Xpress-Huffman)算法压缩,在捕获和部署时会生成哈希表进行校验,并可以使用DISM修改捕获的镜像。FFU格式很适合WTG…

2021可用的百度网盘高速下载方法分享

2021可用的百度网盘高速下载方法分享

最新可用方法https://blog.bitefu.net/post/163.html方法很简单就是利用网盘直链下载助手【网盘直链下载助手】是一款免费开源获取网盘文件真实下载地址的油猴脚本,基于PCSAPI,支持Windows,Mac,Li…

贾氏鸣天鼓健耳养肾操

贾氏鸣天鼓健耳养肾操

《贾氏鸣天鼓健耳养肾操》鸣天鼓是健耳强肾治耳病的古法,贾氏越云自创的鸣天鼓健耳养肾操是在古法的基础上创建。顺序:1静坐挺胸。2双手放心脏位置的胸口,左手掌盖住右手掌。3闭目静心,深呼吸19下。4双手相互搓揉,让手掌发热。5用发热的双手手掌严…

七牛html js上传带进度条源码

七牛html js上传带进度条源码注册链接https://s.qiniu.com/uM7RJv完整代码下载:https://n802.com/f/349707-489018989-c141f6(访问密码:5036)http://www.yi…

安卓模拟器连接端口 及常用命令

下面是我总结和测试通过的:有的是搜集来的模拟器名称                     &nbs…

用apicloud 免费,简单封装一个wap手机网站成android app

用apicloud 免费,简单封装一个wap手机网站成android app

APICloud是国内较早布局低代码开发的平台之一,其发布的低代码效率工具Plus Mode,为IT项目中每个角色提供专业工具,将需求分析、产品原型、UI设计、前端开发、后端开发紧密衔接,并基于行业大数据对前置环节进行复用,最终缩减大量重复…

发表评论

访客

看不清,换一张

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