技小云门户部署
启动
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