Kratos本身不托管前端静态资源，它仅提供API服务；前端dist目录需通过Nginx反向代理或CDN等独立方式托管，/路径服务静态文件，/api/等路径代理至Kratos后端。
Kratos 本身不托管前端静态资源，它是一个后端微服务框架，定位是提供 API 服务。所谓“Kratos 托管前端页面”，本质是把构建好的 dist 目录内容，通过反向代理（如 Nginx）或独立静态托管服务（如 OSS、Vercel）对外提供，而 Kratos 只负责处理 /api/ 或 /v1/ 等接口请求。
为什么不能直接用 Kratos 的 HTTP Server 托管前端文件
Kratos 的 http.Server 是为 REST/gRPC 接口设计的，不是静态文件服务器。它没有内置类似 koa-static 或 express.static 的中间件机制；强行在 service 层读取并返回 index.html 会导致：
- 路由冲突：所有未匹配的路径都得手动 fallback 到
index.html，容易漏配或覆盖真实接口 - 无缓存控制：无法自动设置
Cache-Control、ETag、Content-Encoding等关键头 - 性能损耗：每次请求都走 Go runtime 文件读取 + gzip 压缩，远不如 CDN 或 Nginx 零拷贝响应
- 安全风险：若路径拼接不当，可能触发目录遍历（如
..%2f/etc/passwd）
Nginx 反向代理是最常用且推荐的方案
适用于前后端同域名部署（如 https://app.example.com），前端资源放在服务器本地 /var/www/frontend/dist，API 由 Kratos 在 localhost:8000 提供。
典型 Nginx 配置要点：
立即学习“前端免费学习笔记（深入）”；
- 根路径
/指向静态文件目录，启用try_files支持 SPA 路由 fallback - 接口路径（如
/api/、/v1/）全部proxy_pass到 Kratos 服务 - 必须显式配置
location ~* \.(js|css|png|jpg|gif|ico|woff2?)$并加expires 1y，否则静态资源不缓存 - 若 Kratos 启用了 CORS，前端域名必须出现在
allowOrigins列表中，不能写"*"（尤其当allowCredentials: true时）
示例片段：
location / {
root /var/www/frontend/dist;
try_files $uri $uri/ /index.html;
}
location /api/ {
proxy_pass http://localhost:8000/;
proxy_set_header Host $host;
}访问 404 或白屏？先查这三处
前端页面能加载但接口 404、或整个页面空白，常见根源不在 Kratos 本身，而在部署链路断点：
-
index.html中的script和link路径是否带 base？Vue CLI/React App 默认生成相对路径（如./js/app.js），若部署在子路径（如/admin/）需配置publicPath或homepage - 浏览器 Network 面板里，
index.html返回 200，但main.js返回 404 —— 说明 Nginx 的root或alias配置错了层级，多套了一层目录 - 控制台报
Failed to load resource: the server responded with a status of 401 (Unauthorized)或 CORS 错误 —— 不是 Kratos 没返回，而是网关（如 Kratos Gateway）没配好cors，或配了但allowOrigins写成了["*"]且allowCredentials: true
真正需要操心的不是“Kratos 怎么托管静态资源”，而是“前端构建产物怎么和 Kratos 接口协同上线”。静态资源和 API 服务本就该解耦部署：前者走 CDN/OSS/Vercel，后者走 Kubernetes 或云函数。混淆二者职责，后期扩容、灰度、回滚都会变复杂。
