开源RPA平台Skyvern零基础部署指南：从环境准备到自动化流程搭建

一、准备阶段：系统环境配置与依赖检查

1.1 环境要求与预检

在部署Skyvern前，请确认系统满足以下条件：

• 操作系统：Windows 10/11、macOS 10.15+或Linux Ubuntu 18.04+
• Docker环境：已安装Docker Engine 20.10+和Docker Compose v2+
• 硬件资源：至少4GB RAM和20GB可用磁盘空间
• 网络要求：可访问互联网以拉取容器镜像

执行以下环境预检脚本，验证系统兼容性：

# 检查Docker是否安装
docker --version && docker-compose --version

# 验证网络连接
ping -c 3 registry.hub.docker.com

# 检查系统资源
free -h | grep Mem && df -h | grep /var/lib/docker

1.2 项目获取与目录结构

通过Git克隆项目代码库：

git clone https://gitcode.com/GitHub_Trending/sk/skyvern
cd skyvern

核心目录说明：

• skyvern/forge/：包含自动化引擎核心代码
• skyvern/services/：后端服务模块
• skyvern-frontend/：Web前端界面
• docker-compose.yml：服务编排配置文件

1.3 环境变量配置

复制环境变量模板并进行基础配置：

cp env.litellm.example .env

使用文本编辑器打开.env文件，配置必要参数：

• OPENAI_API_KEY：LLM服务访问密钥
• DATABASE_URL：数据库连接字符串（默认使用内置PostgreSQL）
• API_PORT：后端服务端口（默认8000）
• UI_PORT：前端界面端口（默认3000）

二、部署阶段：容器化服务搭建

2.1 Docker镜像构建

执行以下命令构建并启动服务容器：

# 构建镜像（首次运行需10-15分钟）
docker-compose build

# 后台启动服务
docker-compose up -d

服务启动后，可通过以下命令检查容器状态：

docker-compose ps

正常状态下应显示三个运行中的容器：

• skyvern-backend：后端API服务
• skyvern-frontend：Web界面服务
• skyvern-postgres：数据存储服务

2.2 数据库初始化

系统首次启动时需执行数据库迁移：

# 执行数据库迁移脚本
docker-compose exec backend alembic upgrade head

# 创建初始管理员账户
docker-compose exec backend python scripts/create_organization.py

2.3 服务访问验证

服务启动后，通过以下URL访问系统：

• 前端界面：http://localhost:3000
• API文档：http://localhost:8000/docs

三、验证阶段：功能测试与问题排查

3.1 部署验证清单

完成以下检查项确认部署成功：

• [ ] 前端界面可正常加载（http://localhost:3000）
• [ ] API服务返回状态码200（curl http://localhost:8000/health）
• [ ] 数据库连接正常（docker-compose exec postgres psql -U skyvern）
• [ ] 示例工作流可正常导入（访问"Discover"页面）

3.2 基础功能测试

创建第一个自动化任务验证系统功能：

1. 访问前端界面并登录
2. 在"Discover"页面点击"Search for AAPL on Google Finance"模板
3. 点击"Run"按钮执行任务
4. 观察任务执行状态直至完成

3.3 常见问题排查

端口冲突解决： 修改docker-compose.yml中的端口映射：

services:
  frontend:
    ports:
      - "3001:80"  # 将3000改为3001
  backend:
    ports:
      - "8001:8000"  # 将8000改为8001

API密钥错误： 检查.env文件中API密钥配置，通过以下命令查看服务日志：

docker-compose logs -f backend | grep -i "api key"

四、进阶阶段：系统定制与扩展

4.1 工作流开发基础

Skyvern提供可视化工作流编辑器，支持以下核心功能：

• 拖放式流程设计
• 条件分支与循环控制
• 参数化任务配置
• 实时执行监控

4.2 自定义脚本开发

通过修改skyvern/forge/prompts/目录下的模板文件，定制LLM提示策略。例如：

# 复制基础模板进行修改
cp skyvern/forge/prompts/basic_prompt.j2 skyvern/forge/prompts/custom_prompt.j2

4.3 性能优化建议

针对大规模自动化任务，可调整以下配置：

• 在.env文件中增加WORKER_COUNT参数调整并发数
• 修改skyvern/config.py中的资源限制设置
• 配置外部Redis缓存提高任务处理效率

结语

通过本文档的四阶段部署流程，您已完成Skyvern开源RPA平台的基础搭建。该平台通过skyvern/webeye/模块实现浏览器自动化，结合skyvern/forge/的LLM集成能力，可快速构建企业级自动化流程。如需进一步扩展功能，可参考项目中的docs/目录获取完整文档。