터미널을 어디서나 사용하세요
Termbridge는 로컬 서버를 실행하고 Cloudflare를 통해 터널링한 다음, tmux 세션을 브라우저 어디서나 사용할 수 있게 합니다.
npx termbridge최신 릴리스 0.3.13 MIT Node 20+, tmux, cloudflared
# Create a tmux session and start the agent
tmux new-session -d -s claude "claude"
# Then attach Termbridge to it
termbridge --session claude실제 사용
컴퓨터에서 실행한 다음 다른 기기에서 터미널을 여세요.
노트북에서 휴대폰으로
npx termbridge는 로컬 서버, tmux 세션, Cloudflare 터널을 시작한 다음, 일회용 로그인 링크가 포함된 QR 코드를 표시합니다.
코드를 스캔하면 토큰이 쿠키 세션으로 교환됩니다. --proxy 5173을 추가하면 터미널 옆의 미리보기 화면에 개발 서버를 표시할 수 있습니다.
npx termbridge# Start your Vite app first
cd my-app && npm run dev # runs on port 5173
# Then start Termbridge with proxy
termbridge --proxy 5173모바일 지원
QR 코드를 스캔하고 휴대폰 브라우저에서 터미널을 여세요.
진짜 터미널
tmux와 node-pty를 사용해 실제 PTY를 색상 및 TUI와 함께 xterm.js에 연결합니다.
Cloudflare 터널
Quick Tunnel은 포트 포워딩 없이 로컬 서버를 외부에 공개합니다.
토큰 로그인
QR 링크에는 90초 동안 유효한 일회용 토큰이 포함됩니다. 토큰을 사용하면 CSRF 검사와 분당 5회 사용 제한이 적용된 HttpOnly, Secure 세션 쿠키가 설정됩니다. 세션은 만료되지 않습니다.
다중 세션
서버 하나에서 여러 tmux 세션을 호스팅하고 앱 내에서 전환할 수 있습니다.
명령 하나로 실행
npx termbridge를 실행하면 서버, Cloudflare 터널, QR 코드가 시작됩니다. macOS 또는 Linux에서 Node 20+, tmux 및 cloudflared이 필요하며 Windows는 지원되지 않습니다.
먼저 CLI
TTY 상태와 QR 출력을 제공하는 터미널 우선 도구로 설계되었습니다.
QR 전달
실행할 때마다 일회용 로그인 링크가 포함된 QR 코드 하나가 표시됩니다. 사용하려는 기기에서 코드를 스캔하세요.
개발 서버 미리보기
로컬 Vite 앱을 프록시하고 터미널 옆의 미리보기에서 확인하세요.
HMR 전달
WebSocket 프록시를 통해 Vite의 Hot Module Replacement가 작동합니다.
보기 전환
하단 바의 보기 메뉴에서 터미널과 미리보기 간에 전환하세요.
풀스택 워크플로우
터미널 명령을 실행하면서 앱이 실시간으로 업데이트되는 모습을 확인하세요.
Termbridge를 사용하는 이유
포트 포워딩이나 VPN이 필요 없음
계정 없이 사용할 수 있는 Cloudflare Quick Tunnel이 로컬 서버에 공개 HTTPS URL을 제공합니다. 연결하는 기기에는 브라우저만 있으면 됩니다.
전체 화면 프로그램도 작동
node-pty는 tmux에 연결해 256 색상 터미널로 보고하므로 htop 및 vim 같은 TUI도 로컬에서처럼 작동합니다.
브리지가 종료되어도 세션 유지
Ctrl+C는 터널과 서버를 닫지만 tmux 세션은 계속 실행합니다. 이미 실행 중인 세션에 연결하려면 --session을 지정해 다시 시작하세요.
내 컴퓨터에서 실행
서버, WebSocket, 터미널 레지스트리는 컴퓨터에 있으며 기본적으로 127.0.0.1에서 수신 대기합니다. Termbridge는 자체 백엔드를 운영하지 않습니다.
비교 대상
다른 기기에서 터미널에 접속하는 방법과 Termbridge의 차이점을 알아보세요.
| 도구 | 잘하는 점 | Termbridge와의 차이점 |
|---|---|---|
| ttyd | 잘하는 점ttyd는 CJK 및 IME 입력, ZMODEM 및 trzsz 파일 전송, Sixel 이미지, SSL 및 기본 인증을 지원하며 웹을 통해 모든 명령을 공유합니다. macOS, Linux, BSD, OpenWrt, Windows에서 실행됩니다. | Termbridge와의 차이점Termbridge는 터널, 일회용 QR 로그인 링크, 휴대폰 제어 바를 제공하며, 셸을 tmux에 유지해 재시작 후에도 계속 사용할 수 있습니다. macOS 및 Linux용으로 제작되었습니다. |
| sshx | 잘하는 점sshx는 무한 캔버스에서 명령 하나로 누구와나 터미널을 공유합니다. 협업자는 서로의 커서를 볼 수 있고, 종단 간 암호화가 적용됩니다. Linux, macOS, Windows용 바이너리를 제공합니다. | Termbridge와의 차이점Termbridge는 자신의 터미널에 접속하기 위한 도구입니다. 실행할 때마다 한 번만 사용할 수 있는 로그인 링크가 발급되며, 트래픽은 Cloudflare 터널을 거쳐 내 컴퓨터의 서버로 전달됩니다. |
| Tailscale SSH | 잘하는 점Tailscale SSH를 사용하면 Tailscale이 tailnet 내 SSH 연결의 인증과 권한 부여를 처리합니다. 노드 키를 사용해 WireGuard로 암호화하며, Tailscale을 실행하는 모든 기기에서 연결할 수 있습니다. | Termbridge와의 차이점Termbridge는 다른 기기에 클라이언트나 사설 네트워크를 설치할 필요가 없습니다. 공개 URL 및 QR 코드를 제공하며, 브라우저에서 터미널이 열립니다. |
출처, 선택됨
질문과 답변
Termbridge 문서의 간단한 답변.
기본 모드에서는 Cloudflare Quick Tunnel을 거쳐 내 컴퓨터의 Termbridge 서버로 트래픽이 전달됩니다. Termbridge는 자체 백엔드를 운영하지 않습니다. Daytona 샌드박스 모드에서는 내 Daytona 계정의 샌드박스에서 터미널이 실행됩니다. 직접 모드에서는 서버도 그곳에서 실행되며 Daytona 미리보기 링크를 통해 연결합니다.
QR 링크에는 90초 동안 유효하며 한 번만 사용할 수 있는 토큰이 포함됩니다. 토큰을 사용하면 HttpOnly 세션 쿠키가 설정되며, 터미널 WebSocket 연결에도 CSRF 토큰이 필요합니다. 신뢰하지 않는 사람과 QR 코드나 URL을 공유하지 마세요.
네. TERMBRIDGE_SESSIONS=3으로 설정하면 tmux 세션 세 개가 시작됩니다. 앱의 터미널 전환기를 사용해 세션 간에 전환하세요.
공식적으로는 지원하지 않습니다. Termbridge는 macOS 및 Linux용으로 제작되었습니다. WSL에서 작동할 수도 있지만 테스트되지 않았습니다.
아직은 불가능합니다. Cloudflare만 터널 제공업체로 사용할 수 있습니다. 자체 호스트 이름에서 이름이 지정된 Cloudflare 터널을 사용하거나, 터널을 끄고 자체 공개 URL을 전달하거나, Daytona 직접 모드를 사용할 수 있습니다.
로컬 모드에서는 Termbridge가 실행되는 동안 연결이 유지되며, 컴퓨터가 절전 모드에 들어가거나 Termbridge가 종료되면 끊깁니다. tmux 세션은 계속 실행되므로 Termbridge를 다시 시작해 새 QR 코드를 스캔하고 --session으로 연결할 수 있습니다. Daytona 직접 모드에서는 서버가 샌드박스 내에서 실행됩니다.
Node 20+, tmux 및 cloudflared를 설치하고 npx termbridge를 실행한 다음, QR 코드를 스캔해 휴대폰 브라우저에서 터미널을 여세요.