Nexus Studio 설치 및 첫 테스트 실행

체험 시작부터 예약 실행까지 일곱 단계면 됩니다. 이어지는 섹션에서는 설치 파일 다운로드, 파일 검증, 이 장비 활성화, 테스트 실행을 자세히 안내합니다. 테스트는 자신의 장비에서 실행되며; 외부로 나가는 것은 라이선스 확인 요청뿐입니다.

처음 7분

Studio에서 안내하는 순서대로 체험 시작부터 예약 실행까지 진행합니다. 최초 설정 시 수백 MB에 달하는 브라우저를 다운로드하므로, 소요 시간은 연결 속도에 따라 달라집니다.

체험을 시작하고 설치하세요. 계정에 로그인하고 약관에 동의한 뒤 카드 등록 없이 30일 체험을 시작하세요. 설치 파일을 다운로드하고, SHA-256을 확인한 다음, 실행하여 라이선스 키로 이 장비를 활성화하세요. 그런 다음 작업 공간 폴더를 열거나 만들고 설정 안내에서 모두 설치를 선택하세요 (자세히 보기).
첫 테스트를 기록하세요 (Nexus Recorder). Patrol에서 Nexus Recorder 탭을 열고 기록할 URL과 테스트 이름을 입력한 다음 기록 시작을 선택하세요. 열린 브라우저 창에서 테스트할 흐름에 따라 클릭한 뒤 창을 닫거나 중지 & 저장을 선택하세요. Studio가 작업 공간에 테스트 파일을 작성합니다. 테스트를 설명해서 만들거나 기존 테스트를 가져오고 싶다면 AI 작성 도구나 Test Adapter로도 테스트를 만들 수 있습니다.
샌드박스에서 예행 실행하세요 (3회 실행). 기록을 저장한 뒤 샌드박스에서 실행, 브라우저 표시를 선택하세요. 샌드박스 실행은 증거 자료나 이력에 아무것도 남기지 않으며, 세 번의 예행 실행은 각각 다른 브라우저를 사용합니다. Patrol의 샌드박스 종료 대기 중 카드에서 횟수가 0/3부터 3/3까지 표시된 뒤, 테스트가 첫 실제 실행 준비 완료로 이동합니다. API 테스트에는 샌드박스가 없습니다: 처음 누를 때부터 실제로 실행됩니다.
첫 실제 실행. Patrol 실행 탭에서 테스트를 고르고, 샌드박스를 선택하지 않은 상태로 Patrol 실제 실행을 선택하세요. 실제 실행은 증거 자료와 이력을 남깁니다. Playwright 테스트는 Chromium, Firefox 및 WebKit에서 실행되고, Selenium 테스트는 Chromium과 Firefox에서 실행됩니다.
판정 결과를 확인하세요. Patrol은 브라우저별 상태에 따라 각 테스트를 색상으로 표시하며, 편집기 위의 실행 표시줄은 각 브라우저의 동작을 글로 알려 줍니다. 상태는 14가지 판정 중 하나입니다: SECURE는 재시도 없이 통과, FLAKY는 재시도 후에만 통과, BREACHED는 실제 문제 발견을 뜻하며, TIMEOUT은 제시간에 응답하지 않았다는 뜻으로, 문제가 있다는 증거는 아닙니다.
증거를 여세요. 메뉴 모음에서 보기, 증거 보관함을 차례로 선택하세요. 각 기록에는 보고서, 메타데이터, 원격 측정 데이터, 원시 로그가 표시됩니다. 실패를 실제 버그 또는 오탐으로 표시하고 이유를 남기세요: 첫 판정부터 증거 관리 이력이 시작되며, 검증 기능은 변경된 첫 기록을 알려 줍니다.
예약하세요 (Watch 또는 CI/CD). 순찰 실행 탭의 Watch는 선택한 항목을 타이머에 따라 무인으로 다시 실행합니다: 5분~24시간 간격으로 반복하거나 지정한 날짜에 한 번 실행할 수 있습니다. Studio가 설치된 컴퓨터가 켜져 있어야 하며, Telegram이나 Slack을 연결하면 상태가 바뀔 때만 알림을 보냅니다. 파이프라인에 사용하려면 실행, 환경 & CI/CD를 차례로 선택하세요: 이 화면에서 GitHub Actions 또는 GitLab CI 파일을 생성합니다 (CI/CD에서 테스트 실행하기). CI에서 엔진을 실행하는 컴퓨터는 활성화된 컴퓨터로 간주되며 요금제의 컴퓨터 수에 포함됩니다.

