安装部署

本站点为 VitePress 静态站点，构建产物位于 docs/.vitepress/dist，由 Nginx 直接托管。

环境要求

• Node.js 18 及以上
• 首次部署需安装依赖

常用命令

cd /www/wwwroot/vitepress-docs

# 安装依赖
/www/server/nodejs/v22.23.4/bin/npm install

# 本地预览（开发模式）
/www/server/nodejs/v22.23.4/bin/npm run docs:dev

# 构建静态文件
/www/server/nodejs/v22.23.4/bin/npm run docs:build

发布更新

修改文档或配置后，重新执行构建，Nginx 会直接读取新的静态文件，无需重启服务：

cd /www/wwwroot/vitepress-docs
/www/server/nodejs/v22.23.4/bin/npm run docs:build

Nginx 说明

• 根目录指向 docs/.vitepress/dist
• 已开启 cleanUrls，访问路径不带 .html 后缀
• 静态资源缺失时会回退到 404.html

location / {
    try_files $uri $uri.html $uri/ =404;
}