시작하기
필수 구성 요소 설치
기본 로컬 터널 설정을 사용하려면 컴퓨터에 다음 도구를 설치하세요:
Node.js 20+
nodejs.org에서 다운로드하거나 패키지 관리자를 사용하세요.
셸
# Check if installed
node --version
tmux
Termbridge 세션을 구동하는 터미널 멀티플렉서입니다.
셸
# macOS
brew install tmux
# Ubuntu/Debian
sudo apt install tmux
cloudflared
터미널에 보안 터널을 생성합니다(샌드박스 직접 모드에서는 필요하지 않음).
셸
# macOS
brew install cloudflared
# Linux - see cloudflare.com/downloads
Termbridge 실행
셸
npx termbridge
다음과 같은 출력이 표시됩니다:
코드
┌─────────────────────────────────────────┐
│ Termbridge │
│ │
│ Local: http://127.0.0.1:51234 │
│ Public: https://abc123.trycloudflare.com │
│ │
│ ██████████████ │
│ ██ ██ <- Scan this QR code │
│ ██████████████ │
│ │
└─────────────────────────────────────────┘
참고
trycloudflare.comURL은 계정 없이 빠르게 사용할 수 있는 터널입니다. Termbridge를 자주 사용한다면 요청 제한을 피할 수 있도록 이름이 지정된 Cloudflare 터널 토큰을 설정하세요.
휴대폰으로 연결
- 휴대폰 카메라를 엽니다
- QR 코드를 비춥니다
- 표시된 링크를 누릅니다
- 브라우저에서 터미널이 열립니다
이제 연결되었습니다!
어떤 일이 일어났나요?
- Termbridge이 사용자 컴퓨터에서 로컬 서버를 시작했습니다
- 터미널용 tmux 세션을 생성했습니다
- Cloudflare가 보안 터널(
trycloudflare.comURL)을 생성했습니다 - QR 코드에는 보안 접속을 위한 일회용 토큰이 들어 있습니다. 한 번 사용할 수 있고 시작 후 90초가 지나면 만료되므로 바로 스캔하세요. 만료된 경우 새 코드를 받으려면 Termbridge를 다시 시작하세요
- 코드를 스캔하면 세션 쿠키를 받고 연결됩니다
직접 사용해 보기
연결한 후 다음 명령을 실행해 보세요:
셸
# See system info
htop
# Check a git repo
cd ~/your-project && git status
# Run any CLI tool
터미널은 전체 색상, TUI, 예상할 수 있는 모든 키를 지원합니다.
계속 실행하기
연결이 작동하려면 Termbridge이 계속 실행 중이어야 합니다. 작업을 마쳤다면:
Ctrl+C를 실행 중인 터미널에서 Termbridge을 누릅니다- 터널이 닫히고 연결이 종료됩니다
--kill-on-exit을 사용하지 않았다면 tmux 세션은 계속 실행됩니다
첫 세션 동작
- Termbridge이 tmux 세션을 만듭니다(기본 이름은 포트에서 가져옵니다)
- 목록의 첫 번째 터미널이 자동으로 로드됩니다
TERMBRIDGE_SESSIONS=2을 설정하면 시작할 때 여러 세션을 만들 수 있습니다
기존 tmux 세션 사용
--session <name>을 전달했을 때 해당 세션이 이미 있으면, Termbridge은 새 세션을 만드는 대신 기존 세션에 연결합니다. 이미 시작한 장시간 실행 프로세스를 모니터링할 때 유용합니다.
다음 단계
모바일 제어
휴대폰과 태블릿에서 Termbridge를 사용하는 팁
여러 터미널
여러 세션을 실행하고 전환하세요
개발 서버 미리보기
터미널과 함께 Vite 앱을 미리 보세요
CLI 참고
사용 가능한 모든 플래그와 옵션 보기