MuhammadHananAsghar/wormhole

어떤 프로젝트인가요?

핵심 기능

• 01명령 하나로 로컬 HTTP 서버에 공개 HTTPS URL을 생성합니다.
• 02GitHub 로그인 후 사용자 지정 서브도메인을 사용할 수 있습니다.
• 03실시간 요청 스트림, 요청 재전송, HAR 내보내기를 지원하는 로컬 트래픽 검사기를 제공합니다.
• 04터널을 통해 WebSocket 연결을 전달합니다.
• 05연결이 끊기면 지수 백오프로 재연결합니다.
• 06민감한 점 경로와 `node_modules` 경로를 기본적으로 차단합니다.

활용 사례

• 개발 중인 웹 앱을 고객이나 팀원과 공유합니다.
• 로컬 머신에서 서드파티 서비스의 웹훅을 받습니다.
• HTTPS를 통해 휴대폰이나 다른 기기에서 로컬 앱을 테스트합니다.
• API 디버깅 중 HTTP 트래픽을 검사하고 재전송합니다.

빠른 시작

1. 1

   빠른 설치 스크립트로 설치합니다(macOS / Linux)

   README의 공식 안내에 따라 설치
2. 2

   로컬 HTTP 서버(포트 3000)로 터널을 시작합니다

   wormhole http 3000

사용 전 알아둘 점

• !프로젝트에서 호스팅하는 Cloudflare Workers 릴레이에 의존하며, 자체 호스팅 릴레이는 아직 제공되지 않습니다.
• !사용자 지정 하위 도메인을 사용하려면 GitHub에 로그인해야 합니다.
• !자체 호스팅 릴레이와 P2P 모드 같은 로드맵 기능은 아직 구현되지 않았습니다.

토픽

자주 묻는 질문

wormhole은(는) 무엇인가요?

명령 하나로 로컬 HTTP 서버를 공개 HTTPS URL에 연결하는 오픈소스 ngrok 대안입니다. Wormhole은 로컬 개발 서버를 인터넷을 통해 공유할 수 있는 커맨드라인 터널입니다. `wormhole http 3000`을 실행하면 localhost:3000으로 요청을 전달하는 공개 HTTPS URL이 생성되므로 개발 서버를 공유하거나, 웹훅을 받거나, 다른 기기에서 앱을 열 수 있습니다. 계정 없이도 터널을 시작할 수 있으며, GitHub로 로그인하면 사용자 지정 서브도메인을 사용할 수 있습니다.

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

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

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

활발히 유지보수 중. wormhole의 마지막 커밋은 2026년 9월 27일입니다.

wormhole은(는) 어디에 사용할 수 있나요?

개발 중인 웹 앱을 고객이나 팀원과 공유합니다. 로컬 머신에서 서드파티 서비스의 웹훅을 받습니다. HTTPS를 통해 휴대폰이나 다른 기기에서 로컬 앱을 테스트합니다. API 디버깅 중 HTTP 트래픽을 검사하고 재전송합니다.

wormhole는 어떻게 설치하나요?

빠른 설치 스크립트로 설치합니다(macOS / Linux) 로컬 HTTP 서버(포트 3000)로 터널을 시작합니다: wormhole http 3000

wormhole은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/MuhammadHananAsghar/wormhole