로컬 네트워크 설정

가장 간단한 연결 방식입니다. iPhone이 로컬 WiFi를 통해 Mac에 직접 연결됩니다. 지연이 최소화되며 인터넷 연결이 필요 없습니다.

사용 시기

• iPhone과 Mac이 같은 WiFi 네트워크에 있을 때.
• 자택, 사무실 등 신뢰할 수 있는 네트워크에 있을 때.
• 가장 낮은 지연과 가장 간단한 설정을 원할 때.

Step 1: 네트워크 확인

두 기기가 같은 WiFi 네트워크 및 서브넷에 있어야 합니다. 이를 방해할 수 있는 요인:

• 기기를 격리하는 기업/호텔 WiFi (클라이언트 격리).
• 네트워크 경로를 변경하는 VPN.
• 서버 포트에 대한 Mac 방화벽 차단.

Step 2: Mac의 IP 확인

Mac 앱의 메뉴 바 패널에서 IP를 확인할 수 있습니다. 또는:

ipconfig getifaddr en0

192.168.1.42와 같은 형태의 IP가 반환됩니다.

Step 3: 서버 시작

Mac 앱을 사용하는 경우, 메뉴 바에서 Start Server를 클릭합니다. 기본 포트는 8765입니다.

독립 실행 서버를 사용하는 경우:

cd MacServer && npm start

PORT 환경 변수로 포트를 변경할 수 있습니다:

PORT=9000 npm start

Step 4: iPhone에서 연결

Option A: QR 코드 (가장 빠름)

• Mac 앱 메뉴 바에서 QR 아이콘을 클릭합니다. iPhone 앱으로 스캔합니다.

Option B: Bonjour 자동 검색

• 서버가 Bonjour/mDNS를 통해 브로드캐스트합니다. iPhone 앱의 서버 목록에 Mac이 표시됩니다.

Option C: 수동 입력

• iPhone 앱에서 192.168.x.x와 포트 8765 (또는 사용자 지정 포트)를 입력합니다.
• API 키가 설정되어 있으면 입력합니다.
• Connect를 탭합니다.

Step 5: 검증

연결되면 세션을 생성하거나 선택하고 테스트 프롬프트를 보내보세요. 터미널 출력이 1-2초 이내에 나타나야 합니다.

팁

• Mac 절전: Mac 앱이 서버 실행 중 절전을 방지할 수 있습니다. 장시간 작업 중 Mac이 절전에 들어간다면 앱 설정에서 이 옵션을 활성화하세요.
• 고정 IP: Mac의 IP가 자주 변경되면 (DHCP), 시스템 설정 > 네트워크에서 고정 IP를 할당하거나 수동 IP 대신 Bonjour 검색을 사용하세요.
• 방화벽: macOS 방화벽이 활성화되어 있다면, Tactic Remote 앱 (또는 독립 실행 서버를 사용하는 경우 node 프로세스)에 대한 수신 연결을 허용하세요.