# 시작하기

## 필수 구성 요소 설치

기본 로컬 터널 설정을 사용하려면 컴퓨터에 다음 도구를 설치하세요:

### Node.js 20+

[nodejs.org](https://nodejs.org)에서 다운로드하거나 패키지 관리자를 사용하세요.

```bash
# Check if installed
node --version
```

### tmux

Termbridge 세션을 구동하는 터미널 멀티플렉서입니다.

```bash
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux
```

### cloudflared

터미널에 보안 터널을 생성합니다(샌드박스 직접 모드에서는 필요하지 않음).

```bash
# macOS
brew install cloudflared

# Linux - see cloudflare.com/downloads
```

[다운로드 cloudflared](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/)


## Termbridge 실행

```bash
npx termbridge
```

다음과 같은 출력이 표시됩니다:

```
┌─────────────────────────────────────────┐
│  Termbridge                             │
│                                         │
│  Local:   http://127.0.0.1:51234        │
│  Public:  https://abc123.trycloudflare.com │
│                                         │
│  ██████████████                         │
│  ██          ██  <- Scan this QR code   │
│  ██████████████                         │
│                                         │
└─────────────────────────────────────────┘
```

> **참고**
> `trycloudflare.com` URL은 계정 없이 빠르게 사용할 수 있는 터널입니다. Termbridge를 자주 사용한다면
> 요청 제한을 피할 수 있도록 이름이 지정된 Cloudflare 터널 토큰을 설정하세요.


## 휴대폰으로 연결

1. 휴대폰 카메라를 엽니다
2. QR 코드를 비춥니다
3. 표시된 링크를 누릅니다
4. 브라우저에서 터미널이 열립니다

이제 연결되었습니다!

## 어떤 일이 일어났나요?

1. Termbridge이 사용자 컴퓨터에서 로컬 서버를 시작했습니다
2. 터미널용 tmux 세션을 생성했습니다
3. Cloudflare가 보안 터널(`trycloudflare.com` URL)을 생성했습니다
4. QR 코드에는 보안 접속을 위한 일회용 토큰이 들어 있습니다. 한 번 사용할 수 있고 시작 후 90초가 지나면 만료되므로 바로 스캔하세요. 만료된 경우 새 코드를 받으려면 Termbridge를 다시 시작하세요
5. 코드를 스캔하면 세션 쿠키를 받고 연결됩니다

## 직접 사용해 보기

연결한 후 다음 명령을 실행해 보세요:

```bash
# 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은 새 세션을 만드는 대신 기존 세션에 연결합니다. 이미 시작한 장시간 실행 프로세스를 모니터링할 때 유용합니다.

## 다음 단계

### [모바일 제어](https://termbridge.inline0.dev/ko/docs/usage/mobile-controls)

휴대폰과 태블릿에서 Termbridge를 사용하는 팁

### [여러 터미널](https://termbridge.inline0.dev/ko/docs/usage/multiple-terminals)

여러 세션을 실행하고 전환하세요

### [개발 서버 미리보기](https://termbridge.inline0.dev/ko/docs/usage/dev-server-preview)

터미널과 함께 Vite 앱을 미리 보세요

### [CLI 참고](https://termbridge.inline0.dev/ko/docs/cli)

사용 가능한 모든 플래그와 옵션 보기