문제 해결과 FAQ

자주 묻는 질문에 짧게 답하고, 자세한 내용을 다루는 페이지를 함께 안내합니다.

라이선스와 계정링크 복사

페이지에 페르소나가 아니라 실제 머신이 보입니다링크 복사

브라우저는 페르소나를 적용하면 stderr에 [bauta] persona: <file>을 출력합니다. 페이지에 실제 머신이 보인다면 stderr에 그 이유가 나옵니다. 라이선스가 없거나, 만료되었거나, 저희가 발급하지 않은 경우, 또는 페르소나 파일을 읽을 수 없거나 내용이 서로 모순되는 경우입니다. bauta status로 라이선스를 확인하고, bauta activate <license key>나 bauta login으로 활성화하세요. 브라우저가 실행되는 동안 라이선스가 만료되어도 브라우저는 멈추지 않습니다.

서버에 연결할 수 없습니다링크 복사

마지막 라이선스 토큰이 만료될 때까지 유효하며, 실행 중인 페르소나는 멈추지 않습니다. 라이선스 키를 보세요.

체험이 끝나면 어떻게 되나요?링크 복사

계정에는 무료 플랜의 세션 3개가 남습니다. 대시보드와 bauta status에 체험이 끝나는 날짜가 표시되며, 마지막 3일 동안에는 bauta status가 한 번 더 알려 줍니다. 플랜과 세션을 보세요.

bauta login이 GitHub 계정에 확인된 이메일이 없다고 합니다링크 복사

https://github.com/settings/emails 에서 GitHub 계정에 확인된 이메일을 추가한 뒤 bauta login을 다시 실행하세요.

스크립트나 컨테이너에서 bauta login을 쓰려면링크 복사

bauta login은 터미널이 필요합니다. 대신 BAUTA_LICENSE_KEY에 라이선스 키를 설정하세요.

로그인이나 로그아웃 때 새 핑거프린트에 관해 묻습니다링크 복사

페르소나의 핑거프린트는 이름과 라이선스의 비밀값에서 만들어지므로, 같은 페르소나라도 라이선스가 다르면 다르게 읽힙니다. 이 머신에 페르소나가 있으면 bauta login과 bauta logout은 라이선스를 바꾸기 전에 확인을 묻습니다. 아니라고 답하면 아무것도 바뀌지 않습니다.

설치 스크립트가 아무것도 묻지 않았습니다링크 복사

설치 스크립트와 bautabrowser 패키지는 stdin이나 stdout이 터미널이 아니거나, CI가 설정되어 있거나, /.dockerenv가 있거나, BAUTA_NO_PROMPT=1이면 묻지 않고 세션 1개의 무료 플랜을 활성화합니다. 나중에 계정을 추가하려면 터미널에서 bauta login을 실행하세요.

설치 스크립트가 서명을 확인하지 않았다고 합니다링크 복사

OpenSSL 3이 없는 기본 상태의 Mac에서는 설치 스크립트가 서명을 확인하지 않았다는 사실과 그 이유를 한 줄로 출력합니다. 체크섬은 여전히 HTTPS로 받습니다. 이런 경우 설치를 거부하려면 BAUTA_REQUIRE_SIGNATURE=1을 설정하세요.

게이트웨이링크 복사

새 연결이 기다립니다링크 복사

플랜은 모든 머신을 합쳐 동시에 돌릴 수 있는 페르소나 수를 정합니다. 세션을 모두 쓰고 있으면 새 페르소나의 연결은 열린 채로 대기열에서 세션이 비거나 새 라이선스가 올 때까지 기다립니다. 이 때문에 실행 중인 페르소나가 멈추지는 않습니다. 게이트웨이는 stderr에 queued 줄을 출력하고, bauta stats는 라이선스 대비 활성 페르소나와 대기 중인 페르소나를 보여 줍니다.

