安装 Nexus Studio 并运行首次测试

七个步骤带您从开始试用到定时运行。后续章节会详细介绍：下载安装程序、验证安装程序、激活本机、运行测试。测试在您的机器上运行；唯一对外发送的请求是许可证验证。

上手的前 7 分钟

按照 Studio 的操作顺序，从开始试用到定时运行。首次设置会下载浏览器，大小为数百 MB, 因此所需时间取决于您的网络连接。

开始试用并安装。 登录您的账户，接受条款并开始 30 天试用，无需银行卡。下载安装程序，校验其 SHA-256, 运行安装程序并使用许可证密钥激活本机. 然后打开或创建工作区文件夹，在设置指南中选择全部安装 (详情).
录制第一个测试 (Nexus Recorder). 在 Patrol 中打开 Nexus Recorder 选项卡，输入要录制的网址和测试名称，然后选择开始录制. 在打开的浏览器窗口中点击完成操作流程，然后关闭窗口或选择停止 & 保存. Studio 会将测试文件写入您的工作区。如果您更愿意描述测试或导入现有测试，也可以使用 AI 编写工具和 Test Adapter 创建测试。
在沙盒中演练 (运行 3 次). 录制保存后，选择在沙盒中运行，显示浏览器界面. 沙盒运行不会写入任何证据或历史记录，三次演练分别使用不同的浏览器。Patrol 的等待离开沙盒卡片会从 0/3 计数到 3/3, 随后测试会移至已准备好首次正式运行. API 测试没有沙盒：首次点击运行即为正式运行。
首次正式运行。 在运行巡检选项卡中选择测试，保持沙盒未勾选，然后选择正式运行巡检. 正式运行会写入证据和历史记录。Playwright 测试在 Chromium、Firefox 和 WebKit 上运行，Selenium 测试在 Chromium 和 Firefox 上运行。
查看判定结果。 Patrol 根据每项测试在各浏览器中的状态为其标色，编辑器上方的运行状态栏则用文字说明各浏览器正在执行的操作。状态共有 14 种判定结果：SECURE 表示首次运行即通过，FLAKY 表示仅在重试后通过，BREACHED 表示确实发现问题，而 TIMEOUT 表示未在规定时间内响应，并不能证明存在故障。
打开证据。 在菜单栏中，选择视图，然后选择 证据库。每条记录都可查看报告、元数据、遥测和原始日志。将失败标记为 真实缺陷 或误报，并注明原因：首次判定会启动保管链，验证功能会指出首条发生变化的记录。
设置定时运行 (监控或 CI/CD)。 运行巡检选项卡上的监控功能可按定时计划无人值守地重新运行所选测试：间隔可设为 5 分钟至 24 小时，也可在指定日期运行一次。运行 Studio 的计算机必须保持开机；如果已连接 Telegram 或 Slack，则仅在状态变化时发送提醒。对于流水线，选择运行，然后选择 环境 & CI/CD：该界面会生成 GitHub Actions 或 GitLab CI 文件 (从 CI/CD 运行测试)。在 CI 中运行引擎的计算机属于已激活计算机，会占用套餐中的计算机额度。

系统要求

在配备 16 GB 内存的 Windows 11 x64 机器上，只需安装此安装程序即可运行 Playwright 测试。标记为可选的各项组件仅在使用其对应功能时才需要，Studio 的设置界面会检查这些组件。

