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:
@@ -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;
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user