시스템 요구 사항

RAM이 16 GB인 Windows 11 x64 컴퓨터에서는 설치 프로그램만으로 Playwright 테스트 실행에 필요한 준비를 모두 마칠 수 있습니다. 선택 사항으로 표시된 각 항목은 해당 기능을 사용할 때만 필요하며, Studio의 설정 화면에서 확인할 수 있습니다.

구성 요소	상태	세부 정보
Windows 11 x64	필수	Nexus Studio는 Windows 데스크톱 앱입니다. 활성화한 각 컴퓨터는 요금제의 허용 대수에 포함됩니다: 체험판 1대, Individual 1대, Team 3대, Business 10대 (요금제 및 컴퓨터).
메모리	필수	최소 16 GB의 RAM이 필요합니다. 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로 실행됩니다. Node.js를 따로 설치할 필요가 없습니다.
Playwright 1.62.1	기본 포함	테스트 실행기.
Playwright 브라우저	자동 설치	Playwright 1.62.1용 Chromium, Firefox 및 WebKit은 최초 로컬 실행 전에 한 번 다운로드되므로, 이때는 인터넷 연결이 필요합니다. 이후에는 라이선스 확인을 제외하고 작업 공간이 오프라인으로 실행됩니다.
Python 3.10 이상	선택 사항: Python	pytest 테스트 모음, Python용 Selenium, .py 파일에 대한 Test Adapter 및 Recorder의 Python 출력에 사용됩니다. 설정 화면에서 버전을 확인하고, 클릭 한 번으로 pip를 통해 pytest, pytest-playwright, selenium, playwright를 설치하며 Python용 Playwright 브라우저도 설치합니다.
Eclipse Temurin JDK 17	선택 사항: Java	Maven으로 빌드하는 JUnit 5 기반 Selenium 테스트에 사용됩니다. 설정 화면에서 JDK와 Maven 버전을 확인하고, 클릭 한 번으로 winget을 통해 JDK를 설치합니다. 측정값: 디스크 공간 313 MB, 테스트 하나 실행 시 RAM 180 MB.
.NET SDK 10	선택 사항: C#	NUnit 기반 Selenium 및 Playwright 테스트에 사용됩니다. 설정 화면에서 SDK 버전을 확인하고, 클릭 한 번으로 winget을 통해 설치합니다. 측정값: 디스크 공간 770 MB, 테스트 하나 실행 시 RAM 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, 메모리가 4 GB 이상인 Docker VM을 사용합니다. 실행기 이미지는 `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일 체험을 시작하세요. 30일은 Studio를 활성화한 시점부터 계산됩니다.

다운로드한 파일 확인

다운로드 페이지의 SHA-256은 당사가 배포한 설치 프로그램을 식별하는 고유 값입니다. 다운로드한 파일을 실행하기 전에 이 값과 비교하세요. PowerShell에서 파일이 있는 폴더로 이동한 뒤:

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

True는 저희가 배포한 파일이 맞다는 뜻이며, 대소문자는 구분하지 않습니다. False는 해당 파일이 아니라는 뜻입니다: 파일을 삭제하고 다시 다운로드하세요. 실행하지 마세요.

Windows SmartScreen이 “Windows의 PC 보호” 메시지를 표시하며 새 설치 프로그램의 실행을 차단할 수 있습니다. 확인 결과가 True일 때만 다음과 같이 진행하세요: 추가 정보를 선택한 다음 실행을 선택하세요.

이 컴퓨터 활성화

설치 프로그램을 실행한 다음 Nexus Studio를 여세요.
라이선스 키를 복사하세요. 계정에는 체험을 시작한 직후 또는 유료 요금제에서 라이선스 & 컴퓨터 아래의 라이선스 키 받기를 선택했을 때 한 번만 표시됩니다. 저희는 키의 해시만 보관하므로, 키를 분실했다면 다시 생성하세요.
활성화하기 전까지 Studio는 라이선스 화면으로 열립니다. 라이선스 키 입력란에 키를 붙여넣고 활성화를 선택하세요. 키는 nxs_live_로 시작하며 길이는 61자입니다; 복사할 때 포함된 공백과 줄바꿈은 무시됩니다.
상태가 활성으로 표시됩니다. 체험판의 경우 지금부터 30일이 시작됩니다.

