124 lines
2.9 KiB
Markdown
124 lines
2.9 KiB
Markdown
|
# 管理端部署说明
|
|||
|
|
|
|||
|
|
## 环境配置
|
|||
|
|
|
|||
|
|
已将生产环境 API 地址修改为：`http://115.190.167.176:20002`
|
|||
|
|
|
|||
|
|
## 部署步骤
|
|||
|
|
|
|||
|
|
### 1. 本地构建
|
|||
|
|
|
|||
|
|
在管理端目录执行：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
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.cloud` 或 `115.190.167.176`
|
|||
|
|
3. 根目录：`/www/wwwroot/fh.admin-ai.cloud`
|
|||
|
|
4. PHP版本：纯静态（不需要PHP）
|
|||
|
|
|
|||
|
|
#### 3.2 配置 Nginx
|
|||
|
|
|
|||
|
|
在网站设置 -> 配置文件中，添加以下配置：
|
|||
|
|
|
|||
|
|
```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
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
nginx -t # 测试配置
|
|||
|
|
nginx -s reload # 重新加载配置
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
或在宝塔面板中重启 Nginx。
|
|||
|
|
|
|||
|
|
### 5. 访问测试
|
|||
|
|
|
|||
|
|
访问以下地址测试：
|
|||
|
|
- http://fh.admin-ai.cloud:20002
|
|||
|
|
- http://115.190.167.176:20002
|
|||
|
|
|
|||
|
|
## 域名配置（可选）
|
|||
|
|
|
|||
|
|
如果要使用域名 `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` 配置，确保路径正确。
|