
# 자주 묻는 질문

## 내 데이터가 다른 사람의 서버를 거치나요?

Termbridge 서버와 터미널은 사용자의 컴퓨터에서 실행되며, Termbridge에서 운영하는 백엔드는 없습니다. 기본 설정에서는 터미널 트래픽이 Cloudflare를 거칩니다. 브라우저는 HTTPS을 통해 Cloudflare Quick Tunnel에 연결되고, 이 터널이 사용자의 컴퓨터에 있는 `cloudflared` 프로세스로 전달합니다([아키텍처](https://termbridge.inline0.dev/ko/docs/architecture) 참조). 이름이 지정된 터널을 사용하면 사용자의 Cloudflare 계정을 거치며, `--no-tunnel`를 사용하면 공개 URL를 제공하는 서비스를 거칩니다.

Daytona 샌드박스 모드에서는 터미널이 사용자의 Daytona 계정에 있는 샌드박스에서 실행됩니다. 직접 모드에서는 브라우저가 Cloudflare 대신 Daytona 미리보기 링크를 통해 연결됩니다.

## 연결은 얼마나 안전한가요?

- URL에는 한 번만 사용할 수 있고 시작 후 90초가 지나면 만료되는 일회용 토큰이 포함됩니다.
- 세션은 HttpOnly 쿠키로 보호됩니다.
- 터널 URL(Cloudflare 또는 Daytona 미리보기 링크)은 HTTPS을 사용합니다. `--no-tunnel`를 사용하는 경우 암호화는 사용자가 제공하는 공개 URL에 따라 달라집니다.

세션은 저절로 만료되지 않습니다. 시스템 임시 디렉터리의 `termbridge/sessions.json`에 저장되므로 링크를 교환한 브라우저는 동일한 URL에 연결할 수 있는 동안 계속 접속할 수 있습니다. 모든 브라우저에서 로그아웃하려면 해당 파일을 삭제하고 Termbridge를 다시 시작하세요. 신뢰하지 않는 사람과 QR 코드나 URL를 공유하지 마세요.

## 터미널을 여러 개 동시에 실행할 수 있나요?

네. `TERMBRIDGE_SESSIONS=3`로 Termbridge을 시작하거나 `--session`로 기존 세션에 연결하고, UI의 터미널 전환기를 사용해 세션 간에 이동할 수 있습니다. [여러 터미널](https://termbridge.inline0.dev/ko/docs/usage/multiple-terminals)을 참조하세요.

## Claude Code, Codex 또는 다른 AI 도구에서도 작동하나요?

물론입니다. 터미널에서 실행되는 도구라면 Termbridge으로 스트리밍할 수 있습니다. AI 코딩 도구를 tmux 세션에서 시작하면 휴대폰으로 작업을 모니터링할 수 있습니다.

## Windows에서 작동하나요?

공식적으로는 지원하지 않습니다. Termbridge은 macOS 및 Linux용으로 제작되었습니다. WSL에서 작동할 수도 있지만 테스트되지는 않았습니다.

## 다른 터널 제공자를 사용할 수 있나요?

아직은 아닙니다. 현재 터널 제공자는 Cloudflare뿐입니다. 터널을 완전히 비활성화하거나 Daytona 직접 모드를 사용할 수도 있습니다.

## 노트북을 닫으면 어떻게 되나요?

로컬 모드에서는 Termbridge이 실행 중인 동안 터널이 활성 상태를 유지합니다. 컴퓨터가 절전 모드에 들어가거나 Termbridge이 종료되면 연결이 끊깁니다. tmux 세션은 계속 유지되므로 Termbridge를 다시 시작해 재연결할 수 있습니다. Daytona 직접 모드에서는 서버가 샌드박스 안에서 실행되므로 노트북을 닫았다가 나중에 다시 연결할 수 있습니다.

## 여러 사람이 동시에 연결할 수 있나요?

링크 하나로는 불가능합니다. 실행할 때마다 공유 링크 하나가 발급되며 한 번만 작동합니다. 먼저 링크를 연 사람이 세션을 가져가고, 다른 사람에게는 `invalid token`이 표시됩니다. Termbridge를 다시 시작하지 않으면 두 번째 링크를 발급할 수 없습니다.

다시 시작할 때 동일한 공개 URL(이름이 지정된 터널 또는 `--public-url`)을 유지하면 이전에 연결한 브라우저의 세션도 유지되므로 다른 사람이 새 코드를 스캔할 수 있습니다. 동일한 터미널에 연결된 사람은 모두 같은 출력을 보고 입력할 수 있습니다. Quick Tunnel은 시작할 때마다 새로운 URL를 받으므로 이전에 연결한 브라우저는 다시 스캔해야 합니다.
