feat: 新增开源版官网骨架 website/,并接入部署编排与网关路由
- website/:VitePress 官网工程(首页/功能/对比/快速开始/部署运维/教程/社区),与文档站同构 - 两种形态由 SITE_BASE 决定:/www/ 子路径(过渡)与 / 根路径(独立域名),内容同源 - deploy/:新增 with-website profile、网关 /www/ 路由、多域名 website vhost 段 - Makefile:新增 website 镜像条目与 make website 目标 - 教程页给出部署/使用两支视频的元数据与录制要求,官网留有教程入口
This commit is contained in:
@@ -34,6 +34,7 @@ docker compose --profile with-gateway up -d # 单端口入口(默认对外 5
|
||||
docker compose --profile with-mock up -d # 运营商接口挡板
|
||||
docker compose --profile with-bot up -d # 飞书通知(运维自用)
|
||||
docker compose --profile with-nginx up -d # 多域名反向代理(对外 80)
|
||||
docker compose --profile with-website up -d # 官网(项目门户站)
|
||||
```
|
||||
|
||||
多个 profile 可组合:`--profile with-gateway --profile with-mock up -d`
|
||||
@@ -52,11 +53,37 @@ GATEWAY_PORT=8088 docker compose --profile with-gateway up -d
|
||||
| --- | --- |
|
||||
| `/` | 管理端(admin-ui,内部已代理 `/api/` 到 admin-svr) |
|
||||
| `/docs/` | 文档站 |
|
||||
| `/www/` | 官网(需同时启用 `with-website`) |
|
||||
| `/openapi/` | 对外 API |
|
||||
| `/route/open/` | 运营商能力代理(白名单 / 共享 Token) |
|
||||
|
||||
配置见 `config/gateway/nginx.conf`。小程序 / H5 端的静态资源是根路径部署的,不能挂在同一域名的子路径下,需要单独域名或端口(见 `with-nginx` 的 app 段)。
|
||||
|
||||
### 官网(with-website)
|
||||
|
||||
项目门户站(项目介绍、功能矩阵、快速开始、教程入口),源码在仓库的 `website/` 目录,与文档站同构(VitePress)。
|
||||
|
||||
```bash
|
||||
docker compose --profile with-website up -d --build website
|
||||
```
|
||||
|
||||
镜像发布到公共仓库之前用 `--build` 本地构建;发布后去掉 `--build` 即可。
|
||||
|
||||
**两种形态**由构建参数 `WEBSITE_SITE_BASE` 决定:
|
||||
|
||||
| 形态 | 参数 | 访问方式 |
|
||||
| --- | --- | --- |
|
||||
| 子路径(过渡,无独立域名) | `/www/`(默认) | 网关的 `http://<主机>:5051/www/` |
|
||||
| 独立域名 | `/` | 域名根路径,如 `https://<官网域名>/` |
|
||||
|
||||
```bash
|
||||
# 独立域名形态
|
||||
WEBSITE_SITE_BASE=/ docker compose --profile with-website up -d --build website
|
||||
```
|
||||
|
||||
形态切换只改构建参数与入口配置,页面内容同源,不用改代码。独立域名形态下把 DNS 指到本机,
|
||||
并在 `config/nginx/iotlcm.conf` 里加一段 `server_name <官网域名>` 的 vhost 指向 `website` 容器。
|
||||
|
||||
`with-bot` 是把全量同步等运维事件推送到飞书群的**内部运维工具**,不是平台功能。它需要你自己的飞书自建应用凭证(`config/bot/config.yaml` 的 `appId` / `appSecret` / `chatId`),没填就不启动。
|
||||
|
||||
**默认不启动,也不影响平台功能**;不需要飞书通知就完全不用管它。
|
||||
|
||||
Reference in New Issue
Block a user