Veilus 소개: 설치부터 스케줄링된 스크립트까지 첫 한 시간
요약
본 문서는 브라우저 및 프로필 관리를 위한 도구인 Veilus 사용법을 안내합니다. 설치부터 시작하여 엔진 다운로드, 가상 OS 환경의 프로필 생성, 그리고 프록시 설정까지의 전 과정을 단계별로 설명하고 있습니다. 특히, 각 프로필에 맞는 지문(fingerprint)과 시간대 일치 여부를 확인하는 것이 중요하며, 이를 통해 안정적인 웹 테스트 환경을 구축할 수 있습니다.
핵심 포인트
- Veilus는 Windows/macOS에서 실행되며, 설치 후 엔진 다운로드가 필요합니다.
- 새 프로필 생성 시 OS와 지역 설정을 통해 고유한 지문(fingerprint)을 만듭니다.
- 프록시 설정 시, 프로필의 시간대와 프록시 출구지 간의 일치 여부가 중요합니다.
- 여러 프로필에 대한 대규모 관리를 위해 proxy pool 기능을 활용할 수 있습니다.
Veilus가 무엇인지에 대해서는 homepage에서 확인할 수 있습니다. 이 게시물에서는 Veilus를 사용하는 과정, 즉 새로 설치하는 순간부터 매일 아침 자동으로 실행되는 스크립트를 만드는 과정까지의 과정을 보여줍니다. 각 단계는 전체 상세 정보가 담긴 문서 페이지로 연결됩니다.
1. 설치 후 엔진 다운로드
Veilus는 Windows 10 또는 11 (x64) 및 macOS 13 이상(Apple Silicon)에서 실행됩니다. download page에서 설치 프로그램을 받으세요. Windows나 macOS 모두 첫 실행 시 퍼블리셔를 인식하지 못하므로, Windows에서는 경고창 중 자세히 보기 → 그래도 실행을 클릭하고, macOS에서는 개인 정보 보호 및 보안(Privacy & Security)에서 **어쨌든 열기(Open Anyway)**를 클릭해야 합니다. 정확한 단계는 설치 가이드에 나와 있습니다.
설치 프로그램에는 브라우저 자체가 포함되어 있지 않습니다. **설정 → 엔진 및 업데이트(Settings → Engine & updates)**로 이동하여 **최신(Latest)**으로 표시된 버전 옆의 **다운로드(Download)**를 클릭하세요. 이것이 Veilus 자체 빌드의 Chromium이며, 모든 프로필은 이 엔진을 사용합니다. 다운로드한 첫 번째 엔진이 자동으로 활성화됩니다. 엔진에 대한 자세한 정보를 확인하세요.
2. 첫 번째 프로필 생성하기
**새 프로필(New profile)**을 클릭합니다. 이 프로필이 어떤 운영체제를 나타내야 하는지 선택합니다. 기본값은 사용자의 컴퓨터 OS로 설정되어 있으며, 이것이 가장 안전한 선택입니다. 다른 OS의 프로필을 만들려면 더 많은 것을 모방해야 하므로, Veilus는 하나를 선택할 때 경고합니다. 그런 다음 **언어 및 지역(Language & Region)**에서 시장을 선택하거나 언어와 시간대를 직접 설정하고 **프로필 생성(Create Profile)**을 클릭합니다.
Veilus는 사용자가 선택한 OS에 맞는 지문(fingerprint)을 생성합니다. 프로필 행의 실행 버튼을 클릭하고, **브라우저만(Browser Only)**을 유지하면 해당 프로필 고유의 지문, 쿠키 및 저장소로 브라우저 창이 열립니다.
3. 프록시 설정하기
프로필 패널을 열고 Network 탭으로 이동합니다. 하나의 프로필의 경우 Manual Proxy(HTTP, SOCKS5 또는 residential)를 입력하고 Test Proxy를 클릭합니다. 여러 프로필의 경우 목록에서 proxy pool을 생성하여 할당합니다. 프록시 설정에서 이 두 가지 방법을 모두 다룹니다.
이 단계가 대부분의 사용자가 어려움을 겪는 부분입니다. Veilus는 기본적으로 프로필의 시간대가 프록시 출구지(exit)와 일치하지 않으면 실행을 거부합니다. 예를 들어, 베트남 시간대의 미국 IP는 모순되기 때문입니다. 풀(pool)이 할당된 경우, Match to proxy 기능은 프록시의 실제 출구지를 측정하고 일치하는 시간대를 제안합니다. 수동 프록시를 사용하는 경우에는 Fingerprint 탭에서 Timezone을 직접 설정해야 합니다. 저장하면 프로필이 실행됩니다.
결과를 확인하려면 해당 프로필에 체크 표시를 하고 Test를 클릭합니다. Veilus는 이를 일련의 지문 인식 테스트 사이트(fingerprinting test sites)에서 열고, Score 열에 몇 개가 통과했는지 보여줍니다.
4. AI 어시스턴트 연결하기
지금까지의 모든 기능은 Free 플랜에서 작동하며, 이 플랜으로는 하나의 장치에서 5개의 프로필을 사용할 수 있습니다. 자동화(Automation), 스케줄링(schedules) 및 로컬 API/MCP는 유료 플랜 또는 7일간의 Pro 체험판이 필요합니다. 플랜 및 라이선스를 참조하세요.
사이드바에서 API & MCP를 열고, Turn on port를 클릭합니다(자신의 컴퓨터에서만 리스닝함). 토큰을 생성하고 Claude Code, Cursor 또는 Claude Desktop용으로 준비된 스니펫을 복사합니다. MCP 페이지에서는 어시스턴트가 Veilus와 어떻게 작동하는지 보여줍니다. 만약 Claude Code를 사용한다면, Veilus 플러그인이 작업 과정을 안내하고 결정이 필요할 때 멈추는 기능(skills)을 추가합니다.
5. 한 문장으로 작업 요청하기
동료에게 설명하듯이 작업을 기술하세요:
어시스턴트는 실제 프로필을 열고 페이지를 살펴본 다음 Playwright 스크립트를 작성하여 Veilus Flow에 저장합니다. 스크립트가 승인되지 않은 상태에서도 최대 3개의 프로필에서 시험 실행(trial-run)하고 각 프로필의 출력 결과를 읽어와, 사용자가 보기 전에 스스로 실수를 수정할 수 있습니다. LLM recipe에서는 과정별 모든 도구 호출을 보여줍니다.
6. 검토 및 승인하기 (Read it, approve it)
Veilus Flow를 여세요. 스크립트에는 MCP 배지가 붙어 있고 승인 대기(Pending approval) 상태에 있습니다. 변경 사항이나 전체 소스 코드를 읽은 다음 이 스크립트 승인하기(Approve this script) 버튼을 클릭합니다. 이 단계는 승인된 스크립트가 사용자의 프로필 및 로그인 정보와 함께 무인으로 실행되기 때문에 존재합니다. 승인은 어시스턴트를 통해서가 아니라 앱 내에서 이루어집니다. 만약 나중에 어시스턴트가 새 버전을 저장하더라도, 다시 대기 상태로 돌아갑니다. 스크립트 검토에 대한 자세한 내용.
7. 스케줄링하기 (Put it on a schedule)
어시스턴트에게 승인된 스크립트를 매일 09:00에 실행하도록 요청하거나, 스케줄(Schedule) 탭에서 직접 설정할 수 있습니다: 일별, 주별, 몇 분 간격, 크론 표현식 또는 단일 실행. 스케줄은 고정된 목록 대신 저장된 필터를 대상으로 할 수 있어, 나중에 태그를 지정한 프로필도 자동으로 포함됩니다. 스케줄에 대한 자세한 내용.
스케줄은 Veilus가 실행 중이고 컴퓨터가 깨어 있는 동안 작동합니다. 설정(Settings)에서 **백그라운드에서 실행(Run in background)**을 켜고, 창을 닫아도 Veilus가 종료되는 대신 트레이로 이동하게 만드세요.
어시스턴트가 할 수 없는 것 (What the assistant can't do)
몇 가지 제한 사항이 내장되어 있습니다. 어떤 도구도 프로필, 프록시 풀(proxy pools), 스크립트 또는 스케줄을 삭제할 수 없습니다: 삭제는 앱에 남아 사용자가 직접 처리해야 합니다. 로그인과 같이 프로필에 저장하는 값은 승인한 스크립트에만 전달됩니다. 또한 한 번에 열 수 있는 프로필 브라우저는 모든 것을 합쳐 최대 16개이며, 따라서 대규모 실행 시 장치를 과부하 상태로 만드는 대신 사용 가능한 슬롯을 기다립니다.
다음 단계 (Where to go next)
- 문서에서 빠르게 시작하기 (Quick start in the docs)
- 가격 책정 (Pricing)
- 질문은 Telegram에서, 버그 보고는 GitHub에서
원래 Veilus 블로그에 게시됨.
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기