🚀 K8s 部署优化：添加 startupProbe + 启动预热，消除冷启动延迟

添加 entrypoint.sh 预热脚本，在 Pod 接收流量前预先渲染关键页面；
配置 startupProbe 确保预热期间不被误杀，readinessProbe 确保预热完成后才切入流量。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: CodFrm

.dockerignore

@@ -36,6 +36,7 @@ Thumbs.db
 .github
 .gitea
 deploy
+!deploy/docker/entrypoint.sh
 
 # Documentation
 README.md

.gitignore

@@ -46,3 +46,6 @@ next-env.d.ts
 /public/assets/monaco-editor/*
 /public/assets/prismjs/*
 
+.claude
+
+CLAUDE.md

deploy/docker/Dockerfile

@@ -62,8 +62,12 @@ COPY --from=builder /app/.next/standalone ./
 COPY --from=builder /app/.next/static ./.next/static
 COPY --from=builder /app/public ./public
 
+# 复制启动脚本
+COPY deploy/docker/entrypoint.sh ./entrypoint.sh
+RUN chmod +x ./entrypoint.sh
+
 # 暴露端口
 EXPOSE 3000
 
-# 启动应用（standalone 模式使用 server.js）
-CMD ["node", "server.js"]
+# 启动应用（包含预热）
+CMD ["./entrypoint.sh"]

deploy/docker/entrypoint.sh

@@ -0,0 +1,30 @@
+#!/bin/sh
+set -e
+
+# Start Next.js server in the background
+node server.js &
+SERVER_PID=$!
+
+# Wait for the server to be ready
+echo "Waiting for Next.js server to start..."
+for i in $(seq 1 30); do
+  if wget -q --spider http://localhost:3000/ 2>/dev/null; then
+    echo "Server is up, starting warmup..."
+    break
+  fi
+  if [ "$i" = "30" ]; then
+    echo "Server failed to start within 30s"
+    exit 1
+  fi
+  sleep 1
+done
+
+# Warmup key pages to trigger SSR compilation and caching
+echo "Warming up pages..."
+wget -q -O /dev/null http://localhost:3000/zh-CN 2>/dev/null || true
+wget -q -O /dev/null http://localhost:3000/zh-CN/search 2>/dev/null || true
+wget -q -O /dev/null http://localhost:3000/en 2>/dev/null || true
+echo "Warmup complete."
+
+# Wait for the server process
+wait $SERVER_PID

deploy/helm/templates/deployment.yaml

@@ -37,14 +37,25 @@ spec:
             - name: http
               containerPort: 3000
               protocol: TCP
+          startupProbe:
+            httpGet:
+              path: /
+              port: http
+            initialDelaySeconds: 5
+            periodSeconds: 5
+            failureThreshold: 12
           livenessProbe:
             httpGet:
               path: /
               port: http
+            periodSeconds: 30
+            failureThreshold: 3
           readinessProbe:
             httpGet:
               path: /
               port: http
+            periodSeconds: 10
+            failureThreshold: 3
           resources:
             {{- toYaml .Values.resources | nindent 12 }}
           {{- with .Values.env }}