# Web 管理界面

WebAI2API 提供了内置的 Web 管理界面，用于监控和管理服务。

::: warning 注意
WebUI 以及管理接口仅在握手阶段使用 API Token 验证，传输阶段无任何加密，如果您在公网环境使用，请使用 Caddy 或 Nginx 等专业的网站服务器对连接进行 HTTPS 加密！
:::

## 访问地址

```
http://localhost:3000
```

首次访问需要输入配置文件中设置的 API Token 进行认证，API Token 即配置文件中`auth`所配置的鉴权密钥。

## 功能模块

### 仪表盘

仪表盘页面显示系统运行状态：

- **系统状态**：版本、运行时间、运行模式
- **业务统计**：窗口数量、实例数量
- **队列状态**：处理中/等待中的任务列表

### 系统管理

系统管理页面提供：

- **服务控制**
  - 普通重启
  - 登录模式重启
  - 指定 Worker 登录
  - 停止服务
  - 适配器设置 (适配器描述，模型管理，功能开关)

- **缓存管理**
  - 查看临时文件
  - 清理缓存

- **数据管理**
  - 查看浏览器数据目录
  - 删除未使用的数据目录

### VNC 显示

在 Linux 环境下使用 `-xvfb -vnc` 启动时，可以通过 WebUI 直接查看和操作虚拟显示器：

- 连接/断开 VNC
- 全屏显示
- 查看 VNC 状态信息

::: tip 说明
VNC 显示功能需要服务以 Xvfb + VNC 模式运行。
:::

### 配置管理

- **服务器配置**：端口、认证、心跳设置
- **适配器配置**：各后端的专属配置
- **浏览器设置**：路径、无头模式、代理

### 实例管理

管理浏览器实例和 Worker 配置（需要重启生效）。

## 快捷操作

### 登录模式重启

1. 进入「缓存与重启」页面
2. 点击「重启」按钮旁的下拉箭头
3. 选择重启模式：
   - **普通重启**：正常模式重启
   - **登录模式重启**：以 `-login` 参数重启
   - **指定 Worker 登录**：选择特定 Worker 进入登录模式

### 清理缓存

1. 进入「缓存与重启」页面
2. 找到「缓存管理」区域
3. 点击「清理缓存」按钮
