前沿：星启助手小程序后端部署到服务器后，后续会保持更新，那么如何在本地调试后，自动推送到服务端呢？这就引出了本次的话题。本地提交代码更新后，宝塔服务端自动同步更新，这很适合本地用codex更新代码修bug后直接同步到远端服务器的场景。方法同样适用于github，选择gitee主要是考虑到网络的连通性。🙋 用户

宝塔php项目如何初始化gitee仓库 保证多端同步

🤖 DeepSeek

在宝塔上为 PHP 项目配置 Gitee 同步，最稳妥的方案是利用 Git + WebHook 实现自动化部署。其核心思路是：本地 git push 代码到 Gitee → Gitee 自动触发 WebHook → 通知宝塔服务器 → 服务器执行脚本 git pull 拉取最新代码。

考虑到宝塔的运行用户 www 权限受限，按以下步骤操作可以避开绝大部分“拉取失败”的坑。

核心配置步骤1. 服务器端初始化：配置 www 用户权限

宝塔的 PHP 和 WebHook 脚本默认以 www 用户身份运行，需要为它生成 SSH 密钥并信任 Gitee。

• • 生成密钥：登录宝塔终端，执行以下命令，注意路径一定要指定给 www 用户。 bash

  sudo -u www ssh-keygen -t rsa -C "你的邮箱" -f /home/www/.ssh/id_rsa -N ""

• • 添加公钥：查看并复制公钥内容。 bash

  cat /home/www/.ssh/id_rsa.pub

  复制输出的内容，登录 Gitee → 点击头像进入【设置】→【安全设置】→【SSH公钥】，粘贴并添加 -2。

• • 信任主机：避免首次连接时出现 Host key verification failed 错误。 bash

  sudo -u www ssh-keyscan gitee.com >> /home/www/.ssh/known_hosts

• • 验证连通性： bash

  sudo -u www ssh -T git@gitee.com

  若出现 You’ve successfully authenticated 提示，说明配置成功 -1-2。

2. 拉取项目：建立 Git 关联

假设你的网站根目录是 /www/wwwroot/你的域名，若目录非空，建议先备份。

• • 进入网站目录并克隆代码（使用 SSH 地址，避免 https 的密码输入麻烦）： bash

  cd /www/wwwroot/你的域名sudo -u www git clone git@gitee.com:你的用户名/仓库名.git .

  (注意：命令末尾有一个点 .，表示克隆到当前目录)

• • 设置安全目录：新版 Git 有安全目录限制，运行一次即可。 bash

  sudo -u www git config --global --add safe.directory /www/wwwroot/你的域名

3. 宝塔 WebHook：配置自动拉取脚本

• • 安装插件：在宝塔【软件商店】中搜索并安装 WebHook 插件 -3-8。
• • 添加任务：点击“添加 Hook”，名称随意（如 auto_pull）。
• • 编写脚本：将下方脚本中的 /www/wwwroot/你的域名 和 你的仓库SSH地址 替换为你自己的信息。

bash

#!/bin/bashecho ""# 输出当前时间date --date='0 days ago'"+%Y-%m-%d %H:%M:%S"echo "Start deployment"# 这里是你的网站根目录gitPath="/www/wwwroot/你的域名"# 这里是你的 Gitee SSH 地址gitHttp="git@gitee.com:你的用户名/仓库名.git"echo "Web站点路径：$gitPath"if[-d "$gitPath"];then    cd $gitPath# 检查是否为git仓库if[!-d ".git"];then        echo "克隆仓库中..."        sudo -u www git clone $gitHttp .fi    echo "拉取最新代码..."# 关键：切换回 master/main 分支，并强制重置为远程最新    sudo -u www git checkout master    sudo -u www git reset --hard origin/master    sudo -u www git pull 2>&1    echo "设置目录权限"    sudo chown -R www:www $gitPath    echo "End deployment"exitelse    echo "项目路径不存在！"exitfi

