服务器部署

VitePress 构建结果是纯静态文件，适合直接放在已有服务器上。

构建

bash

npm run docs:build

构建产物位于：

text

docs/.vitepress/dist/

使用 rsync 发布

当前推荐发布到 https://lab.xxm-afu.cn/handbook/。将下面的服务器路径替换为你的真实地址：

bash

rsync -av --delete docs/.vitepress/dist/ user@your-server:/var/www/lab-handbook/

Nginx 示例

nginx

server {
    listen 80;
    server_name lab.xxm-afu.cn www.lab.xxm-afu.cn;

    location = / {
        return 302 /handbook/;
    }

    location = /handbook {
        return 301 /handbook/;
    }

    location /handbook/ {
        alias /var/www/lab-handbook/;
        index index.html;
        try_files $uri $uri.html $uri/ /handbook/index.html;
    }
}

配置完成后，重新加载 Nginx：

bash

sudo nginx -t
sudo systemctl reload nginx

服务器部署 ​

构建 ​

使用 rsync 发布 ​

Nginx 示例 ​

服务器部署

构建

使用 rsync 发布

Nginx 示例