docs: 新增部署手册页并修复容器部署白屏问题
- 新增 docs/deploy/ 部署手册:推荐环境(Node 22 / nginx / Docker)、 编译方法(npm ci + build)、四类部署方式(Docker+nginx 推荐路径、 静态服务器、对象存储/CDN、内网离线),含路径前缀要点与环境对照表 - 修复 docker/nginx.conf:base=/docs/ 使产物资源引用为绝对路径, 原配置从根路径服务导致资源全部 404(白屏)。改用 alias 剥离前缀, 并加 / -> /docs/ 重定向 - README 补部署指引与路径前缀告警,修正 dev 入口地址为 /docs/ - 导航与首页增加「部署手册」入口
This commit is contained in:
@@ -33,9 +33,11 @@ iotlcm-docs/
|
||||
|
||||
```bash
|
||||
npm ci
|
||||
npm run dev # http://127.0.0.1:5173/
|
||||
npm run dev # http://127.0.0.1:5173/docs/
|
||||
```
|
||||
|
||||
> 入口地址带 `/docs/`:配置里 `base: '/docs/'`,直接访问根路径会 404。
|
||||
|
||||
构建与预览:
|
||||
|
||||
```bash
|
||||
@@ -45,15 +47,22 @@ npm run preview
|
||||
|
||||
站点部署在子路径 `/docs/`(见 `.vitepress/config.mts` 的 `base`)。本地开发时根路径会自动重定向 favicon。
|
||||
|
||||
## 容器化部署
|
||||
## 部署
|
||||
|
||||
**完整部署手册见文档站:[部署手册](https://git.5iot.com/iotlcm-public/iotlcm-docs) → `docs/deploy/`**,包含推荐环境、编译方法、nginx / 对象存储 / 离线环境部署方式与常见问题。
|
||||
|
||||
最短路径(容器,推荐):
|
||||
|
||||
```bash
|
||||
docker build -t iotlcm-docs .
|
||||
docker run -d -p 8080:80 iotlcm-docs
|
||||
docker build -t iotlcm-docs:$(git rev-parse --short HEAD) .
|
||||
docker run -d --name iotlcm-docs -p 8019:80 iotlcm-docs:latest
|
||||
# 访问 http://127.0.0.1:8019/docs/
|
||||
```
|
||||
|
||||
多阶段构建:Node 阶段执行 `vitepress build`,最终镜像只含 nginx 与静态产物。
|
||||
|
||||
> ⚠️ **路径前缀**:`base: '/docs/'` 使资源引用为绝对路径 `/docs/assets/*`,而 dist 是平铺的。`docker/nginx.conf` 已用 `alias` 剥掉前缀,**不要**改成从根路径直接服务产物,否则白屏。
|
||||
|
||||
`docker-compose.yml` 里的镜像名需替换成你自己的镜像仓库地址;对外署时请用不可变标签(commit sha)而不是 `latest`。
|
||||
|
||||
## 文档里的占位符
|
||||
|
||||
Reference in New Issue
Block a user