mirror of
https://github.com/foxhui/WebAI2API.git
synced 2026-06-16 21:03:59 +08:00
foxhui
91 lines
1.7 KiB
Markdown
91 lines
1.7 KiB
Markdown
# 快速部署
|
|
|
|
本项目支持 **手动部署（推荐）** 和 **Docker 容器化部署** 两种方式。
|
|
|
|
## 手动部署
|
|
|
|
### 1. 克隆项目
|
|
|
|
```bash
|
|
git clone https://github.com/foxhui/WebAI2API.git
|
|
cd WebAI2API
|
|
```
|
|
|
|
### 2. 安装依赖
|
|
|
|
```bash
|
|
# 1. 安装 NPM 依赖
|
|
pnpm install
|
|
# 2. 安装浏览器等预编译依赖
|
|
npm run init
|
|
# 使用代理
|
|
# 直接使用 -proxy 可交互式输入代理配置
|
|
npm run init -- -proxy=http://username:passwd@host:port
|
|
```
|
|
|
|
::: warning 注意
|
|
`npm run init` 需要从 GitHub 下载文件，请确保网络畅通。
|
|
:::
|
|
|
|
### 3. 启动服务
|
|
|
|
```bash
|
|
# 标准启动
|
|
npm start
|
|
# Linux 系统 - 虚拟显示启动
|
|
npm start -- -xvfb -vnc
|
|
# 登录模式 (会临时强行禁用无头模式和自动化)
|
|
npm start -- -login (-xvfb -vnc)
|
|
```
|
|
|
|
## Docker 部署
|
|
|
|
::: warning **安全提醒**
|
|
- Docker 镜像默认开启虚拟显示器 (Xvfb) 和 VNC 服务
|
|
- 可通过 WebUI 的虚拟显示器板块连接
|
|
- **WebUI 传输过程未加密, 公网环境请使用 SSH 隧道或 HTTPS**
|
|
:::
|
|
jj
|
|
### Docker CLI
|
|
|
|
```bash
|
|
docker run -d --name webai-2api \
|
|
-p 3000:3000 \
|
|
-v "$(pwd)/data:/app/data" \
|
|
--shm-size=2gb \
|
|
foxhui/webai-2api:latest
|
|
```
|
|
|
|
### Docker Compose
|
|
|
|
```yaml
|
|
services:
|
|
webai-2api:
|
|
image: foxhui/webai-2api:latest
|
|
container_name: webai-2api
|
|
restart: unless-stopped
|
|
ports:
|
|
- "3000:3000"
|
|
volumes:
|
|
- ./data:/app/data
|
|
shm_size: '2gb'
|
|
init: true
|
|
```
|
|
|
|
启动服务：
|
|
|
|
```bash
|
|
docker compose up -d
|
|
```
|
|
|
|
## 验证安装
|
|
|
|
服务启动后，访问以下地址验证：
|
|
|
|
- **Web 管理界面**: http://localhost:3000
|
|
- **API 接口测试**: http://localhost:3000/v1/chat/completions
|
|
|
|
## 下一步
|
|
|
|
部署完成后，请阅读 [首次使用](/guide/first-use) 完成登录初始化。
|