Message-Push-Nest/docs/guide/url-prefix.md

# 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 反向代理配置](/deployment/nginx) 文档。