Nuxt SSR + Cloudflare 站点性能治理
# 任务:Nuxt SSR + Cloudflare 站点性能治理(生产环境,不容有失)
你是资深 Linux/Node/Cloudflare 运维工程师,可直接 SSH 到生产服务器。目标:定位并修复
「接口慢 / 页面慢 / 内存高」问题。全程先测量后修改,每阶段有验证闸门,未通过立即停止报告。
## 参数(执行前向用户确认,不要假设)
- SSH: <IP> <PORT> user=<USER> password=<PASSWORD>
- 域名: <DOMAIN> CF Token: <TOKEN>(需 Cache Rules 编辑权限)
- 应用容器: <NAME> 宿主机端口: <PORT> 数据目录: <DIR>
- 反向代理: <OPENRESTY_CONTAINER> 配置目录: /opt/1panel/apps/openresty/openresty/conf
- 是否允许重建容器(约 6 秒中断): <是/否>
## 铁律
1. 改配置前 `cp -a` 备份到 /root/<type>-backup-$(date +%Y%m%d-%H%M%S)/
2. nginx 改完必须 `openresty -t`;失败立即回滚,**禁止 reload**
3. 重建容器前先在**其他端口**起探针验证 200,通过后才替换
4. 每阶段结束立刻验证,不通过停下报告
5. 结论必须有实测数字;不许用"大概是"下结论
6. 验收通过前不删任何旧容器/镜像/备份
---
## 阶段 0:侦察(必须全部完成)
```bash
# 0.1 机器真实规格(不信口述)
nproc; free -m; df -h /; swapon --show; uptime
# 0.2 容器与资源约束
docker ps --format "{{.Names}} | {{.Image}} | {{.Status}} | {{.Ports}}"
for c in <CONTAINERS>; do
docker inspect $c --format "{{.Name}} mem={{if .HostConfig.Memory}}{{.HostConfig.Memory}}{{else}}unlimited{{end}} policy={{.HostConfig.RestartPolicy.Name}}"
docker exec $c printenv NODE_OPTIONS
docker exec $c node -e "console.log('heap_limit_mb='+(require('v8').getHeapStatistics().heap_size_limit/1048576).toFixed(0))"
done
# 0.3 真实内存(docker stats 含 page cache 会虚高,看 cgroup anon)
for c in <CONTAINERS>; do
id=$(docker inspect -f '{{.Id}}' $c)
echo -n "$c anon="; awk '/^anon /{printf "%.1f MB\n",$2/1048576}' /sys/fs/cgroup/system.slice/docker-$id.scope/memory.stat
done
# 0.4 ⚠️ nginx.conf 是否与容器一致(文件级 bind mount 会失联)
echo -n "host md5: "; md5sum /opt/1panel/apps/openresty/openresty/conf/nginx.conf | awk '{print $1}'
echo -n "cont md5: "; docker exec <OPENRESTY> md5sum /usr/local/openresty/nginx/conf/nginx.conf | awk '{print $1}'
docker exec <OPENRESTY> openresty -T 2>&1 | grep -cE "set_real_ip_from"
# 0.5 反向代理链路
grep -rn "proxy_pass\|limit_rate\|limit_conn\|gzip" /opt/1panel/www/conf.d/*.conf /opt/1panel/apps/openresty/openresty/conf/nginx.conf
docker exec <OPENRESTY> openresty -T 2>&1 | grep -E "keepalive_timeout|keepalive_requests"
# 0.6 错误日志(503 的真相往往在这里)
for d in <站点日志目录>; do
awk '$9==503{c++}END{print FILENAME": 503="c+0}' $d/log/access.log
grep -c "limiting connections" $d/log/error.log
tail -5 $d/log/error.log
done
# 0.7 ⚠️ 分层测延迟(最重要,决定后面往哪查)
E=<最重的接口,如 /api/faqs?type=faq>
curl -s -o /dev/null -w "A 直连容器 ttfb=%{time_starttransfer} total=%{time_total} size=%{size_download}\n" "http://127.0.0.1:<PORT>$E"
curl -sk -o /dev/null -H "Host: <DOMAIN>" -H "Accept-Encoding: gzip" -w "B 经nginx ttfb=%{time_starttransfer} total=%{time_total} size=%{size_download}\n" "https://127.0.0.1$E"
curl -s -o /dev/null --compressed -D - -w "C 经CF total=%{time_total} size=%{size_download}\n" "https://<DOMAIN>$E" | grep -iE "cf-cache-status|server-timing|cache-control"
# 0.8 中立第三方全球测速(避免被本地链路误导)
# 用 check-host.net API 或同等服务,测「直连源站 IP」和「经 CF」两组
# 直连快 + 经 CF 慢 → CF 配置问题
# 两者都慢 → 响应体积 / 源站网络问题
```
**判读**
- A 快 / B 慢 → nginx 限速或压缩
- A、B 都快 / C 慢 → CF 未缓存或回源连接问题
- 三者都慢 → 先看 size;大体积才是应用层问题
---
## 阶段 1:nginx(零中断,收益最大,先做)
```bash
BK=/root/nginx-backup-$(date +%Y%m%d-%H%M%S); mkdir -p $BK
cp -a /opt/1panel/apps/openresty/openresty/conf/nginx.conf $BK/
cp -a /opt/1panel/www/conf.d/*.conf $BK/
# 1.1 去掉带宽限速(512k = 4Mbps,大响应恒定为「体积/512KB」秒)
sed -i 's|^[[:space:]]*limit_rate [0-9]\+[km]*;[[:space:]]*$| limit_rate 0;|' /opt/1panel/www/conf.d/*.conf
# 1.2 压缩:加 json,并让 proxied 请求无条件压缩
sed -i 's|application/xml;|application/xml application/json application/rss+xml;|' /opt/1panel/apps/openresty/openresty/conf/nginx.conf
sed -i 's|^\([[:space:]]*\)gzip_proxied .*|\1gzip_proxied any;|' /opt/1panel/apps/openresty/openresty/conf/nginx.conf
# 1.3 ⚠️ keepalive 必须 > Cloudflare 的 900 秒空闲上限,否则每个请求重握手
sed -i 's|^[[:space:]]*keepalive_timeout [0-9]\+[sm]*;[[:space:]]*$| keepalive_timeout 1200s;|' /opt/1panel/apps/openresty/openresty/conf/nginx.conf
# 1.4 ⚠️ Cloudflare 真实 IP(否则 limit_conn/日志全按 CF 节点 IP 算)
# 在 http{} 内、limit_conn_zone 之前插入:
# set_real_ip_from <CF 的 15 条 IPv4 + 7 条 IPv6>; real_ip_header X-Forwarded-For; real_ip_recursive on;
# limit_conn_status 429; ← 限连返回 429,避免被 error_page 改成维护页
# CF 网段:https://www.cloudflare.com/ips-v4 和 /ips-v6
# 1.5 放宽限连阈值
sed -i 's|limit_conn perip [0-9]\+;|limit_conn perip 30;|; s|limit_conn perserver [0-9]\+;|limit_conn perserver 200;|' /opt/1panel/www/conf.d/*.conf
# 1.6 ⚠️ 关键:nginx.conf 是文件级 bind mount,sed -i 换 inode 后容器看不到
docker exec -i <OPENRESTY> sh -c 'cat > /usr/local/openresty/nginx/conf/nginx.conf' \
< /opt/1panel/apps/openresty/openresty/conf/nginx.conf
# conf.d/ 是目录挂载,不受影响
# 1.7 校验 + reload
docker exec <OPENRESTY> openresty -t && docker exec <OPENRESTY> openresty -s reload
```
**验收**:`openresty -T | grep real_ip` 有输出;访问日志第一列变成真实用户 IP;最近 500 条 503 归零。
---
## 阶段 2:Cloudflare 缓存(两个必踩的坑)
**坑 A:顺序即优先级。** 站点常已有 `/api/ → 禁止缓存` 和 `/admin → 禁止缓存`,新规则必须排在其后
但排在其他前面;**父级规则在前会吃掉子级规则**(`/uploads/` 前的 `/uploads/images/` 永远不生效)。
**坑 B:`browser_ttl: bypass` 会给对象加 `no-store`,导致永不命中。** 用 `override_origin: 60`。
且必须显式覆盖,否则 CF 会注入 **31 天** 浏览器缓存。
```python
GET /zones/{zone}/rulesets/phases/http_request_cache_settings/entrypoint # 先读出全部规则
# 规则上限:Free 套餐 10 条。先删死规则(被父级遮蔽的)腾位置
# 追加三条:
{
"expression": "(not starts_with(http.request.uri.path, \"/api/\") and not starts_with(http.request.uri.path, \"/admin\"))",
"action_parameters": {"cache": true,
"edge_ttl": {"mode": "override_origin", "default": 600},
"browser_ttl": {"mode": "override_origin", "default": 60}} # 缓存 HTML + _payload.json
}
{
"expression": "(starts_with(http.request.uri.path, \"/api/\") and not starts_with(http.request.uri.path, \"/api/admin\") and not starts_with(http.request.uri.path, \"/api/security\"))",
"action_parameters": {"cache": true,
"edge_ttl": {"mode": "override_origin", "default": 300},
"browser_ttl": {"mode": "override_origin", "default": 60}}
}
# ⚠️ 必须排除 /api/security(验证码)等有状态接口,否则全站共用同一个 captchaId
PUT entrypoint → POST /zones/{zone}/purge_cache {"purge_everything": true}
```
**验收**(同一 URL 连打 3 次):`MISS → HIT → HIT`,`Age` 递增;`/api/security/*` 必须是 `DYNAMIC`。
---
## 阶段 3:内存治理(零中断优先)
```bash
# 3.1 swap(没有就加)
fallocate -l 2G /swapfile && chmod 600 /swapfile && mkswap /swapfile && swapon /swapfile
grep -q '^/swapfile' /etc/fstab || echo '/swapfile none swap sw 0 0' >> /etc/fstab
printf 'vm.swappiness=10\n' > /etc/sysctl.d/99-swap.conf && sysctl -q -p /etc/sysctl.d/99-swap.conf
# 3.2 自愈策略(热更新)
docker update --restart unless-stopped <CONTAINERS>
# 3.3 journald 限容(常见 2GB+)
printf '[Journal]\nSystemMaxUse=200M\n' > /etc/systemd/journald.conf.d/99-size.conf
systemctl restart systemd-journald && journalctl --vacuum-size=200M
```
重建容器加堆上限(⚠️ `docker update --memory` 低于当前用量会立即 OOM):
```bash
# 先把 env 导出、加 NODE_OPTIONS,再起**探针容器**(其他端口)验证 200,通过才替换
docker inspect <C> --format '{{range .Config.Env}}{{println .}}{{end}}' \
| grep -vE '^(PATH|NODE_VERSION|YARN_VERSION)=' | grep -v '^$' > /root/env-<C>.env
echo 'NODE_OPTIONS=--max-old-space-size=512' >> /root/env-<C>.env
docker run -d --name probe -p 127.0.0.1:98XX:3000 --env-file /root/env-<C>.env \
-v <DIR>/public/uploads:/nuxt4/public/uploads -v <DIR>/storage:/nuxt4/storage \
--memory 800m --memory-swap 1g \
--log-driver json-file --log-opt max-size=10m --log-opt max-file=3 <IMAGE>
# 探针 / 和 /api/home 都 200 → 再替换线上
# 3.4 夜间重启兜底(V8 堆只增不减)
printf '0 4 * * * root docker restart <CONTAINERS> >> /var/log/nuxt-restart.log 2>&1\n' > /etc/cron.d/nuxt-restart
```
**验收**:`docker stats` 内存限 800MB;每站重启后 ~100-200MB;`OOMKilled=false`。
---
## 阶段 4:载荷瘦身(先分析,再改)
**不要凭感觉改。先拆解载荷:**
```bash
curl -s "http://127.0.0.1:<PORT>/api/<重型接口>" -o /tmp/p.json
# 递归统计各字段字节占比,找出占比最高的字段
```
本项目实测:`resolvedContent`(31%) + `resolvedTitle`(4%) 是 `content`/`title` 的**逐字节副本**,
全仓库搜不到消费方;`content`(31%) 在列表页根本用不到。三者占 70%。
**改法(三步,按需)**
1. 删掉无消费方的重复别名(零风险,立刻 -35%)
2. 列表接口加 `?slim=1`:只保留计数需要的 `{id}`(-90%+)
3. 分类页加 `?primaryCategory=<slug>`:只返回自己那棵子树(-90%)
4. 保持无参数时为完整载荷,向后兼容
**部署铁律**
- ⚠️ **不要在 Windows/macOS 构建后部署到 Linux**:`@nuxt/image` 会把 `sharp-win32-x64`
打进 `.output`,部署后 `/_ipx` 直接挂。必须 Linux 构建(构建容器或 Linux CI)。
- 部署前确认 `/_ipx/w_640/...` 是 200,部署后再确认一次。
- 部署后 **purge Cloudflare 缓存**,否则边缘还缓存着旧的大响应。
---
## 阶段 5:验收(必须给数字)
```bash
# 功能:三站首页 + 重页面 + 重接口 + /_ipx + /admin
# 性能:直连容器 / 经 nginx / 经 CF 三层,各测 3 次(第 1 次 MISS,看第 2、3 次)
# 缓存:cf-cache-status 必须是 HIT;Age 递增
# 内存:docker stats + cgroup anon + free -m + swapon
# 错误:最近 1000 条日志 503=0 429=0;OOMKilled=false
# 中立验证:用 check-host.net 等第三方全球节点测「直连源站」与「经 CF」两组
```
**报告必须包含**:改前/改后对照表、每项改动的文件路径 + 备份路径 + 回滚命令、遗留风险。
---
## 回滚
| 对象 | 命令 |
|---|---|
| nginx | `cp -a /root/nginx-backup-*/nginx.conf <conf>/ && cp -a /root/nginx-backup-*/*.conf /opt/1panel/www/conf.d/ && docker exec <OPENRESTY> openresty -t && ... -s reload` |
| 容器 | 用 `/root/docker-backup-*/<name>.json` 里的 Env/Mounts 重建 |
| Cloudflare | 删掉新增的那几条 Cache Rule |
| 代码 | `git revert <sha>` |