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:
Dai0814
2026-10-26 16:51:33 +08:00
parent 846bac3d6c
commit 07ddaa9968
5 changed files with 482 additions and 5 deletions
+13
View File
@@ -5,6 +5,19 @@ server {
root /usr/share/nginx/html;
index index.html;
# 产物按 VitePress base=/docs/ 生成,HTML 里的资源引用形如 /docs/assets/xxx,
# 而 dist 目录是平铺的。因此必须在 /docs/ 路径下提供服务,
# 用 alias 把 /docs/ 前缀剥掉再落到产物目录,否则资源全部 404(白屏)。
location /docs/ {
alias /usr/share/nginx/html/;
try_files $uri $uri.html $uri/ $uri/index.html =404;
}
# 根路径跳到文档入口,避免访问 / 时白屏
location = / {
return 302 /docs/;
}
location / {
try_files $uri $uri.html $uri/ =404;
}