diff --git a/frontend/nginx.conf b/frontend/nginx.conf index ad114732..10cd79a6 100644 --- a/frontend/nginx.conf +++ b/frontend/nginx.conf @@ -19,6 +19,25 @@ server { root /usr/share/nginx/html; index index.html; try_files $uri $uri/ /index.html; + + # index.html 及 SPA fallback 不可缓存,否则前端升级后用户看不到新版本 + add_header Cache-Control "no-cache, must-revalidate" always; + # nginx add_header 不从上层继承,需要在 location 内重复声明安全头 + add_header X-Frame-Options "SAMEORIGIN" always; + add_header X-Content-Type-Options "nosniff" always; + add_header X-XSS-Protection "1; mode=block" always; + add_header Referrer-Policy "strict-origin-when-cross-origin" always; + } + + # Vite 构建产物 /assets/* 带 hash 文件名,可长期缓存 + location ^~ /assets/ { + root /usr/share/nginx/html; + + add_header Cache-Control "public, max-age=31536000, immutable" always; + add_header X-Frame-Options "SAMEORIGIN" always; + add_header X-Content-Type-Options "nosniff" always; + add_header X-XSS-Protection "1; mode=block" always; + add_header Referrer-Policy "strict-origin-when-cross-origin" always; } # 本地存储文件代理到后端服务(用于渲染 markdown 中的图片) diff --git a/internal/router/router.go b/internal/router/router.go index dbcd3737..5052b493 100644 --- a/internal/router/router.go +++ b/internal/router/router.go @@ -735,15 +735,28 @@ func serveFrontendStatic(r *gin.Engine) { } fullPath := filepath.Join(absDir, path) if info, err := os.Stat(fullPath); err == nil && !info.IsDir() { + setFrontendCacheHeaders(c.Writer, path) fileServer.ServeHTTP(c.Writer, c.Request) c.Abort() return } + setFrontendCacheHeaders(c.Writer, "/index.html") c.File(indexPath) c.Abort() }) } +// setFrontendCacheHeaders sets Cache-Control headers for frontend static resources. +// Vite 构建产物中 /assets/* 的文件名带 hash,可长期缓存;其余(index.html、config.js、favicon 等) +// 每次都需 revalidate,避免前端升级后用户看到旧版本。 +func setFrontendCacheHeaders(w http.ResponseWriter, path string) { + if strings.HasPrefix(path, "/assets/") { + w.Header().Set("Cache-Control", "public, max-age=31536000, immutable") + return + } + w.Header().Set("Cache-Control", "no-cache, must-revalidate") +} + // serveFiles serves files via query parameters and tenant storage settings. // It is registered after auth middleware, so tenant context comes from authentication. //