61 lines
1.3 KiB
Markdown
61 lines
1.3 KiB
Markdown
# frontend
|
|
|
|
Astro 前台站点，当前运行模式为：
|
|
|
|
- `output: 'server'`
|
|
- `@astrojs/node` standalone
|
|
- 少量 Svelte 组件用于客户端激活
|
|
|
|
## 常用命令
|
|
|
|
```powershell
|
|
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 / 反向代理，建议显式设置：
|
|
|
|
```env
|
|
PUBLIC_API_BASE_URL=https://api.blog.init.cool
|
|
```
|
|
|
|
## 图片处理链
|
|
|
|
前台现在额外带了一个 SSR 图片优化端点：
|
|
|
|
- `/_img`
|
|
|
|
它会对**同域图片**做：
|
|
|
|
- 响应式尺寸裁切/缩放
|
|
- `AVIF / WebP / JPEG|PNG` 输出
|
|
- 前台卡片 / 文章页封面的 `srcset` 生成
|
|
|
|
如果你的封面图来自额外 CDN / R2 公网域名，需要给 frontend 运行时增加：
|
|
|
|
```env
|
|
PUBLIC_IMAGE_ALLOWED_HOSTS=cdn.example.com,pub-xxxx.r2.dev
|
|
```
|
|
|
|
admin 侧上传封面时也会额外做：
|
|
|
|
- 上传前压缩
|
|
- 16:9 封面规范化
|
|
- 优先转为 `AVIF / WebP`
|