技小云
fafc743387
mirror-to-gitee / mirror (push) Successful in 21s
- 旧骨架的方案对比页移到 projects/iotlcm/compare.md，站内链接与侧边栏同步 - 旧骨架的功能矩阵与边界段并入 iotlcm 详情页；社区页独有内容并入 about.md - favicon 移到 pages/public/（vitepress 的 publicDir 相对 srcDir 解析，原位置不落地） - compose 绑定地址参数化：默认 127.0.0.1，NAT 转发需 PORTAL_BIND_ADDR=0.0.0.0 - 两种形态构建产物站内链接自检均无死链
门户部署
启动
docker compose -f deploy/docker-compose.yml up -d --build
默认发布在宿主机 127.0.0.1:8020（用 PORTAL_PORT 改端口）。
两种形态
构建参数 SITE_BASE 决定站点资源前缀，同时决定容器内 nginx 的形态：
| 形态 | 参数 | 访问方式 |
|---|---|---|
| 子路径（过渡，无独立域名） | /www/（默认） |
由已有网关转发 /www/ 到本容器 |
| 独立域名 | / |
域名根路径，如 https://<门户域名>/ |
SITE_BASE=/ docker compose -f deploy/docker-compose.yml up -d --build
内容同源，切换只改构建参数与入口配置，页面不用改。
VitePress 产物里的资源引用是绝对路径（
<base>assets/xxx），base 与 nginx 的 location 形态必须配套， 混用会出现「页面 200 但 JS/CSS 全 404」的白屏。镜像构建脚本按SITE_BASE自动选对应配置。
校验
门户项目清单与详情页的一致性在构建前自动校验：
npm run check