Files
termi-blog/frontend
limitcool 497a9d713d
Some checks failed
docker-images / build-and-push (admin, admin, termi-astro-admin, admin/Dockerfile) (push) Failing after 13s
docker-images / build-and-push (frontend, frontend, termi-astro-frontend, frontend/Dockerfile) (push) Has been cancelled
docker-images / build-and-push (backend, backend, termi-astro-backend, backend/Dockerfile) (push) Has been cancelled
feat: ship public ops features and cache docker builds
2026-04-01 13:22:19 +08:00
..

frontend

Astro 前台站点,当前运行模式为:

  • output: 'server'
  • @astrojs/node standalone
  • 少量 Svelte 组件用于客户端激活

常用命令

pnpm install
pnpm dev
pnpm build

默认本地开发端口:

  • frontend: 4321

API 地址约定

前台现在区分两类 API 地址:

  • INTERNAL_API_BASE_URL
    • 给 Astro SSR / Node 服务端渲染访问 backend 用
    • docker compose 默认推荐:http://backend:5150/api
  • PUBLIC_API_BASE_URL
    • 给浏览器里的评论、AI 问答、搜索等请求用
    • 如果不设置,生产环境会回退到“当前访问主机 + :5150/api

如果你走正式域名 / HTTPS / 反向代理,建议显式设置:

PUBLIC_API_BASE_URL=https://api.blog.init.cool

图片处理链

前台现在额外带了一个 SSR 图片优化端点:

  • /_img

它会对同域图片做:

  • 响应式尺寸裁切/缩放
  • AVIF / WebP / JPEG|PNG 输出
  • 前台卡片 / 文章页封面的 srcset 生成

如果你的封面图来自额外 CDN / R2 公网域名,需要给 frontend 运行时增加:

PUBLIC_IMAGE_ALLOWED_HOSTS=cdn.example.com,pub-xxxx.r2.dev

admin 侧上传封面时也会额外做:

  • 上传前压缩
  • 16:9 封面规范化
  • 优先转为 AVIF / WebP