编写前端发布脚本

前端发版最怕的就是用户正好撞上那一瞬间白屏。用软链接做版本切换就能做到全程无感知，这篇把整套发布脚本拆开讲：它负责什么、为什么能无感知、三步发布逻辑，以及一段带路径越界校验的 bash 实现。

一、发布脚本主要负责两件事

• 保存每一个发布版本，防止新版本异常，方便回撤
  
• 用户无感知，防止发布过程中的宕机
  

二、原理：网站目录只是软链接

发布的网站目录本身只是一个软链接，把新版本前端发布上去之后，改一下软链接指向的文件夹，就完成了用户无感知发布。

三、发布逻辑就三步

• 上传 dist 文件到指定目录
  
• 把 dist 文件重命名为 日期_时间
  
• 修改软链接指向最新的 日期_时间 目录
  

四、脚本执行代码

注意：充分测试脚本后再上生产环境，禁止使用 root 账号执行脚本，强制要求切换到 deploy 用户，不认识脚本的请手动操作

deploy 用户负责创建、查看文章生成情况，项目目录按下面这套规则规划。

1. #!/usr/bin/env bash
2. set -euo pipefail
4. # ---- 仅允许 deploy 执行 ----
5. RUN_AS="$(id -un || true)"
6. if [[ "$RUN_AS" != "deploy" ]]; then
7.   echo "❌ 本脚本仅允许 deploy 用户执行。当前用户：$RUN_AS"
8.   echo "   请使用：su - deploy  或  sudo -u deploy /bin/bash $0"
9.   exit 126
10. fi
12. UI_BASE="/www/wwwroot/mes_saas/ui"
13. SRC="${UI_BASE}/upload/dist"          # 上传的 dist 整个目录
14. REL_ROOT="${UI_BASE}/admin-releases"  # 版本库
15. LINK="${UI_BASE}/admin"               # 前端软链（必须是软链）
16. VER="$(date +%Y%m%d_%H%M%S)"
17. DEST="${REL_ROOT}/${VER}"             # 版本目录
19. # 路径白名单校验
20. check_in_ui_base () {
21.   local p="$(realpath -m "$1")"
22.   local base="$(realpath -m "$UI_BASE")"
23.   [[ "$p" == "$base"* ]]
24. }
25. for p in "$SRC" "$REL_ROOT" "$LINK"; do
26.   check_in_ui_base "$p" || { echo "❌ 非法路径越界: $p"; exit 1; }
27. done
29. # 存在性检查
30. [[ -d "$SRC" ]] || { echo "❌ 未找到上传目录：$SRC"; exit 1; }
31. [[ -f "$SRC/index.html" ]] || { echo "❌ dist 下缺少 index.html"; exit 1; }
32. [[ -d "$REL_ROOT" ]] || { echo "❌ 版本库不存在：$REL_ROOT"; exit 1; }
33. [[ -L "$LINK" ]] || { echo "❌ $LINK 必须是软链"; exit 1; }
35. # 1) 将 dist 整体移动为版本目录
36. mv "$SRC" "$DEST"
38. # 2) 更新 admin 软链指向新版本
39. ln -sfn "$DEST" "$LINK"
41. echo "✅ 前端发布完成"
42. echo "   软链：$LINK -> $DEST"

复制代码

五、几个关键路径的含义

• UI_BASE="/www/wwwroot/mes_saas/ui"：站点根目录，后面所有路径校验都以它为白名单边界
  
• SRC：上传进来的 dist 整个目录，也就是 ${UI_BASE}/upload/dist
  
• REL_ROOT：版本库目录 admin-releases，每次发布在这里新建一个版本目录
  
• LINK：前端软链 ${UI_BASE}/admin，必须是软链，不能是实体目录
  
• VER：版本号取 date +%Y%m%d_%H%M%S，正好就是目录名里的 日期_时间
  

六、最容易踩的两个坑

• admin 必须是软链，脚本用 [[ -L "$LINK" ]] 强制校验，放成实体目录会直接报错退出。
  
• 路径校验先用 realpath -m 归一化再比对前缀，防止 ../../ 越界写入；生产环境务必用 deploy 用户跑。
  

软链发布是 Web 前端最省心的发版方式，真要回撤就把软链指回旧版本目录。

编辑提示：上线前先在预发跑一遍，重点确认 dist 里的 index.html 跟着 mv 一起进了版本目录，缺文件会白屏。