Nuxt SSR + Cloudflare 站点性能治理

复制 0 次 更新于 2026-11-22 07:10#nuxt · #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>` |