시스템 요구사항
릴레이 서버
- Node.js ≥ 22
- macOS 또는 모든 서버 OS (릴레이는 트래픽 라우팅만 담당)
- RAM 512MB, vCPU 1개로 충분
에이전트
에이전트는 macOS에서 실행됩니다. iOS와 Android를 한 Mac에서 함께 실행할 수 있습니다.
- Apple Silicon(M 시리즈) macOS
- Node.js ≥ 22
Intel Mac은 지원하지 않습니다
에이전트가 함께 배포하는 네이티브 헬퍼 바이너리가 arm64 전용이라 Intel(x86_64) Mac에서는 실행되지 않습니다. 빌드를 열면 spawn unknown error라는 모호한 오류가 납니다.
tapflow가 개발과 검증에 사용해온 환경이 Apple Silicon입니다. Intel 지원은 가능하고 #464에서 다루고 있지만 아직 예정에 없습니다. 유니버설 빌드가 필요하고, 메인테이너가 갖고 있지 않은 하드웨어에서 검증해야 합니다.
릴레이에는 이 제약이 없습니다. 에이전트를 실행하는 머신만 Apple Silicon이어야 합니다.
iOS
- macOS 26 (26.x)
- iOS Simulator Runtime이 설치된 Xcode 26 (26.x)
새 버전 지원
새로운 메이저 버전(예: Xcode 27)이 출시되면 버전 지원을 최우선으로 작업합니다. 지원이 추가되기 전까지는 위 검증된 버전을 사용해 주세요.
Android
- Android SDK (
adb가$PATH에 있거나ANDROID_HOME설정) google_apis/arm64-v8a시스템 이미지 (android-34)를 사용하는 에뮬레이터
대시보드
- 최신 브라우저 (Chrome, Firefox, Safari, Edge)
- 별도 확장 프로그램 불필요
Tailscale 터널 사용 시
대시보드에 접근하는 모든 기기에 Tailscale을 설치해야 합니다. → Tailscale 설정