ram-altman如何保证每天只发一封邮件?cron调度、flock锁与失败重试完全解析
ram-altman如何保证每天只发一封邮件?cron调度、flock锁与失败重试完全解析
ram-altman 是一个有趣的 Linux 监控脚本:它会定时检测你的电脑还剩多少可用内存(RAM),一旦空闲内存超过阈值,就自动给 OpenAI 的 CEO Sam Altman 发一封"投诉邮件"。更巧妙的是——每封邮件最多每天发送一次。它是怎么做到的?答案藏在三样东西里:cron 调度、flock 文件锁,以及一个"先发送、后记账"的失败重试设计。本文将带你完整拆解这套机制,新手也能看懂。
ram-altman 是什么?
先了解一下背景:Sam Altman 曾公开吐槽"个人电脑里闲置着一大堆 DRAM,从全球分配角度看简直是太糟糕了"。这个项目就是带着幽默感给出的回应:
- 📊 每 5 分钟采样一次内存使用情况,记录到 CSV
- ✉️ 当可用内存超过 10% 时,给指定收件人发一封措辞各异的邮件
- 🛡️ 保证每天最多一封,绝不轰炸收件箱
项目只有一个脚本 ram-altman.sh,外加一个测试脚本 test-ram-altman.sh,纯 bash 编写,没有任何依赖。
第一步:cron 调度每 5 分钟触发一次
ram-altman 自己不常驻运行,它依赖系统的 cron 定时任务来反复唤起自己。在 ram-altman.sh 的头部注释里就写明了推荐配置:
*/5 * * * * /path/to/ram-altman.sh
*/5 表示"每 5 分钟执行一次"。每天约 288 次触发——听起来会发 288 封邮件?当然不会。这正是后面几道"闸门"要解决的问题。
配合环境变量即可完成完整配置(详见 README.md):
RAM_ALTMAN_TO=recipient@example.com
RAM_ALTMAN_FROM=you@example.com
*/5 * * * * /path/to/ram-altman.sh
三道闸门:每天只发一封邮件的核心
main 函数的执行流程是"层层过滤":每次被 cron 唤醒后,脚本依次通过三道检查,全部通过才会真正发邮件。
闸门一:flock 文件锁,拒绝重复运行
第一道防线在 ram-altman.sh:
# Stop overlapping runs from both sending today's email.
if command -v flock > /dev/null; then
exec 9> "$STATE_DIR/lock"
flock -n 9 || exit 0
fi
这里用 flock -n(non-blocking,非阻塞模式)对状态目录下的 lock 文件加排他锁:
- 如果另一个实例正在运行,
flock -n会立即失败,新进程直接exit 0安静退出 - 这防止了两个进程同时通过日期检查、同时发邮件的"竞态条件"
新手常问:脚本明明 5 秒就跑完了,为什么还需要锁?因为如果某次运行卡在发信环节(比如网络慢),下一次 cron 触发时可能撞上尾巴。flock 是最省心的防并发手段,三行代码解决。
闸门二:阈值过滤,内存不够闲就不发
锁之后先采样内存,再判断是否"足够闲置"。判定逻辑在 ram-altman.sh:
is_over_threshold() {
(( available_kb * 100 > THRESHOLD_PCT * total_kb ))
}
默认阈值是 10%(可用内存占比)。注意是严格的"大于"——恰好 10% 不算超过,测试脚本 test-ram-altman.sh 里专门验证了这条边界:
exactly 10%: no email # 恰好 10%,不发
just over 10%: email sent # 多 1 kB,就发
内存不够闲?直接 exit 0,连邮件模板都不会加载。
闸门三:last_sent 日期标记,一天只记一笔
这是"每天一封"最核心的一步,代码在 ram-altman.sh:
local today last_sent
today=$(date +%F)
last_sent=$(cat "$LAST_SENT_FILE" 2>/dev/null || true)
[[ "$last_sent" != "$today" ]] || exit 0
逻辑简单粗暴但非常有效:
- 状态目录下的
last_sent文件保存着上次成功发信的那天日期 - 本次日期和它一样?说明今天已经发过了,直接退出
- 不一样(或文件不存在)?才允许继续往下走发信
状态目录默认在 ~/.local/state/ram-altman(可用 RAM_ALTMAN_STATE_DIR 环境变量覆盖),里面有三个文件:
| 文件 | 作用 |
|---|---|
usage.csv |
每次采样的内存数据(超过 10 MiB 自动裁剪,见 ram-altman.sh) |
last_sent |
上次发信日期,"一天一封"的账本 |
lock + bag_* |
flock 锁文件、邮件文案随机抽签用的"袋子" |
失败重试:先发送,成功后才记账
最精妙的设计在最后两步,ram-altman.sh:
compose_email
send_email || die "email failed to send; will try again on the next run"
# Recorded only after a successful send, so a failure gets retried.
echo "$today" > "$LAST_SENT_FILE"
顺序是关键:先发信,成功后才写入 last_sent。
- 如果
sendmail/msmtp/mail全部不可用或发送失败,send_email返回非零,die让脚本以错误码退出(见 ram-altman.sh) - 此时
last_sent没有更新,明天之前的任何一次 cron 触发(5 分钟后)都会重新走一遍流程,再次尝试发送 - 发送成功,日期落盘——今天到此为止
这就是"延迟到成功才记录"(write-on-success)模式,是构建可靠定时任务时的通用技巧:失败不记账,成功才记账,重试自然发生。测试脚本 test-ram-altman.sh 用一个会故意失败 75 的假 sendmail 完整验证了这条链路。
发信与防刷屏的小细节
- 发信通道自动降级:优先
sendmail,其次msmtp,最后mail,都没有才报错(ram-altman.sh) - cron 的 PATH 问题:cron 环境里常常找不到
/usr/sbin下的sendmail,脚本在开头主动补全了 PATH(ram-altman.sh),这是 cron 新手最常踩的坑之一 - 邮件不重样:8 个主题、10 段正文、6 个落款通过"随机抽签袋"轮换——先随机洗好整副牌,抽完一轮才重新洗牌,保证不连续重复(ram-altman.sh)
- 严格模式:
set -euo pipefail确保任何命令出错都立即中止,避免半拉子状态(ram-altman.sh)
快速上手:三步体验
git clone https://gitcode.com/gh_mirrors/ra/ram-altman
cd ram-altman
chmod +x ram-altman.sh test-ram-altman.sh
然后先体验两个"安全模式":
./ram-altman.sh --status # 查看本机内存详情
./ram-altman.sh --dry-run # 预览会发出的邮件(不真发)
确认无误后,把环境变量和 */5 * * * * 一行加入 crontab -e,就大功告成。想跑测试看看 14 个断言是否全绿?执行 ./test-ram-altman.sh 即可,它全程使用模拟内存和假 sendmail,不会打扰任何真实收件箱(test-ram-altman.sh)。
总结:一张表看懂"每天一封"
| 层级 | 机制 | 挡掉了什么 |
|---|---|---|
| 调度层 | cron */5 * * * * |
提供高频采样,又天然低占用 |
| 并发层 | flock -n 文件锁 |
两个实例同时运行 |
| 业务层 | 可用内存 > 10% 阈值 | 机器正忙时的无意义发信 |
| 状态层 | last_sent 日期比对 |
当天第二、第三……第 N 次触发 |
| 可靠层 | 成功才写日期 | 发送失败导致的"当天漏发" |
ram-altman 证明了:一个不到 300 行的 bash 脚本,靠 cron 调度 + flock 锁 + 成功记账,就能把"高频触发、低频发送"这件事做得严丝合缝。这套模式——高频唤醒、多重闸门、失败自动重试——同样适用于任何你想写的定时提醒或监控脚本,值得收藏借鉴。📬