이 컴퓨터를 활성화하기 위해 키가 한 번 전송되며, Studio는 키를 보관하지 않습니다. 이후에는 Studio가 자체적으로 라이선스를 확인합니다. 같은 화면의 이 컴퓨터에서 외부로 전송되는 정보 아래에서 다음 확인 시 전송될 요청의 정확한 내용을 볼 수 있습니다 (포함되는 정보).

활성화가 거부되면 메시지에 이유가 표시됩니다: 유효하지 않은 키, 요금제에서 허용하는 모든 기기가 사용 중, 이미 체험판을 사용한 기기, 라이선스 요금 미납 또는 라이선스 서버에 연결할 수 없음.

작업 공간을 열고 설정 실행

이 과정은 사용자의 컴퓨터에서 이루어지며, 저희는 테스트도 결과도 볼 수 없습니다.

폴더를 여세요. 테스트와 증거 자료는 하나의 작업 공간 폴더에 저장됩니다. 새 폴더와 여기에 만들기를 선택하거나, 이미 작업 공간인 폴더가 있다면 기존 폴더 열기를 선택하세요.
설정. 작업 공간은 npm install과 playwright install로 패키지와 브라우저를 한 번 설치합니다. 설정 안내에서 모두 설치를 누르면 아직 설치되지 않은 항목을 차례로 설치하며, 필수 항목이 모두 준비되면 계속 버튼이 활성화됩니다. 이 과정에는 네트워크가 필요합니다; 이후에는 라이선스 확인을 제외하고 작업 공간을 오프라인으로 사용할 수 있습니다. adb는 실제 Android 휴대폰을 사용할 때만 필요합니다.
이제 테스트할 차례입니다. 테스트를 만들고, 예행 실행을 하고, 실제로 실행한 뒤 판정 결과를 확인하세요: 처음 7분 동안 할 일의 2~6단계입니다.

Studio 둘러보기에서 모든 화면을 살펴볼 수 있습니다.

업데이트

업데이트는 절대 자동으로 진행되지 않습니다: 지금 업데이트를 선택하기 전에는 아무것도 다운로드하거나 설치하지 않습니다. 선택한 뒤에는 한 번의 클릭이면 충분합니다.

새 버전이 출시되면 Studio 메뉴 표시줄 아래에 Nexus Studio와 버전, 사용 가능이라는 문구가 지금 업데이트 및 나중에와 함께 표시됩니다. 알림은 라이선스 확인 시 서명된 상태로 전달됩니다; Studio는 검증할 수 없는 업데이트에 대해서는 아무것도 표시하지 않습니다.
지금 업데이트를 선택하기 전에는 아무것도 다운로드하지 않습니다. 선택하면 Studio가 downloads.sentinel-nexusstudio.com에서 HTTPS로 설치 파일을 다운로드하고, 서명된 공지에 명시된 SHA-256과 대조합니다. 공지를 확인하는 데 별도의 연결은 필요하지 않으며, 라이선스 확인 외의 연결은 이 다운로드뿐입니다.
검증을 통과하면 Studio가 닫히고, 별도의 질문 없이 진행률 표시줄만 표시되면서 새 버전이 설치된 다음 Studio가 다시 열립니다. 검증에 실패하면 파일이 삭제되고 아무것도 설치되지 않으며, 해당 줄에 실패 이유와 다시 시도가 표시됩니다.
업데이트 후 각 작업 공간 내의 엔진 사본이 새 버전으로 자동 갱신됩니다. 테스트, 증빙 자료 및 설정은 변경되지 않습니다.

실행할 환경

Studio는 사용자의 Windows 11 PC에서 실행되며, 그 외에는 아무것도 필요하지 않습니다.

