Cloudflare Tunnel 설정

Cloudflare Tunnel을 사용하면 셀룰러 데이터, 다른 WiFi, 또는 해외 등 어떤 네트워크에서든 Mac에 연결할 수 있습니다. 포트 포워딩이나 라우터 설정 변경이 필요 없습니다.

사용 시기

• iPhone이 Mac과 다른 네트워크에 있을 때 (예: 외출 중).
• 네트워크가 기기 간 직접 연결을 차단할 때.
• 기본적으로 HTTPS/WSS 암호화가 필요할 때.

동작 원리

cloudflared가 Mac에서 Cloudflare 에지로의 아웃바운드 전용 터널을 생성합니다. iPhone은 Cloudflare URL에 연결하고, 트래픽이 Mac으로 중계됩니다. 라우터에서 포트를 열 필요가 없습니다.

Option A: Quick Tunnel (임시)

가장 빠른 시작 방법입니다. Cloudflare 계정이 필요 없습니다. URL은 무작위이며 재시작할 때마다 변경됩니다.

Mac 앱 사용

Mac 앱 설정에서 Cloudflare Tunnel을 토글합니다. 앱이 내부적으로 cloudflared를 실행하고 터널 URL을 표시합니다.

커맨드 라인 사용

cloudflared 설치:

brew install cloudflared

Quick Tunnel 시작:

cloudflared tunnel --url http://localhost:8765

cloudflared가 https://random-words.trycloudflare.com 형태의 URL을 출력합니다. 이 URL을 iPhone 앱에서 사용하세요 (연결 모드를 Public / Cloudflare로 설정).

Option B: Named Tunnel (고정 URL)

일상적으로 사용하려면 Named Tunnel이 변하지 않는 안정적인 URL을 제공합니다.

필수 조건:

• 무료 Cloudflare 계정.
• Cloudflare에서 관리하는 도메인 (무료 도메인 가능).

단계:

1. 인증:

   cloudflared tunnel login

2. 터널 생성:

   cloudflared tunnel create claude-remote

3. DNS 설정: 서브도메인을 터널에 연결:

   cloudflared tunnel route dns claude-remote remote.yourdomain.com

4. ~/.cloudflared/config.yml에 설정 파일 생성:

   tunnel: claude-remote
   credentials-file: ~/.cloudflared/<TUNNEL_ID>.json
   ingress:
     - hostname: remote.yourdomain.com
       service: http://localhost:8765
     - service: http_status:404

5. 실행:

   cloudflared tunnel run claude-remote

고정 URL은 wss://remote.yourdomain.com입니다.

iPhone에서 연결

1. iPhone 앱에서 Public (Cloudflare) 연결 모드로 전환합니다.
2. 터널 URL을 입력합니다 (무작위 *.trycloudflare.com 또는 Named 도메인).
3. API 키를 입력합니다 (공개 접근 시 필수).
4. Connect를 탭합니다.

중요: 공개 터널에서는 반드시 API 키 설정

서버가 인터넷에서 접근 가능할 때 API 키는 필수입니다. 서버 시작 전에 환경 변수로 설정하세요:

export CLAUDE_REMOTE_API_KEY="your-secret-key"

또는 Mac 앱에서 자동 생성할 수 있습니다 (메뉴 바 패널에 표시).

문제 해결

• 터널은 연결되지만 iPhone이 접근 불가: 로컬 서버가 터널이 가리키는 포트 (기본: 8765)에서 실행 중인지 확인하세요.
• DNS가 해석되지 않음: Named Tunnel의 경우 Cloudflare 대시보드에서 CNAME 레코드가 있는지 확인하세요.
• 무작위 URL이 변경됨: Quick Tunnel은 재시작할 때마다 새 URL을 생성합니다. 고정 URL이 필요하면 Named Tunnel을 사용하세요.