静态资源交给 Cloudflare 边缘缓存(下载提速 41 倍)

实测基线:
  ykxmz-setup-1.8.1.exe   只下到 237568/15067199 字节就停(17 KB/s)
  ykxmz-watch-1.8.1.apk   201523 字节 / 66.8 秒 = 3 KB/s
  ykxmz-server-1.8.1.zip  214900 字节 / 3.1 秒  = 67 KB/s

原因:relay 给所有响应都发 Cache-Control: no-store,
Cloudflare 完全不缓存 —— 每次下载/每张图都要穿隧道回 4G 源站。

改动:
  /download/*   no-store -> public, max-age=604800, immutable
                文件名带版本号,同一名字内容永不改变,可以长缓存
  /             -> public, max-age=60(挡住刷新重复回源)
  /favicon.ico  已是 max-age=86400,保持不变
  /shot/*       已是 max-age=86400,保持不变
  /v1/*         保持 no-store(接口必须实时)

顺带修两个自己踩的坑:

1. _send() 无条件先发 no-store,再追加 extra 里的 Cache-Control,
   结果是**两个 Cache-Control 头**,客户端只认第一个 ——
   调用方传的缓存策略被吃掉。改成 extra 里有就不再发默认值。

2. do_HEAD 和 do_GET 的缓存头不一致:HEAD 对非 /shot/ 一律报 no-store。
   下载器/代理用 HEAD 探测时会误判文件不可缓存。
   现在 _head_info 给每个路由带上和 GET 完全相同的缓存头,
   do_HEAD 也不再盲目覆盖。

结果(同一个测试口径):
  setup.exe  17 KB/s(截断) -> 695 KB/s 完整 15 MB   41 倍
  watch.apk   3 KB/s         -> 101 KB/s              33 倍
  server.zip 67 KB/s         ->  87 KB/s
  三个文件全部 cf-cache-status=HIT(不再穿隧道回源)

排查过程记一笔:我一开始用 curl -I 验证,
看到的全是 no-store —— 因为 **-I 发的是 HEAD**,
而 HEAD 走的是另一个分支。查了半天才发现是验证方法错了。
This commit is contained in:
xmz7891
2026-10-07 15:44:48 +08:00
parent 46196c3618
commit bf15a2ee61
203 changed files with 1789 additions and 40 deletions
+60
View File
@@ -0,0 +1,60 @@
#!/bin/bash
# 部署缓存头改动,并验证 Cloudflare 是否真的缓存了。
#
# 关键疑问:Cloudflare 默认只缓存一批扩展名,
# .exe / .zip / .apk **可能不在**默认列表里。
# 所以不能只看"我发了 Cache-Control"就算完,
# 必须看响应头里的 cf-cache-status 有没有变成 HIT。
set -u
BASE=https://relay.xxmxxs.top
UA='LanRemote/1.8.1'
echo "════════ 1. 重启中转让缓存头生效 ════════"
systemctl restart lanremote-relay
sleep 6
echo " 中转: $(systemctl is-active lanremote-relay)"
curl -s --max-time 10 http://127.0.0.1:8080/v1/health | head -c 80
echo
echo
echo "════════ 2. 本机直连看缓存头(确认代码生效)════════"
for p in "/" "/download/ykxmz-server-1.8.1.zip" "/download/ykxmz-setup-1.8.1.exe"; do
echo " ── $p ──"
curl -sI --max-time 15 "http://127.0.0.1:8080$p" 2>/dev/null \
| grep -iE '^HTTP|^cache-control|^content-length|^content-type' \
| tr -d '\r' | sed 's/^/ /'
done
echo
echo "════════ 3. 等隧道恢复 ════════"
for i in $(seq 1 20); do
c=$(curl -s -o /dev/null -w '%{http_code}' --max-time 12 -H "User-Agent: $UA" "$BASE/v1/health")
printf " 第 %d 次: %s\n" "$i" "$c"
[ "$c" = "200" ] && break
sleep 3
done
echo
echo "════════ 4. 走公网看 cf-cache-status(关键)════════"
echo " 对每个资源连打 3 次,看 MISS -> HIT"
for p in "/" "/shot/pc-main.png" "/favicon.ico" \
"/download/ykxmz-server-1.8.1.zip" \
"/download/ykxmz-setup-1.8.1.exe" \
"/download/ykxmz-watch-1.8.1.apk"; do
echo " ── $p ──"
for i in 1 2 3; do
hdr=$(curl -sI --max-time 30 -H "User-Agent: $UA" "$BASE$p" 2>/dev/null | tr -d '\r')
st=$(echo "$hdr" | grep -i '^cf-cache-status' | awk '{print $2}')
cc=$(echo "$hdr" | grep -i '^cache-control' | cut -d' ' -f2-)
age=$(echo "$hdr" | grep -i '^age:' | awk '{print $2}')
printf " 第 %d 次: cf-cache-status=%-8s age=%-6s cache-control=%s\n" \
"$i" "${st:-无}" "${age:-无}" "${cc:-无}"
sleep 1
done
done
echo
echo "════════ 5. 结论 ════════"
echo " 如果 .exe/.zip/.apk 一直是 MISS/无,说明 Cloudflare 默认不缓存这些扩展名,"
echo " 需要在 Cloudflare 后台加一条 Cache Rule(我会给出具体配置)。"