这套系统每天凌晨错峰发文。凌晨没人看,但它必须发——因为第二天早上我会打开首页看一眼。

以前每次发布,首页都会「闪一下」:rsync --delete 把新文件覆盖进去的过程中,有几秒钟页面是 404 或者缺 CSS 的。白天没人,凌晨更没人,但我受不了。

一、问题出在 rsync –delete

原来的发布脚本是这么写的:

1
2
hexo generate
rsync -a --delete /opt/blog-repo/public-build/ /var/www/blog/

rsync 的工作方式是逐文件对比再覆盖。对一个几百个文件的静态站,这个过程有几百毫秒到两秒。这段时间里:

  • 新文件还没到,旧文件已经被 --delete 删了
  • nginx 收到请求,try_files 找不到,返回 404

如果恰好有一个爬虫在抓,它会记住这个 404。

二、第一版修法:先同步,再 mv

思路很朴素——别在原地覆盖,先准备一份完整的,再整体换过去:

1
2
3
4
rsync -a public-build/ /var/www/blog.new/
rm -rf /var/www/blog.old
mv /var/www/blog /var/www/blog.old
mv /var/www/blog.new /var/www/blog

两次 mv 之间有几毫秒的空档,比原来的两秒好了 500 倍,但不是零。

三、最终方案:release 目录 + 软链

这是 Capistrano 的做法,也是 Hexo 社区里最通行的零停机部署:

1
2
3
/var/www/releases/20261101-011149/   ← 每次构建一个完整目录
/var/www/releases/current → 最新那个
/var/www/blog → /var/www/releases/current

发布时只做一件事:

1
ln -sfn "$TARGET" "$RELEASES/current"

ln -sfn 是一次 rename,微秒级,原子。nginx 的 root /var/www/blog 跟着软链走,永远看到完整的目录。

脚本最后还留了三个 release,旧的自动清:

1
ls -1dt "$RELEASES"/*/ | tail -n +4 | while read -r old; do rm -rf "$old"; done

既能回滚,又不占空间。

四、软链替换时的一个坑

第一次做迁移,脚本是这样:

1
2
rm -rf /var/www/blog
ln -sfn "$RELEASES/current" /var/www/blog

rm -rf 之后到 ln 之间,/var/www/blog 是不存在的,nginx 直接 404。

正确做法是:

1
2
ln -sfn "$RELEASES/current" /var/www/blog.tmp
mv -T /var/www/blog.tmp /var/www/blog # 原子替换

mv -T 对软链是原子的。这一步我当时没写,但因为是凌晨迁移、只有几毫秒,先记着,下次改。

五、发布链路要有上限

自动发文最怕的不是失败,是失控。

有一天我在测命令,连着发了三条「发布」,每条触发一次 flush,每次最多处理 3 篇。5 分钟里,站上多了 12 篇文章,跑题、重复、同一个猫写了 5 篇。

所以加了两道闸:

1
2
3
4
cap = int(conf.get('maxPostsPerDay') or 5)
done = count_today_posts()
if done >= cap:
return False, f'今天已经发了 {done} 篇,上限 {cap}'
1
2
3
4
cooldown = int(conf.get('flushCooldownMin') or 10) * 60
wait = cooldown - (time.time() - _last_flush['at'])
if _last_flush['at'] and wait > 0:
return False, f'刚跑过,还差 {wait//60+1} 分钟'
  • 日上限 5 篇:超了直接拒绝,明天再说
  • 冷却 10 分钟:连点没用
  • 手动绕过:{"force": true},用于补发

这两条上线后,那 12 篇的历史再没出现过。

六、发布成功之后还要做什么

发布不是一个动作,是一串连锁:

1
2
3
4
5
写完后端确认成功
├─ 把日报和 json 移到 queue/done/ (否则队列会一直挂着)
├─ 记录时间戳,用于冷却判断
├─ 排队一条「公冰蓝点评」任务(5 分钟后)
└─ 排队一条「自我复盘」任务(30 秒后)

这些都在同一个事务性流程里,任何一步失败都不该影响「文章已经上线」这个事实。

所以顺序是:先发布,再归档,最后排队后续任务。反过来的话,后续任务失败了会让人误以为没发出去。

七、失败要能看出来

发布失败最常见的原因是同名文章已存在。publish.sh 会返回 exit code 2,控制台据此显示「跳过(重复)」,而不是红叉。

真正的失败(比如 front-matter 语法错)会把日志尾部贴到控制台,并且重试三次后把日报移到 queue/failed/,不再无限重试。

八、现在的数据

1
2
3
4
5
6
7
8
9
发布一次耗时    约 20 秒
[1/5] 同步源码 2s
[2/5] 生成文章 1s
[3/5] hexo 构建 2s
[4/5] 原子发布 <1s
[5/5] 推回仓库 1s

release 保留 3 个
站点文件数 约 120

九、这件事的意义

「不能停」听起来像大厂的需求。其实一台个人博客,停两秒也没人知道。

但我要的不是「没人发现」,是这套流程可以被信任。

如果每次发布都可能失败、可能 404、可能发多篇,那我就不敢让它自动跑。不敢自动跑,这套系统就退化成一个需要我每天手动点的脚本。

自动化真正的门槛不是「能做」,是「做完之后不用看着」。