WebAI2API

环境要求

• Node.js 环境与 pnpm 包管理器（源码部署需执行 pnpm install）
• 网络可访问 GitHub，用于 npm run init 下载浏览器预编译资源
• Linux 系统需安装 xvfb、x11vnc、libgtk-3-0、libx11-xcb1、libasound2 等依赖
• 硬件最低 1 核 CPU / 1GB 内存 / 2GB 磁盘，推荐 2 核 2GB 以上、5GB 磁盘
• 使用 Docker 方式需已安装 Docker（及可选 docker-compose）

安装与启动步骤

1. 1获取项目源码

   从 GitHub 克隆 WebAI2API 仓库到本地，源码方式部署时使用。

   git clone https://github.com/foxhui/WebAI2API.git

   复制

2. 2安装 NPM 依赖

   进入项目根目录后执行，安装项目所需的 Node 依赖。

   pnpm install

   复制

3. 3安装浏览器依赖

   下载 Camoufox 等预编译资源，脚本需连接 GitHub；网络受限可加 -proxy 参数指定代理。

   npm run init

   复制

4. 4安装 Linux 依赖

   非桌面版 Linux 需补齐虚拟显示与图形库，其他发行版请自行查找对应包名。

   apt install -y xvfb x11vnc libgtk-3-0 libx11-xcb1 libasound2

   复制

5. 5启动源码服务

   标准启动；Linux 虚拟显示用 npm start -- -xvfb -vnc，登录模式用 npm start -- -login。

   npm start

   复制

6. 6Docker 启动服务

   映射 3000 端口并挂载 data 目录，共享内存 2GB；也可在项目目录执行 docker-compose up -d。

   docker run -d --name webai-2api -p 3000:3000 -v "$(pwd)/data:/app/data" --shm-size=2gb foxhui/webai-2api:latest

   复制

7. 7调整配置文件

   首次运行会从 config.example.yaml 复制到 data/config.yaml，修改后必须重启程序才生效。

关键配置

如何确认成功

浏览器访问 http://localhost:3000 能打开 WebUI，且请求 GET /v1/models 能返回可用模型列表即部署成功。

常见问题

注意事项

• Docker 镜像默认开启虚拟显示器（Xvfb）和 VNC 服务，可通过 WebUI 的虚拟显示器板块连接。
• 为降低风控，强烈建议长期保持非无头模式运行，或使用 Xvfb 虚拟显示。
• 登录网站账号时可使用 npm start -- -login，该模式会临时强行禁用无头模式和自动化。
• 1 核 1GB 的机器资源紧张、比较卡顿，仅适合尝鲜或轻度使用。