技小云
36 lines
1.0 KiB
Markdown
36 lines
1.0 KiB
Markdown
# 门户部署
|
|
|
|
## 启动
|
|
|
|
```bash
|
|
docker compose -f deploy/docker-compose.yml up -d --build
|
|
```
|
|
|
|
默认发布在宿主机 `127.0.0.1:8020`（用 `PORTAL_PORT` 改端口）。
|
|
|
|
## 两种形态
|
|
|
|
构建参数 `SITE_BASE` 决定站点资源前缀，同时决定容器内 nginx 的形态：
|
|
|
|
| 形态 | 参数 | 访问方式 |
|
|
| --- | --- | --- |
|
|
| 子路径（过渡，无独立域名） | `/www/`（默认） | 由已有网关转发 `/www/` 到本容器 |
|
|
| 独立域名 | `/` | 域名根路径，如 `https://<门户域名>/` |
|
|
|
|
```bash
|
|
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` 自动选对应配置。
|
|
|
|
## 校验
|
|
|
|
门户项目清单与详情页的一致性在构建前自动校验：
|
|
|
|
```bash
|
|
npm run check
|
|
```
|