페르소나의 브라우저는 마지막 클라이언트가 떠나고 30초 뒤에 닫히며(bauta serve --idle), 그러면 세션이 빕니다. 라이선스가 만료된 동안에도 새 페르소나는 기다립니다. 세션을 보세요.

서버에서 브라우저가 헤드리스로 실행됩니다링크 복사

디스플레이가 없는 머신에서는 Xvfb를 설치하세요. 그러면 bauta serve가 자체 가상 디스플레이에 브라우저 창을 엽니다.

apt install xvfb

Xvfb가 없으면 페이지가 구별할 수 있는 Chrome의 헤드리스 모드로 대신 실행하고, 그렇다고 알려 줍니다. 서버를 보세요.

Ubuntu 24.04의 샌드박스링크 복사

AppArmor는 자신이 모르는 Chrome이 비특권 사용자 네임스페이스를 쓰지 못하게 막습니다. CHROME_DEVEL_SANDBOX가 SUID 샌드박스 도우미를 가리키게 하거나(기본 Chrome의 /opt/google/chrome/chrome-sandbox도 됩니다), --no-sandbox로 실행하세요. 어느 쪽이든 페르소나는 적용됩니다.

프록시링크 복사

프록시가 인증 정보를 거부합니다링크 복사

프록시가 인증 정보를 거부하면 요청은 바로 실패하고, bauta serve가 그렇다고 알려 줍니다. 페르소나의 "proxy"에 든 사용자 이름과 비밀번호를 확인하고, 그 안의 :, @, /는 %로 이스케이프하세요. 프록시를 보세요.

시간대가 프록시를 따르지 않습니다링크 복사

프록시가 있고 페르소나 파일에 "timezone"과 "locale"이 모두 없으면, 둘 다 프록시의 출구 위치를 따릅니다. bauta serve가 프록시를 거쳐 IP 확인 서비스에 묻고(BAUTA_IP_ECHO로 바꾸지 않으면 https://api.ipify.org), bauta geo update가 받아 두는 데이터베이스로 그 주소의 위치를 찾습니다. 먼저 데이터베이스를 받으세요.

bauta geo update

위치를 찾을 수 없고 이전에 찾은 적도 없으면, 외국 주소 뒤에서 이 머신의 시간대를 보여 주는 대신 페르소나의 브라우저를 시작하지 않습니다. 직접 정하려면 페르소나 파일에 "timezone"과 "locale"을 넣으세요. 예: "America/New_York", "en-US".

파일과 데이터링크 복사

bauta가 파일을 두는 곳링크 복사

~/.bauta, 또는 BAUTA_HOME이 가리키는 디렉터리입니다. 여기에 personas/, license(라이선스 토큰), fonts/가 있습니다. 페르소나를 내 다른 머신으로 옮기려면 그 디렉터리 ~/.bauta/personas/<name>을 복사하세요.

서버로 보내는 정보링크 복사

서버와 통신하는 것은 bauta와 그 게이트웨이뿐이며, 브라우저는 통신하지 않습니다. 페이지, URL, 프록시, 페르소나에 관한 정보는 보내지 않습니다. 전체 목록은 데이터 레퍼런스에 있습니다.

결제링크 복사

어떻게 해지하나요?링크 복사

대시보드의 결제 관리에서 해지합니다. 플랜은 결제한 기간이 끝날 때까지 그대로이며, 그 뒤 라이선스는 무료 플랜으로 돌아갑니다. 플랜과 세션을 보세요.

환불은 어디서 처리하나요?링크 복사

판매 대행자(Merchant of Record)인 Paddle이 환불 정책에 따라 처리합니다. 결제 문의는 support@bauta.dev로 보내 주세요.

다음링크 복사

• 라이선스 키: 활성화, 로그인, 라이선스 확인을 설명합니다.
• 플랜과 세션: 플랜마다 허용되는 것을 설명합니다.
• CLI 레퍼런스: bauta의 명령과 옵션입니다.