77 lines
1.7 KiB
Markdown
77 lines
1.7 KiB
Markdown
# URL 路径前缀配置
|
|
|
|
Message-Nest 支持配置 URL 路径前缀，允许您在子路径下部署应用。
|
|
|
|
## 配置方式
|
|
|
|
### 方式 1: 配置文件
|
|
|
|
在 `conf/app.ini` 中添加：
|
|
|
|
```ini
|
|
[server]
|
|
UrlPrefix = /message
|
|
```
|
|
|
|
### 方式 2: 环境变量
|
|
|
|
设置环境变量：
|
|
|
|
```bash
|
|
export URL_PREFIX=/message
|
|
```
|
|
|
|
## 使用说明
|
|
|
|
1. **配置前缀**：在配置文件或环境变量中设置 `UrlPrefix`
|
|
2. **重启服务**：修改配置后需要重启 Message-Nest 服务
|
|
3. **访问应用**：使用新的 URL 访问，例如：`http://your-domain.com/message`
|
|
|
|
## 示例
|
|
|
|
### 默认访问（无前缀）
|
|
```
|
|
http://localhost:8000/
|
|
http://localhost:8000/api/v1/sendways/list
|
|
```
|
|
|
|
### 配置前缀后
|
|
```ini
|
|
[server]
|
|
UrlPrefix = /message
|
|
```
|
|
|
|
访问地址变为：
|
|
```
|
|
http://localhost:8000/message/
|
|
http://localhost:8000/message/api/v1/sendways/list
|
|
```
|
|
|
|
## 注意事项
|
|
|
|
- 前缀会自动添加 `/` 前缀（如果没有的话）
|
|
- 前端静态资源会自动使用相对路径，无需额外配置
|
|
- API 请求会自动添加路径前缀
|
|
- 修改配置后必须重启服务才能生效
|
|
|
|
## Nginx 反向代理示例
|
|
|
|
如果使用 Nginx 反向代理，配置示例：
|
|
|
|
```nginx
|
|
location /message/ {
|
|
proxy_pass http://localhost:8000/message/;
|
|
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;
|
|
}
|
|
```
|
|
|
|
## 技术实现
|
|
|
|
- 后端使用 Gin 的路由组（RouterGroup）实现路径前缀
|
|
- 前端使用 Vite 的 `base: './'` 配置生成相对路径
|
|
- 后端在 HTML 中注入 `<base>` 标签和配置脚本
|
|
- 前端 API 请求自动添加路径前缀
|