사용자 PC. Studio를 설치하고 작업 공간을 열어 실행하세요. 예약 실행은 PC가 깨어 있는 동안에만 이루어집니다.
미니 PC, 선택 사항. 항상 켜 두는 전용 Windows 11 기기로, 작업용 PC를 점유하지 않고 야간 회귀 테스트와 예약 실행을 수행할 수 있습니다. Watch는 설정된 일정을 유지하며, 증거 자료는 해당 기기의 디스크에 보관됩니다.
작업 공간마다 실행 환경을 선택합니다. 각 작업 공간에서 엔진이 테스트 모음을 실행할 위치를 Studio의 Docker 화면에서 선택합니다: 이 컴퓨터; 같은 디스크의 실행 컨테이너를 사용하는 이 컴퓨터의 Docker; 또는 같은 컨테이너 이미지를 실행하는 SSH로 연결된 VPS. 두 작업 공간에서 테스트하는 두 애플리케이션은 서로 다른 실행 환경을 사용할 수 있습니다. 세 가지 중 어느 것도 필수는 아니며, 설정 하나로 전환할 수 있습니다. Studio 자체는 항상 Windows에서 실행됩니다.
VPS는 Docker Engine과 Compose v2가 설치된 Ubuntu 24.04 LTS를 실행하며, SSH 키 인증으로 접속합니다. 수집된 증거 자료는 가져올 때까지 VPS에 보관됩니다. VPS는 자체적으로 라이선스를 확인하며 요금제의 컴퓨터 한 대로 계산됩니다: 요금제 및 컴퓨터를 참조하세요.
실제 Android 휴대전화는 USB 디버깅을 켠 상태에서 Studio가 실행되는 컴퓨터에 USB로 연결합니다; 기기 & 모바일에 첫 기기 연결 안내가 있습니다. 휴대전화 테스트, Selenium 및 Python 테스트 모음, 인프라 카오스 테스트는 항상 Studio가 실행되는 컴퓨터에서 실행됩니다.

예약 실행 도구인 Watch는 작업 공간의 실행 환경이 Local로 설정된 경우에만 Studio가 설치된 컴퓨터에서 실행됩니다. VPS에서 예약 실행하려면 CI를 사용하세요: CI/CD에서 테스트 실행하기.

인프라를 직접 소유하고 관리하기 에서는 이러한 구성 중에서 선택할 수 있도록 돕고, 직접 소유한 컴퓨터를 클라우드 QA 플랫폼 및 임대 서버와 비교합니다: 증거 자료의 저장 위치, 접근 가능한 사람, 비용을 살펴봅니다.

Nexus Studio는 터널 없이 localhost를 어떻게 테스트하나요?

나만의 QA 전용 도구입니다. 터널도, 외부에 노출된 스테이징 URL도 없으며, 테스트 데이터가 네트워크 밖으로 나가지 않습니다. Windows 11, Ubuntu 24.04 LTS, Docker 또는 SSH에서 실행됩니다. BASE_URL로 테스트 모음이 localhost나 비공개 스테이징 URL에 있는 앱을 그대로 대상으로 삼도록 설정합니다.

테스트 후에도 실행 중으로 남은 개발 서버.
NEXUS_APP_START는 매 실행 전에 앱을 시작하고, 실행이 종료되거나 실패하거나 Ctrl+C 등으로 중단되면 앱과 하위 프로세스 전체를 종료합니다.
시작조차 하지 않은 앱을 대상으로 한 성공 판정.
실행은 준비 상태 확인 URL이 500 미만의 상태 코드로 응답할 때까지 0.5초마다 확인하며 기다립니다. 앱이 시작되지 않으면 실행도 시작되지 않습니다: CONFIG_ERROR APP_DID_NOT_START, 마지막 로그 40줄이 함께 제공됩니다.
이미 실행 중인 앱을 중복으로 시작하는 상황.
NEXUS_APP_REUSE=true는 이미 응답하는 앱을 사용하고 실행 상태로 둡니다; false는 해당 주소에서 다른 대상이 응답하면 실행을 중단합니다.
어느 빌드의 결과인지 누구도 확인할 수 없는 상황.
매 실행마다 앱의 package.json 버전과 테스트한 git 커밋을 기록합니다.
Docker와 SSH.
Docker에서도 앱은 이 컴퓨터에서 실행되며 컨테이너는 localhost BASE_URL에 host.docker.internal로 접근합니다. SSH를 사용하면 앱은 원격 호스트에서 시작됩니다.

셸 없이 프로그램 하나와 그 인수만 사용합니다: npm run dev, pnpm dev 또는 node server.js. Studio에서 테스트하는 nexus app check는 앱을 시작하고, 기다린 뒤 종료합니다. 전체 로그는 evidence/run-context/에 보관됩니다.