1.7 KiB
1.7 KiB
部署说明
本地开发
API 默认监听 http://localhost:3001,管理后台默认监听 http://localhost:3000。后台开发服务器会把 /api 请求代理到 API,并移除 /api 前缀,因此本地不需要额外配置跨域。
Nginx 反向代理
生产环境建议使用同源路径:
location /admin/ {
try_files $uri $uri/ /admin/index.html;
}
location /api/ {
proxy_pass http://127.0.0.1:3001/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Request-ID $request_id;
}
生产构建会先把所有已接入模板的 H5 renderer 编译进一个静态预览应用,再将其放到 Admin 的 /template-preview/ 下。线上无需启动 Vite,也无需为每个模板运行单独服务。构建管理后台与预览应用时使用:
pnpm build:admin:preview
部署时将 apps/admin/dist 作为同一个静态站点发布。预览 iframe 与 Admin 同源,运行时根据品牌公开工作区中的 visualTemplateKey 选择已打包的模板 renderer,并通过 /api 读取已发布数据;管理员正在编辑的草稿由 Admin 经 postMessage 投影到 iframe,不会写回公开 API。
本地开发只需启动一个多模板 H5 服务和 Admin:
pnpm preview:templates
VITE_APP_BASE_PATH=/ ADMIN_PORT=3000 pnpm --filter @personal-brand/admin dev
本地 Admin 默认连接 http://localhost:3002 上的统一预览服务。VITE_TEMPLATE_PREVIEW_URL 只用于部署时覆盖预览应用地址,不再按模板配置 URL map。
如果希望 API 服务自身也带前缀,可设置 API_PREFIX=api。使用 Nginx 去前缀转发时保持默认空值即可,避免重复 /api/api。