bauta CLI
bauta 명령줄의 모든 명령과 플래그, 그리고 그 기본값입니다.
bauta는 명령줄이자, bauta 브라우저 앞에 서는 CDP 게이트웨이입니다. 인자 없이 실행하면 사용법을 출력합니다.
명령
| 명령 | 하는 일 |
|---|---|
bauta setup | 이 머신의 무료 세션을 바로 활성화하고, 터미널이면 이어서 계정과 스타를 권합니다. |
bauta activate | 이 머신의 첫 라이선스 토큰을 받습니다. |
bauta browser fetch | 최신 릴리스나 지정한 릴리스에서 이 머신용 브라우저를 내려받습니다. |
bauta login | 터미널에서 GitHub로 가입하거나 로그인합니다. |
bauta logout | 이 머신을 무료 세션으로 되돌립니다. |
bauta status | 플랜, 모든 머신에서 사용 중인 세션, 이 설치의 ID를 보여 줍니다. |
bauta upgrade | 가격 페이지의 URL을 출력합니다. |
bauta serve | 게이트웨이를 실행합니다. |
bauta geo update | 프록시의 출구 IP 위치를 찾는 데이터베이스를 갱신합니다. |
bauta persona new | 내장 페르소나나 페르소나 파일로 페르소나를 만듭니다. |
bauta persona set | 프로필은 그대로 두고 페르소나의 설정을 새로 정합니다. |
bauta persona ls | 페르소나 목록을 보여 줍니다. |
bauta persona rm | 페르소나를 지웁니다. |
bauta open | 직접 로그인할 수 있도록 페르소나의 브라우저를 창으로 엽니다. |
bauta inspect | 게이트웨이가 실행 중인 페르소나의 페이지마다 DevTools 링크를 출력합니다. |
bauta stats | 게이트웨이의 활성 페르소나와 대기 중인 페르소나를 라이선스 기준으로 보여 줍니다. |
bauta version | 이 bauta의 버전을 출력합니다. |
bauta traffic | 페르소나의 페이지가 가져온 것, 차단된 것, 캐시에서 찾은 것을 종류별로 보여 줍니다. |
bauta widevine fetch | DRM 보호 미디어를 위한 Google의 Widevine CDM을 가져옵니다. |
설정과 계정
bauta setup
bauta setup [--non-interactive]이 머신의 무료 세션을 바로 활성화하고 ~/.bauta/license를 씁니다. 터미널에서는 이어서 GitHub로 무료 계정을 만들고
스타를 누르도록 권합니다.
| 플래그 | 하는 일 |
|---|---|
--non-interactive | 묻지 않고 무료 세션만 받습니다. 설치 스크립트는 물어볼 수 없을 때, 즉 터미널이 없거나, CI나 BAUTA_NO_PROMPT=1이 설정되어 있거나, /.dockerenv가 있을 때 setup을 이렇게 실행합니다. |
bauta activate
bauta activate <license key> [--server <url>]라이선스 키로 이 머신의 첫 라이선스 토큰을 받고, 토큰이 이 머신에 허용하는 활성 페르소나 수와 그 기한을 출력합니다. 키는 대시보드에 있습니다.
| 플래그 | 기본값 | 하는 일 |
|---|---|---|
--server <url> | BAUTA_SERVER, 없으면 https://api.bauta.dev | 활성화할 서버입니다. |
bauta login
bauta login터미널에서 GitHub로 가입하거나 로그인합니다. URL과 그곳에 입력할 코드를 출력하고 기다리며, 코드는 휴대폰을 비롯해 어느
기기에서든 입력할 수 있습니다. 가입하면 이용약관에 동의하게 됩니다. 터미널이 필요하며, 스크립트에서는 대신
BAUTA_LICENSE_KEY를 설정하세요.
이 머신에 페르소나가 있으면, 페르소나가 새 핑거프린트를 받을 수 있으므로 먼저 확인을 받습니다. BAUTA_LICENSE_KEY가
설정되어 있으면 bauta login이 보관하는 키보다 그 값이 여전히 우선하며, 그렇다고 알려 줍니다. GitHub 계정에 인증된
이메일이 없으면 https://github.com/settings/emails에서 추가한 뒤 다시 실행하세요.
bauta logout
bauta logout이 머신을 무료 세션, 즉 이 머신의 세션 하나로 되돌립니다. BAUTA_LICENSE_KEY가 설정되어 있으면 거부하므로, 먼저
해제하세요. 이 머신에 페르소나가 있으면 페르소나가 새 핑거프린트를 받으므로 먼저 확인을 받으며, 터미널이 없으면
거부합니다.
bauta status
bauta status플랜, 모든 머신에서 사용 중인 세션, 이 설치의 ID를 보여 줍니다. 출력 형식은 세션과 라이선스에 있습니다.
bauta upgrade
bauta upgrade가격 페이지의 URL https://bauta.dev/pricing?from=cli를 출력합니다.
브라우저
bauta browser fetch
bauta browser fetch [--version vX.Y.Z]최신 릴리스에서 이 머신용 브라우저를 내려받아 릴리스의 서명된 SHA256SUMS와 대조하고, 브라우저가 있는 디렉터리를
출력합니다. GitHub의 BautaBrowser/bauta-browser 릴리스에서 내려받으며, 서버로는 아무것도 보내지 않습니다.
| 플래그 | 하는 일 |
|---|---|
--version vX.Y.Z | 최신 릴리스 대신 그 릴리스를 받습니다. |
bauta widevine fetch
bauta widevine fetchDRM 보호 미디어를 위한 Google의 Widevine CDM을 Chrome과 같은 방식으로 가져오고, 그 디렉터리를 출력합니다. 이것이 없으면 브라우저는 이 머신에 Google Chrome이 설치되어 있을 때 그 CDM을 씁니다.
bauta version
bauta version이 bauta의 버전을 bauta 뒤에 버전 번호를 붙여 출력합니다.
게이트웨이
bauta serve
bauta serve [--listen 127.0.0.1] [--port 9222] [--idle 30] [--per-browser 8] [--server <url>] [--heartbeat 60]
[--hidden]게이트웨이를 실행합니다. Playwright는 http://127.0.0.1:9222/persona/<name>(connect_over_cdp)에,
Puppeteer는 ws://127.0.0.1:9222/persona/<name>에 연결합니다. 플래그의 순서는 상관없습니다.
| 플래그 | 기본값 | 하는 일 |
|---|---|---|
--listen | 127.0.0.1 | 대기할 IP 주소입니다. --listen 0.0.0.0을 쓰면 다른 머신도 들어올 수 있고, 포트에 닿는 누구나 페르소나를 조종할 수 있습니다. |
--port | 9222 | 대기할 포트입니다. |
--idle | 30 | 페르소나의 브라우저는 마지막 클라이언트가 떠나고 이 초만큼 지나면 닫힙니다. |
--per-browser | 8 | 브라우저 하나를 함께 쓰는 페르소나 수입니다. 1이면 페르소나마다 브라우저를 따로 둡니다. |
--server | BAUTA_SERVER, 없으면 https://api.bauta.dev | 라이선스를 갱신하는 서버입니다. |
--heartbeat | 60 | 라이선스 갱신 간격(초)입니다. 서버가 이 머신에 있는 경우가 아니면 최소 60초입니다. |
--hidden | 꺼짐 | 브라우저 창을 아무도 보지 못하는 곳에 둡니다. Linux: DISPLAY 값과 상관없이 가상 디스플레이. Windows: 게이트웨이 전용 데스크톱. macOS: Chrome의 헤드리스 모드. |
각 플래그의 동작은 CDP 게이트웨이에서 설명합니다.
bauta stats
bauta stats [--port 9222]게이트웨이의 활성 페르소나와 대기 중인 페르소나를 라이선스 기준으로 JSON으로 출력합니다. 이 머신의 게이트웨이에
묻습니다. --port로 그 포트를 지정하며, 기본값은 9222입니다.
bauta inspect
bauta inspect <name> [--port 9222]게이트웨이가 실행 중인 페르소나의 페이지마다 DevTools 링크를 페이지 URL과 함께 출력합니다. --port로 게이트웨이의
포트를 지정하며, 기본값은 9222입니다.
bauta open
bauta open <name>직접 로그인할 수 있도록 페르소나의 브라우저를 창으로 열고, 창을 닫을 때까지 기다립니다. 디스플레이가 필요합니다.
bauta traffic
bauta traffic <name>페르소나의 페이지가 가져온 것, 차단된 것, 캐시에서 찾은 것을 종류별로 JSON으로 출력합니다. 대역폭을 참고하세요.
페르소나
bauta persona new
bauta persona new <name> --from <a built-in persona's name, or a persona file>페르소나를 만들고 그 디렉터리를 출력합니다.
bauta persona set
bauta persona set <name> --from <the same>내장 페르소나의 이름이나 페르소나 파일로 페르소나의 설정을 새로 정하고, 프로필은 그대로 둡니다. 그 페르소나를 실행 중인 브라우저는 닫힐 때까지 이전 설정을 유지합니다. 페르소나는 페이지가 열려 있는 동안 바뀌지 않습니다.
bauta persona ls
bauta persona ls페르소나 이름을 한 줄에 하나씩 출력합니다.
bauta persona rm
bauta persona rm <name>페르소나를 지웁니다.
IP 데이터베이스
bauta geo update
bauta geo update프록시의 출구 IP 위치를 찾는 데이터베이스(DB-IP의 IP to City Lite)를 갱신하고, 보관 위치를 DB-IP의 저작자 표시와
함께 출력합니다. bauta serve는 이 데이터베이스로 프록시의 출구 위치에 맞춰 페르소나의 시간대와 로캘을 정합니다. IP
위치 정보는 DB-IP가 CC BY 4.0으로 제공합니다.
환경 변수
사용법의 끝에는 bauta가 읽는 변수가 나옵니다.
| 변수 | 하는 일 | 기본값 |
|---|---|---|
BAUTA_HOME | personas/, license, fonts/를 담습니다. | ~/.bauta |
BAUTA_CHROME | 브라우저입니다. | bauta 옆의 chrome |
BAUTA_SERVER | 서버입니다. | https://api.bauta.dev |
BAUTA_LICENSE_KEY | 설정하면 보관된 키보다 우선합니다. | 설정 안 됨 |
모든 변수는 환경 변수에 있습니다.
종료 상태
| 상태 | 의미 |
|---|---|
0 | 명령이 성공했습니다. |
1 | 명령이 실패했습니다. bauta는 stderr에 bauta:와 그 이유를 출력합니다. |
2 | bauta가 명령을 알아보지 못해 stderr에 사용법을 출력했습니다. |
사용법 원문
usage:
bauta setup [--non-interactive] the free session at once, then (on a terminal) an account and a star
bauta activate <license key> [--server <url>]
the first license token for this machine
bauta browser fetch [--version vX.Y.Z]
the browser for this machine from the latest release (or that one), checked
against the release's signed SHA256SUMS
bauta login sign up or in with GitHub, in the terminal (a code to enter on any device)
bauta logout back to this machine's free session
bauta status the plan, the sessions in use and across machines, and this install's id
bauta upgrade prints the pricing page's URL
bauta serve [--listen 127.0.0.1] [--port 9222] [--idle 30] [--per-browser 8] [--server <url>] [--heartbeat 60]
[--hidden]
the gateway: connect Playwright to http://127.0.0.1:9222/persona/<name>
(connect_over_cdp), Puppeteer to ws://127.0.0.1:9222/persona/<name>;
a persona's browser closes <idle> seconds after its last client;
personas share browsers, <per-browser> to one (1: a browser each);
with a server (or BAUTA_SERVER), the license is renewed every <heartbeat> s
(60 at least, unless the server is on this machine); --listen 0.0.0.0
lets other machines in, and whoever reaches the port drives the personas;
--hidden: the browsers' windows where no one sees them (Linux: a virtual
display, whatever DISPLAY says; Windows: a desktop of the gateway's own;
macOS: Chrome's headless)
bauta geo update the database that places a proxy's exit IP (DB-IP's IP to City Lite)
bauta persona new <name> --from <a built-in persona's name, or a persona file>
bauta persona set <name> --from <the same>
its settings anew, its profile kept; a browser running it keeps the old
ones until it closes (a persona never changes under a page)
bauta persona ls
bauta persona rm <name>
bauta open <name> the persona's browser in a window, for a manual login
bauta inspect <name> [--port 9222] a DevTools link for each page of a persona the gateway runs
bauta stats [--port 9222] the gateway's active and queued personas, against the license
bauta version this bauta's version
bauta traffic <name> what the persona's pages fetched, blocked and found in the cache, by kind
bauta widevine fetch Google's Widevine CDM, for DRM-protected media (Chrome fetches it the same way);
without it the browsers take Google Chrome's, if one is installed here
BAUTA_HOME (~/.bauta) holds personas/, license and fonts/; BAUTA_CHROME is the browser (default: chrome
beside bauta). BAUTA_SERVER is our server (default https://api.bauta.dev); BAUTA_LICENSE_KEY, when set, wins
over the kept key.다음 단계
- CDP 게이트웨이:
bauta serve가 페르소나마다 하는 일. - 페르소나 파일 형식:
--from이 받는 것. - 환경 변수: bauta가 읽는 모든 변수.