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

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

admin2个月前 (12-29)技术分享139

宝塔官方新版本在添加站点时新增了一个 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
分享给朋友:

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

【不忘初心】19041/19042/19043(20H1,20H2,21H1)告别繁琐 一键替换太阳谷图标 一键恢复原版图标 一键恢复文件夹预览

【不忘初心】19041/19042/19043(20H1,20H2,21H1)告别繁琐 一键替换太阳谷图标 一键恢复原版图标 一键恢复文件夹预览

一键替换太阳谷图标,一键恢复原版图标,注意是一键!!!  太阳谷图标确实很好看,很新颖 !论坛也有相关替换教程,有的需要改权限,有的需要PE下替换,有的还得重启,搞不好很容易翻车,有些小白同学只能望梅止渴,今天以上统统告…

python 高速处理分析超大网站日志文件 带进度条手动输入日志文件

 python 高速处理分析超大网站日志文件 带进度条手动输入日志文件    1 统计本日志文件的总pv、uv    2 列出全天每小时的pv、uv数    3 列出to…

[教程福利] Python 全网比较全面的资源

阿里 Python 应该算比较全面了,编辑完了差不多用了三个小时左右,如果对你有帮助,给个免费的热心吗,在这里谢谢了各位大佬。092-****实战课-畅销3年的Python分布式爬虫课程-原版提取https://www.aliyundriv…

​CentOS 安装libsodium 支持 crypto_aead_aes256gcm_decrypt 兼容php5.6,php7.2

微信小微商户下载证书返回的密文用 AEAD_AES_256_GCM 算法 解密的方法。其中用到了 string sodium_crypto_aead_aes256gcm_decrypt ( string $ci…

Windows下SVN自动更新

Windows下SVN自动更新

1、创建post-commit.bat文件,放到C:\Repositories\pms\hooks文件夹下(注意不要先创建txt文件然后改后缀,pms为代码目录名),内容如下:@echo off "C:\Tortois…

对比 Git 与 SVN,这篇讲的很易懂

对比 Git 与 SVN,这篇讲的很易懂

导语本文从 Git 与 SVN 的对比入手,介绍如何通过 Git-SVN 开始使用 Git,并总结平时工作高频率使用到的 Git 常用命令。一、Git vs SVNGit 和 SVN 孰优孰好,每个人有不同的体验。Git是分布式的,SVN是…

发表评论

访客

看不清,换一张

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