WebAI2API：将网页版 AI 转换为兼容 OpenAI 协议的 API 工具

💡 注：带水滴图标表示可能存在使用限制或需特定环境。

部署教程

项目地址：https://github.com/foxhui/WebAI2API

方式一：手动部署

克隆项目

首先从 GitHub 拉取代码到本地：

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

调整配置文件

程序初次运行会从 config.example.yaml 复制配置文件到 data/config.yaml。建议先手动配置好再启动。

server: # 监听端口
  port: 3000
# 鉴权 API Token (可使用 npm run genkey 生成)
# 该配置会对 API 接口和 WebUI 生效
auth:
  sk-change-me-to-your-secure-key

安装与配置

需要安装 NPM 依赖以及浏览器等预编译资源。注意，初始化脚本可能需要连接 GitHub 下载资源，若网络受限请配置代理。

# 1. 安装 NPM 依赖
pnpm install

# 2. 安装浏览器等预编译依赖
npm run init
# 使用代理示例
npm run init -- -proxy=http://username:passwd@host:port

# 3. Linux 依赖安装
apt install -y xvfb x11vnc libgtk-3-0 libx11-xcb1 libasound2

启动服务

根据环境选择启动命令。Linux 系统下推荐使用虚拟显示模式。

# 标准启动
npm start

# Linux 系统 - 虚拟显示启动
npm start -- -xvfb -vnc

# 登录模式 (会临时强行禁用无头模式和自动化)
npm start -- -login (-xvfb -vnc)

方式二：Docker 部署

安全提醒

• Docker 镜像默认开启虚拟显示器 (Xvfb) 和 VNC 服务。
• 可通过 WebUI 的虚拟显示器板块连接。
• WebUI 传输过程未加密，公网环境请务必使用 SSH 隧道或 HTTPS。

Docker CLI 启动

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

Docker Compose 启动

docker-compose up -d

更多配置内容和用法可参考官方文档：https://foxhui.github.io/WebAI2API/