qData 数据中台安装部署手册（Linux 服务器 · 前端）

本文档用于指导在 Linux 服务器上部署 qData 数据中台的前端（基于 Vue 3），通过 Nginx 提供静态资源服务。

---

一、部署前准备

1. 软件依赖环境

• Node.js ≥ 18
• NPM（随 Node.js 安装）
• Nginx ≥ 1.20
• Git（如需拉取代码）

2. 安装校验

node -v       # 确认 Node.js 已安装
npm -v        # 确认 npm 可用
nginx -v      # 确认 Nginx 可用

二、前端项目构建

1. 安装依赖

cd qData/qdata-ui
npm install

2. 构建生产包

npm run build:prod

三、部署至 Nginx

1. 拷贝构建资源

sudo mkdir -p /usr/share/nginx/html/qdata
sudo cp -r dist/* /usr/share/nginx/html/qdata/

2. 配置 Nginx 服务

创建或修改配置文件（如 /etc/nginx/conf.d/qdata.conf）：

server {
listen 80;
server_name your.domain.com;

    location / {
        root /usr/share/nginx/html/qdata;
        index index.html;
        try_files $uri $uri/ /index.html;
    }
}

3. 启动或重载 Nginx

sudo nginx -t                # 检查配置语法
sudo systemctl reload nginx  # 应用配置

四、附注

1、附注说明

• 如需启用 HTTPS，请结合 Nginx 配置证书（推荐使用 Let’s Encrypt 免费证书）；
• 若部署路径非根目录（如 /qdata/），需修改 vite.config.js 中的 base 值为 /qdata/；
• 前端默认使用 history 路由模式，必须配合 Nginx 做 fallback；
• 推荐定期刷新构建结果缓存，可在 Nginx 配置中添加缓存控制头信息。

2. 启用 HTTPS 示例（Let’s Encrypt + Nginx）

server {
    listen 80;
    server_name your.domain.com;

    # HTTP 重定向到 HTTPS
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    server_name your.domain.com;

    ssl_certificate /etc/letsencrypt/live/your.domain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/your.domain.com/privkey.pem;

    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;

    location / {
        root /usr/share/nginx/html/qdata;
        index index.html;
        try_files $uri $uri/ /index.html;
    }
}