yetone/alma-relay

어떤 프로젝트인가요?

핵심 기능

• 01휴대폰에서 데스크톱으로 HTTP, SSE 스트리밍, WebSocket 트래픽을 전달합니다.
• 02데스크톱이 아웃바운드로 연결하므로 포트 포워딩이나 VPN이 필요하지 않습니다.
• 03AES-256-GCM 세션으로 종단 간 암호화를 적용해 릴레이에는 암호문만 노출됩니다.
• 04Cloudflare Workers 무료 플랜, HTTPS 자동 설정 기능이 있는 Docker, 일반 Node 환경에서 실행할 수 있습니다.
• 05공유 등록 키 또는 사용자별 JWT 토큰으로 선택적 접근 제어를 설정할 수 있습니다.

활용 사례

• 외출 중 휴대폰으로 집에 있는 Alma 데스크톱을 제어합니다.
• 자신과 가까운 리전이나 직접 관리하는 인프라에서 릴레이를 운영합니다.
• 팀원들과 릴레이 하나를 공유하면서 개별 구성원의 접근 권한을 회수합니다.
• 호스팅 릴레이에 의존하지 않고 Alma Remote Access를 운영합니다.

빠른 시작

1. 1

   저장소를 클론합니다

   git clone https://github.com/yetone/alma-relay && cd alma-relay
2. 2

   종속 항목을 설치합니다

   npm install
3. 3

   Cloudflare Workers(무료 플랜)에 배포합니다

   npx wrangler deploy
4. 4

   또는 Node 에디션을 로컬에서 포트 8787로 실행합니다

   npm start

사용 전 알아둘 점

• !셀프 호스팅 릴레이는 공식 Alma iOS 앱으로 휴대폰 알림을 보낼 수 없습니다.
• !라이브 브라우저 뷰에 TURN을 설정하려면 추가 구성과 방화벽 포트 개방이 필요합니다.
• !종단 간 보호를 완전히 사용하려면 데스크톱에서 Alma 0.4.329 이상을 실행해야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

alma-relay은(는) 무엇인가요?

포트 포워딩이나 VPN 없이 아웃바운드 연결로 Alma 휴대폰 앱에서 Alma 데스크톱 앱을 제어할 수 있게 해주는 셀프 호스팅 릴레이입니다. Alma Relay는 Alma Remote Access용 셀프 호스팅 릴레이입니다. 데스크톱 앱이 릴레이에 아웃바운드 연결을 시작해 연결을 유지하면, 휴대폰에서 보낸 요청이 릴레이를 거쳐 해당 연결을 통해 데스크톱으로 전달됩니다. HTTP, 스트리밍(SSE), WebSocket 트래픽을 모두 전달하므로 인바운드 포트를 열거나 VPN을 실행하지 않고도 어디서든 데스크톱에 접속할 수 있습니다.

alma-relay은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

alma-relay은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

alma-relay은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. alma-relay의 마지막 커밋은 2026년 11월 2일입니다.

alma-relay은(는) 어디에 사용할 수 있나요?

외출 중 휴대폰으로 집에 있는 Alma 데스크톱을 제어합니다. 자신과 가까운 리전이나 직접 관리하는 인프라에서 릴레이를 운영합니다. 팀원들과 릴레이 하나를 공유하면서 개별 구성원의 접근 권한을 회수합니다. 호스팅 릴레이에 의존하지 않고 Alma Remote Access를 운영합니다.

alma-relay는 어떻게 설치하나요?

저장소를 클론합니다: git clone https://github.com/yetone/alma-relay && cd alma-relay 종속 항목을 설치합니다: npm install Cloudflare Workers(무료 플랜)에 배포합니다: npx wrangler deploy 또는 Node 에디션을 로컬에서 포트 8787로 실행합니다: npm start

alma-relay은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/yetone/alma-relay