자주 묻는 질문

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

Termbridge 서버와 터미널은 사용자의 컴퓨터에서 실행되며, Termbridge에서 운영하는 백엔드는 없습니다. 기본 설정에서는 터미널 트래픽이 Cloudflare를 거칩니다. 브라우저는 HTTPS을 통해 Cloudflare Quick Tunnel에 연결되고, 이 터널이 사용자의 컴퓨터에 있는 cloudflared 프로세스로 전달합니다(아키텍처 참조). 이름이 지정된 터널을 사용하면 사용자의 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의 터미널 전환기를 사용해 세션 간에 이동할 수 있습니다. 여러 터미널을 참조하세요.

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를 받으므로 이전에 연결한 브라우저는 다시 스캔해야 합니다.