mirror of
https://github.com/foxhui/WebAI2API.git
synced 2026-06-16 21:03:59 +08:00
foxhui
108 lines
2.9 KiB
Markdown
108 lines
2.9 KiB
Markdown
# 首次使用
|
|
|
|
首次使用 WebAI2API 时，需要完成登录初始化才能正常使用。
|
|
|
|
## 1. 调整配置文件
|
|
|
|
程序初次运行会从`config.example.yaml`复制配置文件到`data/config.yaml`
|
|
|
|
::: tip 小贴士
|
|
**配置文件的生效需要重启程序！**
|
|
:::
|
|
|
|
```yaml
|
|
server:
|
|
# 监听端口
|
|
port: 3000
|
|
# 鉴权 API Token (可使用 npm run genkey 生成)
|
|
# 该配置会对 API 接口和 WebUI 生效
|
|
auth: sk-change-me-to-your-secure-key
|
|
```
|
|
|
|
## 2. 访问 Web 管理界面
|
|
|
|
服务启动后, 打开浏览器访问:
|
|
```
|
|
http://localhost:3000
|
|
```
|
|
|
|
::: tip 小贴士
|
|
**远程访问**: 将 `localhost` 替换为服务器 IP 地址即可远程访问。
|
|
**API Token**: 配置文件中的`auth`所配置的鉴权密钥。
|
|
**安全建议**: 公网环境建议使用 Nginx/Caddy 配置 HTTPS 或通过 SSH 隧道访问。
|
|
:::
|
|
|
|
|
|
## 3. 初始化账号登录
|
|
|
|
> [!IMPORTANT]
|
|
> **首次使用必须完成以下初始化步骤**:
|
|
|
|
1. **连接虚拟显示器**:
|
|
- Linux/Docker: 在 WebUI 的"虚拟显示器"板块连接
|
|
- Windows: 直接在弹出的浏览器窗口中操作
|
|
|
|
2. **完成账号登录**:
|
|
- 手动登录所需的 AI 网站账号 (账号要求可进入 WebUI 的适配器管理中查看)
|
|
- 在输入框发送任意消息, 触发并完成人机验证 (如需要)
|
|
- 同意服务条款或者新手指引 (如需要)
|
|
- 确保不再有初次使用相关内容的阻拦
|
|
|
|
3. **SSH 隧道连接示例**(公网服务器推荐):
|
|
```bash
|
|
# 在本地终端运行,将服务器的 WebUI 映射到本地
|
|
ssh -L 3000:127.0.0.1:3000 root@服务器IP
|
|
|
|
# 然后在本地访问
|
|
# WebUI: http://localhost:3000
|
|
```
|
|
|
|
::: tip 运行建议
|
|
为降低风控, **强烈建议长期保持非无头模式运行**(或使用虚拟显示器 Xvfb)。
|
|
|
|
**关于有头/无头模式**:
|
|
- **有头模式**(默认): 显示浏览器窗口, 便于调试和人工干预
|
|
- **无头模式**: 后台运行, 节省资源但无法查看浏览器界面, 且可能会被网站检测
|
|
:::
|
|
|
|
## 登录模式
|
|
|
|
登录模式会强制关闭无头模式
|
|
|
|
### 基础用法
|
|
```bash
|
|
# 启动第一个 Worker 进行登录
|
|
npm start -- -login
|
|
|
|
```
|
|
|
|
### 多 Worker 登录
|
|
|
|
如果配置了多个 Worker，需要分别为每个 Worker 完成登录：
|
|
|
|
```bash
|
|
# 依次登录各个 Worker
|
|
npm start -- -login=worker1
|
|
npm start -- -login=worker2
|
|
```
|
|
|
|
::: info 共享登录状态
|
|
同一 Instance（浏览器实例）下的多个 Worker 共享登录状态。如果使用 Google OAuth 等统一登录方式，只需登录一次即可。
|
|
:::
|
|
|
|
### WebUI 登录模式
|
|
|
|
服务运行后，也可以通过 WebUI 切换到登录模式：
|
|
|
|
1. 访问 http://localhost:3000
|
|
2. 进入「系统管理」页面
|
|
3. 点击「重启」按钮的下拉箭头
|
|
4. 选择「登录模式重启」或指定 Worker 登录
|
|
|
|
## 4.下一步
|
|
|
|
登录完成后，请阅读以下内容：
|
|
|
|
- [配置文件](/config/overview) - 了解完整配置选项
|
|
- [API 参考](/api/overview) - 开始使用 API
|