组件	状态	详情
Windows 11 x64	必需	Nexus Studio 是一款 Windows 桌面应用。每台已激活的机器都会占用您套餐的机器配额：试用版 1 台，Individual 1 台，Team 3 台，Business 10 台（套餐与机器）。
内存	必需	至少需要 16 GB 内存，由 Windows、Studio 和浏览器共享。根据引擎自身的估算，每个浏览器约需 0.5 GB 可用内存，还需为 Windows 和 Studio 保留 1 GB 可用内存：同时运行三个浏览器约需 2.5 GB 可用内存。
磁盘空间	必需	实测：在尚未将 Node.js 加入安装程序的 2026-09-22 构建版本中，Studio、引擎及其程序包占用 207 MB；Playwright 1.62.1 的浏览器组件（Chromium、Chromium headless shell、Firefox、WebKit 和 ffmpeg）占用 1.2 GB。工作区和证据所占空间另计。
Internet	必需	许可证验证需要联网：激活时验证一次，此后每 24 小时验证一次。未能验证时，Studio 可继续工作 7 天，之后显示通知并额外提供 4 天宽限期，然后进入只读模式，直到重新联网（离线工作）。您还需要一个已开通试用或套餐的账号；30 天试用无需提供银行卡。
Nexus Studio 和引擎	已附带	桌面应用及运行测试套件的引擎，包含引擎所需的软件包。
Node.js 24 LTS	已附带	引擎使用安装程序内附的副本运行。无需安装 Node.js。
Playwright 1.62.1	已附带	测试运行器。
Playwright 浏览器	自动安装	Playwright 1.62.1 所需的 Chromium、Firefox 和 WebKit 会在首次本地运行前一次性下载，因此该次运行需要联网。此后，除许可证检查外，工作区可离线运行。
Python 3.10 或更高版本	可选：Python	用于 pytest 套件、Selenium for Python、处理 .py 文件的测试适配器以及录制器的 Python 输出。设置界面会检查版本，并支持一键通过 pip 安装 pytest、pytest-playwright、selenium 和 playwright，以及 Python Playwright 所需的浏览器。
Eclipse Temurin JDK 17	可选：Java	用于使用 JUnit 5 并通过 Maven 构建的 Selenium 测试。设置界面会检查 JDK 和 Maven 版本，并支持一键通过 winget 安装 JDK。实测：占用 313 MB 磁盘空间，运行单个测试占用 180 MB 内存。
.NET SDK 10	可选：C#	用于使用 NUnit 的 Selenium 和 Playwright 测试。设置界面会检查 SDK 版本，并支持一键通过 winget 安装。实测：占用 770 MB 磁盘空间，运行单个测试占用 261 MB 内存。
Google Chrome	可选：Selenium	JavaScript 版 Selenium 4.45.0 驱动 Chrome；Selenium Manager 会查找匹配的驱动程序，首次下载需要联网。也可选择 Firefox，但尚未经实际运行验证。Selenium 不支持 Edge 和 WebKit。
adb 和 scrcpy	可选：Android	adb 用于通过 USB 连接 Android 真机；scrcpy 为可选工具。设置界面可通过 winget 安装这两项工具。必须开启 USB 调试：设备 & 移动端页面提供首次连接手机的指南。
Docker Desktop	可选：Docker 运行环境	使用 WSL 2 后端和 Compose v2，且 Docker 虚拟机至少需要 4 GB 内存。运行器镜像基于 `mcr.microsoft.com/playwright:v1.62.1-noble` (Ubuntu 24.04)。
OpenSSH Client	可选：SSH 运行环境	Windows 可选功能，位于设置、系统、可选功能中。
A VPS	可选：远程运行环境	安装了 Docker Engine 和 Compose v2 的 Ubuntu 24.04 LTS x86_64，通过 SSH 密钥身份验证连接。引擎在该机器上使用相同的容器镜像运行测试套件。

下载安装程序

打开下载页面，选择下载 Windows 版。页面会显示版本、发布日期、大小和 SHA-256。账户中的下载页面也提供同一安装程序。
还没有许可证？使用电子邮箱或 Google 登录账户，在概览页面接受条款并开启 30 天试用。只有激活 Studio 后，30 天试用期才会开始计时。

校验下载文件

下载页面上的 SHA-256 是我们发布的安装程序的指纹。运行下载的文件前，请先进行比对。在 PowerShell 中，进入文件所在文件夹后执行：

(Get-FileHash -Algorithm SHA256 ".\<installer file name>").Hash -eq "<SHA-256 from the Download page>"

True 表示该文件是我们发布的文件；大小写不影响判断。False 则表示不是：请删除该文件并重新下载，不要运行它。

Windows SmartScreen 可能会拦截新的安装程序，并提示“Windows 已保护你的电脑”。只有校验结果为 True 时才可继续：选择更多信息, 然后选择仍要运行。

激活此计算机

运行安装程序，然后打开 Nexus Studio。
复制您的许可证密钥。您的账户只会显示一次密钥：在您开始试用后，或在付费套餐的许可证 & 机器下选择获取许可证密钥时。我们仅保存密钥的哈希值，因此如果您丢失了密钥，请重新生成。
在激活之前，Studio 打开后会显示许可证页面。将密钥粘贴到许可证密钥字段中，然后选择激活。密钥以 nxs_live_ 开头，长度为 61 个字符；复制时带入的空格和换行符会被忽略。
状态显示为已激活。如果使用试用版，30 天试用期即刻开始。

密钥仅发送一次，用于激活这台机器，Studio 不会保存它。此后 Studio 会自动验证许可证。在同一页面的哪些数据会离开这台机器下，您可以看到下次验证将发送的完整请求 (请求包含哪些内容)。

如果激活被拒绝，提示消息会说明原因：密钥无效、套餐中的所有机器名额均已占用、此机器已经试用过、许可证费用未付清或无法连接许可证服务器。

打开工作区并运行设置

这部分操作在您的机器上完成，我们既看不到测试，也看不到结果。

