tuanngocptn/nport

어떤 프로젝트인가요?

핵심 기능

• 01Cloudflare를 통해 localhost에서 공개 URL로 연결되는 HTTPS 터널을 만듭니다.
• 02플래그 하나로 사용자 지정 서브도메인을 사용할 수 있습니다.
• 03계정이나 사전 설정이 필요하지 않습니다.
• 04WebSocket 및 Server-Sent Events 트래픽을 지원합니다.
• 05자체 호스팅 백엔드를 사용하도록 설정할 수 있습니다.
• 06Windows, macOS, Linux에서 실행됩니다.

활용 사례

• 로컬 개발 서버를 팀원이나 고객과 공유합니다.
• 로컬 머신에서 GitHub 또는 Stripe의 웹훅을 받습니다.
• 공개 HTTPS URL을 통해 휴대폰에서 웹 앱을 테스트합니다.
• 접근 가능한 콜백 주소가 필요한 API 연동을 디버깅합니다.

빠른 시작

1. 1

   npm으로 NPort를 전역 설치합니다

   npm install -g nport
2. 2

   로컬 서버를 시작합니다(Next.js 예시)

   npm run dev
3. 3

   사용자 지정 서브도메인으로 포트 3000을 공개합니다

   nport 3000 -s myapp

사용 전 알아둘 점

• !공유 기본 백엔드는 현재 Cloudflare API 할당량으로 인해 요청 속도 제한을 받고 있어 터널이 간혹 실패할 수 있습니다.
• !터널은 4시간 후 자동으로 닫힙니다.
• !Node.js 20 이상과 npm 10 이상이 필요합니다.

토픽

자주 묻는 질문

nport은(는) 무엇인가요?

계정 없이 Cloudflare Tunnel로 localhost를 HTTPS에 공개하는 무료 오픈소스 ngrok 대안 NPort는 로컬 머신에서 실행 중인 서비스에 공개 HTTP/HTTPS URL을 만들어 주는 명령줄 도구입니다. nport 3000처럼 로컬 포트를 지정해 명령 하나를 실행하면, Cloudflare 엣지 네트워크를 통해 트래픽을 localhost로 전달하는 nport.link URL을 제공합니다.

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

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

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

6개월 이내 업데이트. nport의 마지막 커밋은 2026년 8월 12일입니다.

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

로컬 개발 서버를 팀원이나 고객과 공유합니다. 로컬 머신에서 GitHub 또는 Stripe의 웹훅을 받습니다. 공개 HTTPS URL을 통해 휴대폰에서 웹 앱을 테스트합니다. 접근 가능한 콜백 주소가 필요한 API 연동을 디버깅합니다.

nport는 어떻게 설치하나요?

npm으로 NPort를 전역 설치합니다: npm install -g nport 로컬 서버를 시작합니다(Next.js 예시): npm run dev 사용자 지정 서브도메인으로 포트 3000을 공개합니다: nport 3000 -s myapp

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

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