Vuepress自动化部署的一些优化方案

约 773 字大约 3 分钟

2026-04-20

注

查看本文前推荐先阅读【Linux】云服务器自动化部署VuePress博客（Jenkins）
查看本文后推荐再阅读Vuepress自动化部署的细节补充

在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缓冲区

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"/