Web 管理界面

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

注意

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

访问地址

http://localhost:3000

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

功能模块

仪表盘

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

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

系统管理

系统管理页面提供：

• 服务控制

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

• 缓存管理

  • 查看临时文件
  • 清理缓存

• 数据管理

  • 查看浏览器数据目录
  • 删除未使用的数据目录

VNC 显示

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

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

说明

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

配置管理

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

实例管理

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

快捷操作

登录模式重启

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

清理缓存

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