Vuepress自动化部署的一些优化方案
查看本文前推荐先阅读【Linux】云服务器自动化部署VuePress博客（Jenkins）
在Jenkins上部署Vuepress时，受限于云服务器网络环境，经常出现在拉取GitHub仓库时超时的问题：
fetch-pack: unexpected disconnect while reading sideband packet
fatal: early EOF
fatal: unpack-objects failed问题核心在于Jenkins默认的Git 拉取操作超时时间为 10 分钟，超时后导致连接中断，可针对性地调整相关配置来解决。
调整超时时间
为Git操作设置一个更长的超时时间，例如 30 分钟或 60 分钟。
在源码管理 -> Additional Behaviours -> 点击新增 -> 高级的克隆行为 -> 克隆和拉取操作的超时时间（分钟） -> 填写时长 -> 保存配置并重新构建
浅克隆
如果仓库历史记录很大，可以启用浅克隆（Shallow Clone），它只拉取最近的提交历史，能极大减少下载量和时间
在源码管理 -> Additional Behaviours -> 点击新增 -> 高级的克隆行为 -> 勾选浅克隆
扩大Git缓冲区
登录Jenkins服务器，执行以下命令增大 Git 的 HTTP 缓冲区，以提升大文件传输的稳定性：
git config --global http.postBuffer 524288000 # 设置为500MB
git config --global http.lowSpeedLimit 0
git config --global http.lowSpeedTime 999999获取完整Git提交历史
当Git拉取使用浅克隆，会出现部署后的Vuepress无法获取完整的 Git 提交历史，解决此问题需要在部署任务中修改配置信息。
使用Jenkins
- 在你的
package.json文件中，添加一个prebuild脚本，并将脚本的内容设置为git fetch --unshallow || true，示例脚本内容：
"scripts": {
"docs:dev": "pnpm run wordcount && vuepress dev docs",
"docs:dev-clean": "vuepress dev docs --clean-cache --clean-temp",
"docs:build": "pnpm run wordcount && vuepress build docs --clean-cache --clean-temp",
"docs:preview": "http-server docs/.vuepress/dist",
"vp-update": "pnpm dlx vp-update",
"prebuild": "git fetch --unshallow || true",
},- 修改Jenkins
Build Steps->执行Shell中的脚本，在build之前添加prebuild脚本，示例：
export PATH="/usr/local/bin:$PATH"
pnpm install
pnpm prebuild
pnpm docs:build
TARGET_DIR="/opt/1panel/www/sites/davidblackcn.cc/index"
# 直接操作，无需 sudo
rm -rf "$TARGET_DIR"/*
cp -R docs/.vuepress/dist/* "$TARGET_DIR"/更新日志
2026/4/20 18:37
查看所有更新日志
81950-更新Blog于