91 lines
2.5 KiB
Markdown
91 lines
2.5 KiB
Markdown
# 图片上传远程模式配置
|
||
|
||
## 问题描述
|
||
|
||
用户在本地开发环境（localhost:8089）上传图片时，返回的图片URL是错误的：
|
||
- 错误URL: `http://localhost:8080/uploads/...`
|
||
- 应该是: `https://px.ddn-ai.cloud/uploads/...`
|
||
|
||
## 原因分析
|
||
|
||
配置文件 `application.yml` 中的上传模式设置为 `local`，导致：
|
||
1. 文件保存到本地 `C:/peidu-uploads/`
|
||
2. 返回的URL是本地地址 `http://localhost:8089/uploads/...`
|
||
|
||
但用户需求是：
|
||
- 本地开发环境上传到**远程服务器**
|
||
- 返回远程服务器的URL
|
||
|
||
## 解决方案
|
||
|
||
### 1. 修改 application.yml 配置
|
||
|
||
```yaml
|
||
file:
|
||
upload:
|
||
# 上传模式改为 remote
|
||
mode: remote
|
||
# 远程上传接口地址
|
||
remote:
|
||
url: https://px.ddn-ai.cloud/api/file/upload/direct
|
||
timeout: 30
|
||
# 访问URL前缀改为远程地址
|
||
url-prefix: https://px.ddn-ai.cloud/uploads/
|
||
```
|
||
|
||
### 2. 工作流程
|
||
|
||
**远程上传模式流程：**
|
||
```
|
||
前端 → 本地后端(8089) → 远程服务器(px.ddn-ai.cloud)
|
||
↓
|
||
通过HTTP POST上传文件到远程
|
||
↓
|
||
远程服务器保存文件并返回URL
|
||
↓
|
||
本地后端返回远程URL给前端
|
||
```
|
||
|
||
### 3. 远程服务器要求
|
||
|
||
远程服务器必须部署并启用 `/api/file/upload/direct` 接口：
|
||
- 接收文件上传
|
||
- 保存到 `/www/wwwroot/px.ddn-ai.cloud/Image/`
|
||
- 返回可访问的URL: `https://px.ddn-ai.cloud/uploads/文件名`
|
||
|
||
### 4. 部署步骤
|
||
|
||
1. **重新编译后端**
|
||
```bash
|
||
cd peidu/backend
|
||
mvn clean package -DskipTests
|
||
```
|
||
|
||
2. **重启本地后端服务**
|
||
- 停止当前运行的后端
|
||
- 重新启动（会自动加载新配置）
|
||
|
||
3. **测试上传**
|
||
- 在管理后台上传图片
|
||
- 检查返回的URL是否为 `https://px.ddn-ai.cloud/uploads/...`
|
||
|
||
## 注意事项
|
||
|
||
1. **远程服务器必须可访问**：确保 `https://px.ddn-ai.cloud` 可以正常访问
|
||
2. **远程接口必须部署**：`/api/file/upload/direct` 接口必须在远程服务器上运行
|
||
3. **网络连接**：本地环境需要能够访问远程服务器
|
||
4. **超时设置**：如果网络较慢，可以增加 `timeout` 值
|
||
|
||
## 配置对比
|
||
|
||
| 配置项 | 本地模式 | 远程模式 |
|
||
|--------|---------|---------|
|
||
| mode | local | remote |
|
||
| 文件保存位置 | C:/peidu-uploads/ | 远程服务器 |
|
||
| url-prefix | http://localhost:8089/uploads/ | https://px.ddn-ai.cloud/uploads/ |
|
||
| 适用场景 | 本地测试 | 开发环境连接生产服务器 |
|
||
|
||
## 日期
|
||
|
||
2026-01-26
|