skyvern在windows上使用教程及详细操作步骤

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、浏览器和数据库服务的协同工作状态。后续如需接入更多模型或调整高级浏览器参数，可沿用此流程检查环境变量与容器状态。