skyvern在windows上使用教程及详细操作步骤
Windows 11 是微软全新操作系统,现代化界面,流畅操作体验,适用于学习、工作与日常生活。它更偏向把系统状态查看和常用调节动作放在一起,适合需要持续观察和微调设备状态的场景。
详解如何在Windows环境下使用Docker Compose部署Skyvern。包括LLM密钥配置、本地Web界面登录、API连接检查及首个浏览器自动化任务创建步骤,适合初学者快速上手。
Skyvern 是一款能够自动执行浏览器工作流的工具,支持在 Windows 系统上通过自托管方式运行。对于希望在本机搭建自动化环境的用户,最稳妥的方式是利用 Docker Desktop 启动服务,随后通过浏览器访问本地 Web 界面进行配置和任务管理。以下将按环境准备、配置修改、服务启动及首次使用的顺序,梳理基础操作路径。
关于【Windows运行环境】
在 Windows 上运行 Skyvern 自托管实例,核心依赖是 Docker Desktop。请确保已安装最新版本的 Docker Desktop,并确认 Docker Compose 功能可用。由于 Skyvern 需要同时运行 API 服务、浏览器自动化环境和 PostgreSQL 数据库,对内存有一定要求,建议在启动前关闭其他占用资源较大的程序。
此外,Skyvern 的运行依赖于大语言模型(LLM)服务商的支持。你需要提前准备好可用的 LLM 服务商账号及 API 密钥。这些密钥属于敏感信息,配置时请务必妥善保管,避免直接写入公开代码库或截图中。

Windows环境下Docker Desktop运行状态与终端准备
关于【项目文件与环境变量】
从 Skyvern 官方渠道获取源码或示例文件后,在 Windows 文件资源管理器中定位到项目根目录。你可以右键点击空白处选择“在终端中打开”,或使用 PowerShell 进入该目录。
项目中通常提供名为 .env.example 的示例文件。将其复制并重命名为 .env,这是本地生效的环境配置文件。使用记事本或 VS Code 等文本编辑器打开 .env 文件,填写 LLM 服务商名称及对应的 API 密钥。请注意,配置项名称应以当前项目提供的示例文件为准,不同版本间可能存在差异,不要照抄过时的变量名。
如果前端服务有独立的配置文件,首次启动时建议保留默认的本地地址设置。待服务正常运行后,再根据 Docker Compose 实际分配的内部服务地址进行微调。
关于【Docker Compose服务】
配置好环境变量后,在 PowerShell 中执行以下命令启动服务:
docker compose up -d
该命令会在后台启动 Skyvern API、浏览器运行环境、PostgreSQL 数据库以及 Web 界面等多个容器。首次启动时,系统需要拉取相关镜像并执行数据库初始化迁移,耗时可能较长,请耐心等待。
启动完成后,使用以下命令检查服务状态:
docker compose ps
观察输出结果,确认所有服务的状态均为“Up”或“Healthy”。如果某个服务反复重启或退出,请使用 docker compose logs [服务名] 查看具体错误日志,而不是盲目重复执行启动命令。

编辑.env环境变量配置文件
关于【本地Web界面】
当后端服务稳定运行后,打开 Windows 上的 Chrome 或 Edge 浏览器,访问以下地址:
http://localhost:8080
如果能正常加载页面,说明前端容器已成功启动并可被访问。Skyvern 的 API 服务通常监听在 8000 端口。如果页面无法打开,请检查 Docker 端口映射是否正确,以及 Windows 防火墙是否阻止了本地回环访问。出于安全考虑,切勿将数据库端口直接暴露给公网。
关于【API密钥和首次登录】
自托管实例在首次初始化时,通常会生成默认的管理员凭据或 API 密钥。具体位置请参考项目文档中的说明,一般位于特定的日志输出或初始生成的文件中。
在 Web 界面登录或配置时,如果提示输入 API 地址或密钥,请填写当前实例的本地地址(如 http://localhost:8000)及对应的密钥。注意区分容器内部通信地址与宿主机访问地址,Windows 浏览器访问时应始终使用 localhost 和映射后的端口。

本地浏览器访问Skyvern Web界面
关于【创建一个基础工作流】
成功进入本地界面后,可以尝试创建一个简单的浏览器任务。选择一个无需登录的公开网站作为目标,设定明确的操作目标和完成条件。
初次测试时,避免涉及账号密码输入、支付环节或生产环境数据。先验证 Skyvern 能否正确启动浏览器、识别页面元素并返回预期结果。任务执行过程中,留意界面上的工作流状态和日志输出。若出现页面加载超时或元素定位失败,记录具体错误信息,以便后续排查。

关于【创建一个基础工作流】
关于【Windows浏览器连接】
Skyvern 默认使用容器内嵌的浏览器进行自动化操作。如果有特殊需求必须连接 Windows 主机上安装的 Chrome 浏览器,则需要开启 Chrome 的远程调试模式,并配置 CDP(Chrome DevTools Protocol)连接。
这通常涉及设置 Chrome 启动参数、调整 Docker 网络以允许访问主机 IP,以及配置 Windows 防火墙规则。对于大多数初学者,建议优先使用默认的容器内浏览器,以降低配置复杂度。
关于【停止和重新启动】
当不再需要使用 Skyvern 时,在项目目录下执行以下命令停止并移除容器:
docker compose down
下次使用时,再次运行 docker compose up -d 即可恢复服务。若需实时查看服务日志,可使用:
docker compose logs -f skyvern
修改 .env 或 docker-compose.yml 配置后,可能需要重新创建受影响的服务。每次修改重要配置前,建议备份原始文件,防止误删关键密钥或数据库连接信息。

在Web界面中创建并配置基础工作流
完成上述基础配置后,你应该能够通过浏览器顺利访问本地 Skyvern 界面,并通过简单的工作流验证 API、浏览器和数据库服务的协同工作状态。后续如需接入更多模型或调整高级浏览器参数,可沿用此流程检查环境变量与容器状态。










































