首次使用

首次使用 WebAI2API 时，需要完成登录初始化才能正常使用。

1. 调整配置文件

程序初次运行会从config.example.yaml复制配置文件到data/config.yaml

小贴士

配置文件的生效需要重启程序！

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

2. 访问 Web 管理界面

服务启动后, 打开浏览器访问:

http://localhost:3000

小贴士

远程访问: 将 localhost 替换为服务器 IP 地址即可远程访问。 API Token: 配置文件中的auth所配置的鉴权密钥。 安全建议: 公网环境建议使用 Nginx/Caddy 配置 HTTPS 或通过 SSH 隧道访问。

3. 初始化账号登录

IMPORTANT

首次使用必须完成以下初始化步骤:

1. 连接虚拟显示器:

   • Linux/Docker: 在 WebUI 的"虚拟显示器"板块连接
   • Windows: 直接在弹出的浏览器窗口中操作

2. 完成账号登录:

   • 手动登录所需的 AI 网站账号 (账号要求可进入 WebUI 的适配器管理中查看)
   • 在输入框发送任意消息, 触发并完成人机验证 (如需要)
   • 同意服务条款或者新手指引 (如需要)
   • 确保不再有初次使用相关内容的阻拦

3. SSH 隧道连接示例(公网服务器推荐):

   # 在本地终端运行,将服务器的 WebUI 映射到本地
   ssh -L 3000:127.0.0.1:3000 root@服务器IP
   
   # 然后在本地访问
   # WebUI: http://localhost:3000

运行建议

为降低风控, 强烈建议长期保持非无头模式运行(或使用虚拟显示器 Xvfb)。

关于有头/无头模式:

• 有头模式(默认): 显示浏览器窗口, 便于调试和人工干预
• 无头模式: 后台运行, 节省资源但无法查看浏览器界面, 且可能会被网站检测

登录模式

登录模式会强制关闭无头模式

基础用法

# 启动第一个 Worker 进行登录
npm start -- -login

多 Worker 登录

如果配置了多个 Worker，需要分别为每个 Worker 完成登录：

# 依次登录各个 Worker
npm start -- -login=worker1
npm start -- -login=worker2

共享登录状态

同一 Instance（浏览器实例）下的多个 Worker 共享登录状态。如果使用 Google OAuth 等统一登录方式，只需登录一次即可。

WebUI 登录模式

服务运行后，也可以通过 WebUI 切换到登录模式：

1. 访问 http://localhost:3000
2. 进入「系统管理」页面
3. 点击「重启」按钮的下拉箭头
4. 选择「登录模式重启」或指定 Worker 登录

4.下一步

登录完成后，请阅读以下内容：

• 配置文件 - 了解完整配置选项
• API 参考 - 开始使用 API