注意：如果你的仓库主分支是 main，请将脚本中的 master 改为 main。

• • 获取Hook地址：保存后，点击该Hook行的“查看密钥”，复制弹出的 URL 地址（形如 http://你的服务器IP:端口/hook?access_key=xxx&param=xxx）-3-8。

4. Gitee 设置：填入 WebHook 地址

• • 登录 Gitee，进入你的仓库 → 管理 → WebHooks → 添加。
• • URL：粘贴上一步复制的宝塔 WebHook 地址。
• • 密码/密钥：留空（或填写与脚本中一致的密码，若脚本未校验可留空）。
• • 事件：勾选 Push 事件，保存即可 -2-3。

验证与调试

完成配置后，尝试在本地修改代码并 git push 推送到 Gitee。

• • 检查 Gitee：在仓库的 WebHooks 页面，查看刚才添加的 Hook，看“最近推送记录”是否显示绿色勾勾（200 OK）。
• • 检查宝塔日志：在宝塔 WebHook 插件中，找到该 Hook 并点击“日志”，查看是否有 pull success 或报错信息 -3。
• • 检查网站：访问站点确认代码已更新。

常见“坑”与解决方案

🙋 用户

不需要配置这个么

bash

git config --global user.name "Your Name"git config --global user.email "your@email.com"

🤖 DeepSeek

这是一个很好的问题！让我详细解释一下：

核心结论：不需要配置

在宝塔 WebHook 自动部署的场景下，user.name 和 user.email 不是必须配置的。

为什么不需要？1. 这些配置的作用是什么？

bash

git config --global user.name "Your Name"git config --global user.email "your@email.com"

这些配置主要用于标识 commit 的作者，当你的脚本执行 git commit 操作时才需要。也就是说本地电脑推送代码到gitee是需要的

2. WebHook 脚本只做这些操作

bash

git pull           # 拉取代码（不需要身份）git reset          # 重置版本（不需要身份）git checkout       # 切换分支（不需要身份）git clone          # 克隆仓库（需要 SSH 密钥，不是这个）

这些操作不会产生新的 commit，因此 Git 不需要知道”谁在执行拉取操作”。

3. 什么情况下才需要配置？

如果你在服务器上执行以下操作，才需要配置：

bash

# 需要在服务器上提交代码时才需要git add .git commit -m "服务器自动提交"git push

可能的混淆点

你可能看到有些教程同时配置了：

bash

git config --global user.name "xxx"git config --global user.email "xxx@xxx.com"git config --global --add safe.directory /path/to/project

这是因为：

• • **user.name/user.email**：只有在服务器会产生新提交时才需要（如：自动备份脚本、自动修复代码）
• • safe.directory：这是必须配置的，避免 Git 的安全警告
• • SSH 密钥：这是必须配置的，用于身份验证

完整的最小必要配置

对于纯拉取代码的 WebHook 场景，你只需要：

bash

# 1. SSH 密钥（必须）sudo -u www ssh-keygen -t rsa -C "your@email.com"# 2. 信任 Gitee（必须）sudo -u www ssh-keyscan gitee.com >> /home/www/.ssh/known_hosts# 3. 安全目录（必须）sudo -u www git config --global --add safe.directory /www/wwwroot/你的域名# 4. 用户信息（可选，不需要配置）# git config --global user.name "xxx"  ← 不需要# git config --global user.email "xxx" ← 不需要

特殊情况：什么时候需要配置？

如果你确实需要配置（比如将来要做自动提交），可以这样做：

bash

# 给 www 用户配置（注意路径）sudo -u www git config --global user.name "你的Gitee用户名"sudo -u www git config --global user.email "你的邮箱"# 验证配置sudo -u www git config --global --list

总结

转载请注明：小雨科技 _武汉网站建设_武汉小程序搭建 » 宝塔项目多端同步使用webhook自动拉取更新教程