ai-clone/admin/部署说明.md
2026-03-05 14:29:21 +08:00

2.9 KiB
Raw Blame History

管理端部署说明

环境配置

已将生产环境 API 地址修改为:http://115.190.167.176:20002

部署步骤

1. 本地构建

在管理端目录执行:

cd e:\ai-clone\ai-clone\admin
npm run build

构建完成后,会在 dist 目录生成静态文件。

2. 上传到服务器

dist 目录下的所有文件上传到服务器的网站目录:

  • 宝塔面板路径:/www/wwwroot/fh.admin-ai.cloud

3. 宝塔面板配置

3.1 创建网站

  1. 在宝塔面板 -> 网站 -> 添加站点
  2. 域名填写:fh.admin-ai.cloud115.190.167.176
  3. 根目录:/www/wwwroot/fh.admin-ai.cloud
  4. PHP版本纯静态不需要PHP

3.2 配置 Nginx

在网站设置 -> 配置文件中,添加以下配置:

server {
    listen 20002;
    server_name fh.admin-ai.cloud 115.190.167.176;
    
    root /www/wwwroot/fh.admin-ai.cloud;
    index index.html;
    
    # 启用 gzip 压缩
    gzip on;
    gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
    
    # SPA 路由配置
    location / {
        try_files $uri $uri/ /index.html;
    }
    
    # API 代理(可选,如果需要通过同域名访问后端)
    location /api {
        proxy_pass http://127.0.0.1:20002;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
    
    # 静态资源缓存
    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
        expires 1y;
        add_header Cache-Control "public, immutable";
    }
}

3.3 开放端口

在宝塔面板 -> 安全 -> 添加端口规则:

  • 端口:20002
  • 协议:TCP
  • 备注:管理端前端

同时在服务器防火墙(阿里云/腾讯云安全组)中开放 20002 端口。

4. 重启 Nginx

nginx -t  # 测试配置
nginx -s reload  # 重新加载配置

或在宝塔面板中重启 Nginx。

5. 访问测试

访问以下地址测试:

域名配置(可选)

如果要使用域名 fh.admin-ai.cloud 访问:

  1. 在域名服务商处添加 A 记录:

    • 主机记录:fh.admin-ai
    • 记录类型:A
    • 记录值:115.190.167.176
    • TTL默认
  2. 等待 DNS 解析生效(通常几分钟到几小时)

后端 API 配置

确保后端服务运行在 20002 端口,或修改 .env.production 中的 VITE_API_BASE 为实际的后端地址。

常见问题

1. 页面刷新 404

确保 Nginx 配置了 try_files $uri $uri/ /index.html;

2. API 请求失败

检查:

  • 后端服务是否运行
  • 端口是否开放
  • CORS 跨域配置是否正确

3. 静态资源加载失败

检查 vite.config.ts 中的 base 配置,确保路径正确。