Dai0814
07ddaa9968
- 新增 docs/deploy/ 部署手册：推荐环境（Node 22 / nginx / Docker）、 编译方法（npm ci + build）、四类部署方式（Docker+nginx 推荐路径、 静态服务器、对象存储/CDN、内网离线），含路径前缀要点与环境对照表 - 修复 docker/nginx.conf：base=/docs/ 使产物资源引用为绝对路径， 原配置从根路径服务导致资源全部 404（白屏）。改用 alias 剥离前缀， 并加 / -> /docs/ 重定向 - README 补部署指引与路径前缀告警，修正 dev 入口地址为 /docs/ - 导航与首页增加「部署手册」入口
25 lines
693 B
Nginx Configuration File
25 lines
693 B
Nginx Configuration File
server {
|
||
listen 80;
|
||
server_name _;
|
||
|
||
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;
|
||
}
|
||
}
|