打开文件夹。您的测试和证据都保存在同一个工作区文件夹中。选择新建文件夹和在此创建, 或选择打开现有工作区以打开已有的工作区文件夹。
设置。 工作区使用 npm install 和 playwright install 一次性安装所需的软件包和浏览器。在设置指南中，全部安装 会依次执行尚未完成的步骤，每个必需项都就绪后，继续才会解锁。此过程需要联网；之后，除许可证检查外，工作区可离线使用。只有使用 Android 真机时才需要 adb。
然后开始测试本身。 创建测试、演练、正式运行并查看判定结果：参见最初的 7 分钟中的第 2 至第 6 步。

Studio 导览展示了各个界面。

更新

更新绝不会自动进行：只有选择立即更新后，才会下载或安装。只需单击一次即可完成。

新版本发布后，Studio 会在菜单栏下方显示一行通知： Nexus Studio及版本号、现已可用，并提供立即更新和稍后选项。通知带有签名，随许可证检查一同送达；对于无法验证的更新，Studio 不会显示任何提示。
只有选择立即更新后，才会开始下载。随后 Studio 会通过 HTTPS 从 downloads.sentinel-nexusstudio.com 下载安装程序，并对照已签名的通知校验其 SHA-256。获取通知无需单独建立连接，而下载是许可证检查之外唯一的网络连接。
校验通过后，Studio 会关闭，新版本随即安装，无需回答任何问题，只显示进度条，然后 Studio 会重新打开。校验失败时，文件会被删除，不会安装任何内容，状态行会说明原因，并提供重试选项。
更新后，每个工作区内的引擎副本都会自动升级到新版本。您的测试、证据和设置均不受影响。

运行位置

Studio 在您自己的 Windows 11 电脑上运行，无需其他设备。

您自己的电脑。安装 Studio，打开工作区即可运行。只有电脑处于唤醒状态时，计划任务才会运行。
迷你电脑，可选。一台保持开机的专用 Windows 11 机器，用于夜间回归测试和计划运行，不占用工作站。Watch 按计划运行，证据保存在该机器的磁盘上。
每个工作区独立选择运行环境。 每个工作区都可在 Studio 的 Docker 页面选择引擎运行测试套件的位置：本机; 本机上的 Docker, 即同一磁盘上的运行器容器；或通过 SSH 连接的 VPS, 运行相同的容器镜像。两个工作区中待测的两个应用可以使用不同的运行环境。这三种环境均非必选，切换时只需更改一项设置。Studio 本身始终在 Windows 上运行。
VPS 运行 Ubuntu 24.04 LTS, 安装 Docker Engine 和 Compose v2, 并通过 SSH 密钥认证连接。测试证据会保留在 VPS 上，直到您将其拉取到本地。VPS 会自行检查许可证，并计入您套餐的机器数量：请参阅套餐与机器.
Android 真机通过 USB 连接到运行 Studio 的机器，并需开启 USB 调试；设备 & 移动端部分提供了首次连接指南。手机测试、Selenium 和 Python 测试套件以及基础设施混沌测试始终在运行 Studio 的机器上执行。

调度器 Watch 仅在 Studio 所在的机器上运行，且工作区运行环境须设为 Local. 如需在 VPS 上安排定时运行，请使用您的 CI: 通过 CI/CD 运行测试.

掌控您的基础设施帮助您在这些部署方案中做出选择，并从证据存储位置、访问权限和费用等方面，比较您自己的机器、云端质量保证平台和租用的服务器。

Nexus Studio 如何在不使用隧道的情况下测试 localhost?

你自己的 QA 专用设备。无需隧道，无需暴露预发布环境 URL, 测试数据也不会离开你的网络。可在 Windows 11、Ubuntu 24.04 LTS、Docker 中运行，或通过 SSH 运行。BASE_URL 让测试套件直接指向你在 localhost 或私有预发布 URL 上的应用，无需改动现有环境。

测试结束后仍在运行的开发服务器。
NEXUS_APP_START 会在每次运行前启动应用，并在运行结束、失败或中断时停止应用及其整个进程树，包括按下 Ctrl+C 的情况。
应用根本没启动，测试运行却显示通过。
运行会等待就绪 URL 响应，每 0.5 秒请求一次，任何低于 500 的状态码均可。如果应用无法启动，运行就不会开始： CONFIG_ERROR APP_DID_NOT_START,并附上应用最后 40 行日志。
应用已在运行，却又启动了一个副本。
NEXUS_APP_REUSE=true 会复用已能响应的应用，并让它继续运行； false 则会在该地址有其他程序响应时停止本次运行。
结果无法对应到任何构建。
每次运行都会记录应用在 package.json 中的版本号，以及所测试的 git 提交。
Docker 和 SSH。
使用 Docker 时，应用仍在本机运行，容器通过 host.docker.internal 访问指向 localhost 的 BASE_URL。使用 SSH 时，应用在远程主机上启动。

一个程序及其参数，不经过 shell: npm run dev、pnpm dev 或 node server.js。nexus app check 或 Studio 中的“测试”会启动应用，等待就绪，然后停止应用。完整日志保存在 evidence/run-context/ 中。