移除前端静态HTML页面,迁移至现代化前端框架
This commit is contained in:
124
docs/域名配置说明.md
Normal file
124
docs/域名配置说明.md
Normal file
@@ -0,0 +1,124 @@
|
||||
# 活牛采购智能数字化系统 - 域名配置说明
|
||||
|
||||
## 域名配置总览
|
||||
|
||||
| 域名类型 | 域名地址 | 用途 | 环境 |
|
||||
|---------|---------|------|------|
|
||||
| 后端API | `wapi.nanniwan.com` | 提供RESTful API服务 | 生产环境 |
|
||||
| 管理后台 | `ad.nanniwan.com` | 管理员后台管理系统 | 生产环境 |
|
||||
| 官方网站 | `www.nanniwan.com` | 产品官网和文档 | 生产环境 |
|
||||
| 开发环境 | `localhost:3000` | 本地开发测试 | 开发环境 |
|
||||
| 开发环境 | `localhost:5173` | Vite开发服务器 | 开发环境 |
|
||||
|
||||
## 配置文件更新记录
|
||||
|
||||
### 1. 后端配置更新
|
||||
|
||||
**文件:** `backend/src/config/config.js`
|
||||
- 添加了 `domainConfig` 配置对象
|
||||
- 包含所有生产环境域名配置
|
||||
|
||||
**配置内容:**
|
||||
```javascript
|
||||
const domainConfig = {
|
||||
backend: 'wapi.nanniwan.com',
|
||||
admin: 'ad.nanniwan.com',
|
||||
website: 'www.nanniwan.com'
|
||||
};
|
||||
```
|
||||
|
||||
### 2. CORS配置更新
|
||||
|
||||
**文件:** `backend/src/main.js`
|
||||
- 更新了CORS配置,添加了所有允许的域名
|
||||
- 启用了credentials支持
|
||||
|
||||
**配置内容:**
|
||||
```javascript
|
||||
app.use(cors({
|
||||
origin: [
|
||||
'http://localhost:3000',
|
||||
'http://localhost:5173',
|
||||
'https://wapi.nanniwan.com',
|
||||
'https://ad.nanniwan.com',
|
||||
'https://www.nanniwan.com'
|
||||
],
|
||||
credentials: true
|
||||
}));
|
||||
```
|
||||
|
||||
### 3. API文档更新
|
||||
|
||||
**文件:** `backend/src/docs/api.yaml`
|
||||
- 更新了生产环境服务器URL
|
||||
- 从 `https://api.niumall.com` 改为 `https://wapi.nanniwan.com`
|
||||
|
||||
### 4. 管理后台配置更新
|
||||
|
||||
**文件:** `admin-system/.env.production`
|
||||
- 更新了所有API相关配置
|
||||
- 统一使用 `wapi.nanniwan.com` 域名
|
||||
|
||||
**更新内容:**
|
||||
```bash
|
||||
# API接口地址
|
||||
VITE_API_BASE_URL=https://wapi.nanniwan.com/api
|
||||
|
||||
# WebSocket地址
|
||||
VITE_WS_BASE_URL=wss://wapi.nanniwan.com
|
||||
|
||||
# 上传文件地址
|
||||
VITE_UPLOAD_URL=https://wapi.nanniwan.com/api/upload
|
||||
|
||||
# 静态资源地址
|
||||
VITE_STATIC_URL=https://wapi.nanniwan.com/static
|
||||
|
||||
# 错误日志上报地址
|
||||
VITE_ERROR_LOG_URL=https://wapi.nanniwan.com/api/error-log
|
||||
|
||||
# 性能监控地址
|
||||
VITE_PERFORMANCE_URL=https://wapi.nanniwan.com/api/performance
|
||||
```
|
||||
|
||||
### 5. 官网API文档更新
|
||||
|
||||
**文件:** `website/api.html`
|
||||
- 更新了API基础URL
|
||||
- 从 `https://api.niumall.com/v1` 改为 `https://wapi.nanniwan.com/v1`
|
||||
- 更新了curl示例中的域名
|
||||
|
||||
## 部署注意事项
|
||||
|
||||
1. **DNS配置**:确保所有域名都正确解析到服务器IP地址
|
||||
2. **SSL证书**:为所有生产环境域名配置HTTPS证书
|
||||
3. **Nginx配置**:需要配置反向代理,将请求转发到相应的服务
|
||||
4. **环境变量**:生产环境部署时需要设置正确的环境变量
|
||||
|
||||
## 开发环境配置
|
||||
|
||||
开发环境继续使用localhost地址,配置位于:
|
||||
- `admin-system/.env.development` - 管理后台开发配置
|
||||
- 后端服务默认运行在 `localhost:3000`
|
||||
|
||||
## 验证检查清单
|
||||
|
||||
- [ ] 所有域名能够正常解析
|
||||
- [ ] HTTPS证书配置正确
|
||||
- [ ] CORS配置允许所有需要的域名
|
||||
- [ ] 各服务之间的通信正常
|
||||
- [ ] API文档中的域名已更新
|
||||
- [ ] 管理后台能够正常访问API
|
||||
- [ ] 官网能够正常展示
|
||||
|
||||
## 故障排除
|
||||
|
||||
如果遇到跨域问题,检查:
|
||||
1. CORS配置是否正确
|
||||
2. 域名是否在允许列表中
|
||||
3. HTTPS证书是否有效
|
||||
4. Nginx配置是否正确
|
||||
|
||||
---
|
||||
|
||||
*最后更新:2024年1月20日*
|
||||
*版本:1.0.0*
|
||||
Reference in New Issue
Block a user